7.3 使用 Claude 生成样板代码与业务逻辑

7.5 使用 Claude 引导的 CI/CD 进行部署

部署是让你的 API 从代码转变为服务的环节。一个良好的 CI/CD 流水线可以自动化测试、打包和发布，让你能够快速且安全地交付。Claude Code 能够自然地融入这个循环：它可以起草流水线、推理环境变量和密钥、提出安全的发布步骤，并从代码差异中生成发布说明或回滚计划。在本节中，你将为 TaskFlow API 搭建一条干净、可复现的 CI/CD 路径，可以在本地运行，也可以接入到任何支持 Git 托管服务的平台。该流水线精简、可读，并具备生产级形态：先运行测试，再构建容器，然后推送镜像，最后通过远程主机上的一个小脚本完成部署。

概念拓展

一条可靠的流水线遵循可预测的顺序。首先，通过单元测试进行验证，防止有缺陷的代码被发布出去。接下来，将服务打包进容器，以保证运行时环境的一致性。然后，使用唯一的标签将制品发布到镜像仓库，使部署具备确定性。最后，通过拉取该确切镜像到目标主机并重启服务来完成部署，全程无需人工干预。Claude 的价值在于保持这些环节的协调一致：它可以将代码差异汇总为发布说明、执行版本标签的强制约束，并在你的部署脚本中生成安全的退避/回滚逻辑。请将流水线视为代码——保持小而明确的步骤，让 Claude 能够阅读、解释和改进它。

实操示例：Docker 化的 FastAPI + GitHub Actions + SSH 部署

本示例假定你已经拥有前几章中的 app.py。你将新增四个文件：

1. requirements.txt – 运行时依赖
2. Dockerfile – 容器镜像
3. deploy.sh – 幂等的远程部署脚本
4. .github/workflows/ci.yml – CI/CD 工作流

你可以使用 Docker Compose 在本地运行所有内容，也可以将该工作流接入到任何支持 Actions 风格运行器的 Git 托管平台。部署步骤通过 SSH 连接到一台小型 Linux 虚拟机；请替换为你自己的主机、用户和密钥。

requirements.txt

fastapi==0.114.0

uvicorn==0.30.5

Dockerfile