Docker Build & Deploy

一键生成 Docker 构建 + 推送到 GHCR + 部署到服务器的 GitHub Actions 工作流。

Overview

自动生成完整的 Docker CI/CD 工作流：构建镜像 → 推送到 GHCR → SSH 部署到服务器。包含优化的 Dockerfile（多阶段构建、非 root、健康检查）和 GitHub Actions 工作流模板。

When to Use

• User wants to containerize a project and deploy it
• User needs GitHub Actions to automatically build Docker images
• User mentions Docker, GHCR, container deployment, or CI/CD
• User inputs /docker-build-deploy
• User wants to set up continuous deployment pipeline
• User wants to push images to a container registry
• User wants to automate deployment to a remote server via SSH
• User wants to optimize existing Dockerfile with multi-stage builds
• User wants to add health checks to container deployment

When NOT to Use:

• User only wants to write a Dockerfile
• User deploys with Kubernetes (different workflow - consider kubectl or Helm)
• User doesn't use GitHub Actions (consider GitLab CI, CircleCI, etc.)
• User wants to deploy to AWS ECS/EKS, Google Cloud Run, or Azure Container Instances (different workflows)

Core Pattern

Step 1: 收集信息

交互式询问：port（容器内端口，默认 3000）、host_port（对外暴露端口，默认同 port）、env_file（服务器 env 路径，可选）。

智能检测：有 package.json → Node.js（当前唯一支持的项目类型）。已有 Dockerfile 则跳过生成。

Step 2: 生成 Dockerfile（如需要）

生成优化的 Node.js Dockerfile：多阶段构建、非 root 用户、健康检查。模板见 templates/Dockerfile.nodejs。

Step 3: 生成 Workflow

从 templates/docker-deploy.yml 生成工作流，替换 {{PORT}}（容器端口）、{{HOST_PORT}}（对外端口）和 {{ENV_FILE}} 变量。

build-and-push job： 登录 GHCR → Buildx 构建 → 推送（tag: latest + sha）→ GHA 缓存

deploy job： SSH 连接 → 拉取镜像 → 停旧容器 → 启新容器（支持 env 文件）→ 清理旧镜像

Step 4: 提示配置 Secrets

告知用户需在 GitHub Settings → Secrets 配置：DEPLOY_HOST、DEPLOY_USER、DEPLOY_SSH_KEY（服务器私钥）。

安全性：使用 SSH key 而非密码（密码登录有爆破风险，且明文存于 CI）。若服务器只支持密码，可改用 password: ${{ secrets.DEPLOY_PASSWORD }}，但不推荐。

Quick Reference

/docker-build-deploy
/docker-build-deploy --port 8080
/docker-build-deploy --port 8080 --env-file /opt/app/.env

Common Mistakes