Terraform 交互式教程

基于 VitePress + Killercoda 的零成本交互式 Terraform 教程（中文）。

• 前端：VitePress 静态站点，部署到 GitHub Pages
• 实验环境：Killercoda 沙盒（Ubuntu + Docker + LocalStack），提供真实终端和 Terraform CLI
• CI/CD：推送 main 分支自动构建部署

本地开发

npm install
npm run dev          # 启动 VitePress 开发服务器
npm run sync-sidebar # 添加/删除 docs/*.md 后手动同步侧边栏

构建与预览

npm run build    # 产物输出到 docs/.vitepress/dist/（自动运行 sidebar + setup 同步）
npm run preview  # 本地预览构建产物

推送到 main 分支会触发 GitHub Actions 自动部署到 GitHub Pages。

项目结构

docs/                          # VitePress 内容（Markdown 教程章节）
  .vitepress/
    config.mjs                 # VitePress 配置（侧边栏自动管理）
    components/
      KillercodaEmbed.vue      # Killercoda 实验链接按钮组件
terraform-tutorial/            # Killercoda 场景定义
  structure.json               # 场景列表
  terraform-basics/            # 每个场景一个目录
  terraform-state/
  terraform-syntax-*/          # 语法系列场景
scripts/
  setup-common.sh              # 共享环境初始化脚本（唯一编辑源）
  sync-setup-common.mjs        # 将 setup-common.sh 复制到各场景 assets/
  sync-sidebar.mjs             # 从 docs/*.md frontmatter 自动生成侧边栏

Killercoda 场景

场景定义位于 terraform-tutorial/ 目录。将此仓库关联到 Killercoda Creator 账号后，需要手动在 killercoda 上同步一次内容。

详细的场景结构规范和开发指南见 .github/copilot-instructions.md。