跳到主内容
智客 ZICQ

技能库 智客分类:运维与云 docker-build-deploy

Docker Build Deploy

当将一个 Node.js app 装入容器并设置 GitHub Actions CI/CD 用于构建,推向GHCR,并通过 SSH 部署时使用. 多相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相.

1112 安装量

官方网址:skills.sh

技能介绍

先看中文介绍;官方 description 原文单独保留,不改写 SKILL.md。

做什么

当将一个 Node.js app 装入容器并设置 GitHub Actions CI/CD 用于构建,推向GHCR,并通过 SSH 部署时使用. 多相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相.

何时用

- 用户希望将一个项目装入容器并加以部署

代理如何加载

按 Agent Skills 渐进披露:启动时只加载 name 与 description(约 100 token);任务匹配后才读入整份 SKILL.md 正文;scripts/、references/、assets/ 仅在需要时再读。 本文件正文结构:Docker Build & Deploy、Overview、When to Use、Core Pattern、Step 1: 收集信息、Step 2: 生成 Dockerfile(如需要)。 其中含规范建议的小节:分步指令。

文件分析

文件分析:这是一份仅含 SKILL.md 的指令型技能,代理激活后整份正文进入上下文。

官方 description(原文)

Use when containerizing a Node.js app and setting up GitHub Actions CI/CD to build, push to GHCR, and deploy via SSH. Multi-stage build, non-root user, caching.

Docker Build & DeployOverviewWhen to UseCore PatternStep 1: 收集信息Step 2: 生成 Dockerfile(如需要)Step 3: 生成 WorkflowStep 4: 提示配置 SecretsQuick ReferenceCommon Mistakes

来源分类:skills.sh agent-skill

SKILL.md 与 Agent 调用

官方规范 ↗
name
docker-build-deploy
description
Use when containerizing a Node.js app and setting up GitHub Actions CI/CD to build, push to GHCR, and deploy via SSH. Multi-stage build, non-root user, caching.
  1. 发现技能客户端向 Agent 提供名称与描述目录。
  2. 匹配与调用用户指定或任务匹配后,载入 SKILL.md 指令。
  3. 按需加载按步骤读取参考文档、使用脚本与素材。

具体调用语法与可用工具以目标 Agent 客户端为准。 查看调用机制说明 ↗

安装这个技能

Skills CLI ↗

先选择目标 Agent 和安装范围,保留技能包的附属文件,安装后检查客户端能否发现该技能。

交给 Agent 安装

复制安装指令给支持 Agent Skills 的代理,确认其中的目标目录与客户端匹配。

把 Agent Skill「docker-build-deploy」安装到我的项目:SKILL.md 原文与官方 description 见 https://zicq.com/zh/skills/skl-c6410df318290e66-Docker-%E6%9E%84%E5%BB%BA%E9%83%A8%E7%BD%B2.html
请存为 .cursor/skills/docker-build-deploy/SKILL.md 或 .claude/skills/docker-build-deploy/SKILL.md,frontmatter 的 name 与 description 保持原样,不要改写。

GitHub 完整包 ↗

终端安装 · Skills CLI

需要 Node.js 与 npx。先查看仓库技能列表,确认实际名称。

npx skills add 'https://github.com/wu529778790/shenzjd-skills' --list

npx skills add 'https://github.com/wu529778790/shenzjd-skills' --skill 'docker-build-deploy'

CLI 会交互选择目标 Agent,默认安装到项目;用户级安装使用 -g。先通过查看命令核对仓库内容,再用 npx skills list 检查已安装技能。

阅读排版

name: docker-build-deploy description: Use when containerizing a Node.js app and setting up GitHub Actions CI/CD to build, push to GHCR, and deploy via SSH. Multi-stage build, non-root user, caching.

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

| 参数 | 说明 | 默认值 | |------|------|--------| | --port | 容器内应用端口 | 3000 | | --host-port | 服务器对外暴露端口 | 同 --port | | --env-file | 服务器 env 文件路径 | 空 |

Common Mistakes

| 错误 | 正确做法 | 原因 | |------|----------|------| | 用 latest 单 tag | 同时打 latest + ${{ github.sha }} | 方便回滚 | | 不设置 packages: write 权限 | 声明 permissions: packages: write | GHCR 推送需要 | | deploy 不检查容器是否存在 | 先 docker stop + docker rm | 避免端口冲突 | | 不清理旧镜像 | 部署后 docker image prune -f | 磁盘空间 | | Dockerfile 用 root 运行 | 添加 USER node 或非 root 用户 | 容器安全最佳实践 | | Secrets 硬编码在 workflow 中 | 使用 ${{ secrets.XXX }} 引用 | 密钥泄露风险 | | 不设置 Docker BuildKit 缓存 | 配置 cache-from / cache-to using GitHub Actions cache | 每次全量构建太慢 | | 不处理构建失败的回滚 | 部署后验证健康检查 | 失败部署可能上线错误版本 | | 用密码 SSH 部署 | 使用 SSH key(DEPLOY_SSH_KEY) | 密码爆破风险高 | | 平台声明与服务器架构不符 | 按服务器架构声明 linux/amd64 或 linux/arm64;多平台构建时写 linux/amd64,linux/arm64 | 目标架构不匹配导致运行失败 |

相关技能

运维与云

Docker Essentials

用于容器管理,图像操作,调试的基本道克命令和工作流程.

运维与云

Find Skills

从开放的代理技能生态系统中发现并安装技能. 使用时:(1)用户问"我如何做X",X可能拥有现有技能,(2)用户说"为X找到技能"或"是否为X有技能",(3)用户问"你能否做X",X是专门能力,(4)用户想扩展代理能力,(5)用户想搜索工具,模板,或工作流程,(6)用户提到他们希望…

运维与云

Microsoft Foundry

构建,部署,评价,优化,微调,管理微软创始代理,模型,资源最终结束. 用法:铸造、azd ai代理、azd 提供/部署、托管代理脚手架/开发/运行/部署/拖放、即时代理创建、创建代理、更新代理、添加代理工具、援引代理、代理.yaml、评估代理、批量活化、连续活化、持续监测、代理C…

运维与云

Azure Deploy

执行已有.azure/部署计划.md和基础设施文件的ALREADY-PREPARED应用程序的Azure部署。 当用户向 CREATE 请求新应用程序时, 请不要使用此技能 。 这种技能运行了 azd上行, azd 部署, trarraform 应用, 和 az 部署命令带有内置…