# .github/workflows/ci.yml —— 放在仓库这个固定路径，GitHub 自动识别
name: CI                       # 这条流水线的名字
on:                            # ★ 触发条件：什么时候启动
  push:
    branches: [ main ]         # 有人 push 到 main 分支时自动跑
jobs:
  test:                        # 一个 job（阶段），名叫 test
    runs-on: ubuntu-latest     # 在一台临时的 Ubuntu 机器上跑（GitHub 免费提供）
    steps:                     # 这个阶段的一步步动作
      - uses: actions/checkout@v4        # step1：把代码拉下来
      - uses: actions/setup-python@v5    # step2：装好 Python 环境
        with: { python-version: "3.11" }
      - run: pip install -r requirements.txt   # step3：装依赖（Day05 的老朋友）
      - run: pytest                            # step4：跑测试

  build-deploy:
    needs: test              # ★ 必须等 test 这个 job 成功，才轮到我
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: 登录镜像仓库
        run: echo "${{ secrets.REGISTRY_TOKEN }}" | docker login -u me --password-stdin
        #                └ 从保险柜(Secrets)取钥匙，不写明文
      - name: 构建并推送镜像
        run: |
          docker build -t my-agent:${{ github.sha }} .   # 用提交号当版本号，唯一可追溯
          docker push my-agent:${{ github.sha }}
      - name: 部署到 K8s
        run: kubectl set image deploy/my-agent agent=my-agent:${{ github.sha }}
        #      └ 让 K8s 把 Deployment 换成新镜像 → 触发昨天学的滚动升级

# main.tf（Terraform 用的是 HCL 语言，长得像配置，读起来很直白）
# 声明：我要在云上建一台虚拟服务器
resource "server" "agent_host" {   # resource=一个资源, 类型=server, 起名 agent_host
  size   = "2core-4gb"             # 规格：2 核 4G
  image  = "ubuntu-22.04"          # 系统镜像
  region = "singapore"             # 部署region（示意）
}
# 声明：给它配一个数据库
resource "database" "agent_db" {
  engine = "postgres"
  size   = "small"
}
# 上面只是「想要的状态」。跑 terraform apply，它就去云上真建出来。

✋ 动手 10 分钟：给一个仓库加一条最小 CI

找一个你自己的 Python 项目(哪怕只有一个函数 + 一个测试),加 CI 体验「push 后机器自动跑测试」:

# 1) 在项目里建目录和文件：.github/workflows/ci.yml
#    内容直接用本页 L02 的那段 YAML（改成你的项目即可）

# 2) 提交并推上去
git add .github/workflows/ci.yml
git commit -m "add CI pipeline"
git push

# 3) 打开 GitHub 仓库 → 点顶部「Actions」标签
#    你会看到这条流水线正在自动跑，每个 step 有 ✅ / ❌
#    故意写个失败的测试再 push 一次，看它变红并通知你——体会「自动质检拦截」

没有现成项目?用 Day05 建的小类项目,配一个 test_demo.py(里面写一句 assert 1+1==2),照上面走一遍即可。亲手让绿勾亮起来的那一刻,你就真正理解 CI 了。