ec2-backend-deployer

EC2 后端部署器

授权范围

仅在用户请求和现有批准范围内执行操作；加载此技能不会授予任何新权限。仅报告的请求应仅限于报告，遵守调用方指定的目标、主机、提供商和成本限制，扩展范围前先征求同意，并将这些限制传达给委派对象。

合约

输入：

• 目标代码仓库、部署目标，以及已批准的 AWS 账户/环境
• 现有 Docker、注册表、CI 和主机访问配置

输出：

• 范围明确的部署配置或经过审核的部署计划
• 获准部署时提供运行状况检查证据

创建/修改：

• 在请求的设置范围内修改 Docker 和 CI 配置
• 仅当目标和操作获得授权时修改远程部署状态

外部副作用：

• 批准的部署所需的注册表、CI、SSH 和 AWS 调用

需要确认：

• 创建需付费的基础设施、更改密钥，或在明确批准的目标和操作范围之外进行部署之前
• 更改超出所请求范围的现有部署配置之前

委派给：

• deploy-app，用于处理代码仓库的发布和部署关卡

适用场景

适用于：

• 为后端部署到 EC2 设置 CI/CD
• 配置基于 Docker 的部署
• 实现自动化部署流水线
• 部署 NestJS、Next.js 或 Express 后端
• 设置容器注册表和映像管理
• 配置安全的 EC2 访问（Tailscale）

快速工作流

1. Dockerfile：多阶段构建（基础 → 构建器 → 生产）
2. 注册表：推荐使用 GitHub Container Registry（ghcr.io）
3. CI/CD：使用 Tailscale 实现安全 SSH 访问的 GitHub Actions
4. 部署：在 EC2 上使用带有运行状况检查的 Docker Compose
5. 验证：运行状况端点 + 部署验证

关键组件

Docker

• 使用多阶段构建来减小映像体积
• 使用非 root 用户来提升安全性
• 使用 HEALTHCHECK 进行容器编排
• 使用 BuildKit secrets 处理敏感数据

GitHub Actions

• 使用 docker/build-push-action 构建映像
• 使用 tailscale/github-action 安全访问
• 使用 appleboy/ssh-action 进行部署

EC2

• 必须使用 Docker Compose v2
• 验证运行状况检查
• 回滚流程

参考资料

• 完整指南：Dockerfile、CI/CD 工作流、部署、故障排除