跳到主内容
智客 ZICQ

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

Docker Swarm

Docker Swarm 组织、集群管理和生产部署

65 安装量

官方网址:skills.sh

技能介绍

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

做什么

Docker Swarm 组织、集群管理和生产部署

何时用

官方 description 未单独写出 Use when。按规范,代理会在用户任务与这段 description 的关键词匹配时激活本技能。

代理如何加载

按 Agent Skills 渐进披露:启动时只加载 name 与 description(约 100 token);任务匹配后才读入整份 SKILL.md 正文;scripts/、references/、assets/ 仅在需要时再读。 本文件正文结构:Docker Swarm Skill、Purpose、Parameters、Cluster Setup、Initialize Swarm、Initialize on first manager。

文件分析

文件分析:除 SKILL.md 外,正文引用了 assets/swarm-stack.yaml、scripts/swarm-init.sh,属于带资源的技能包,这些文件按需再读。

官方 description(原文)

Docker Swarm orchestration, cluster management, and production deployments

Docker Swarm SkillPurposeParametersCluster SetupInitialize SwarmInitialize on first managerGet join tokensJoin as workerJoin as managerHigh Availability (3 or 5 managers)Manager quorum: N/2 + 13 managers = tolerates 1 failure

来源分类:skills.sh agent-skill

SKILL.md 与 Agent 调用

官方规范 ↗
name
docker-swarm
description
Docker Swarm orchestration, cluster management, and production deployments
  1. 发现技能客户端向 Agent 提供名称与描述目录。
  2. 匹配与调用用户指定或任务匹配后,载入 SKILL.md 指令。
  3. 按需加载按步骤读取参考文档、使用脚本与素材。
指令中引用的文件 · 2
  • assets/swarm-stack.yaml
  • scripts/swarm-init.sh

以下路径提取自原文;文件是否齐全请以来源仓库中的完整目录为准。

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

安装这个技能

Skills CLI ↗

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

该技能引用了附属文件,请从来源获取完整目录;仅复制 SKILL.md 可能缺少依赖。

交给 Agent 安装

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

把 Agent Skill「docker-swarm」安装到我的项目:SKILL.md 原文与官方 description 见 https://zicq.com/zh/skills/skl-f952ded1584dee67-Docker-Swarm-%E9%BC%A0%E6%A0%87.html
请存为 .cursor/skills/docker-swarm/SKILL.md 或 .claude/skills/docker-swarm/SKILL.md,frontmatter 的 name 与 description 保持原样,不要改写。
该技能还带 scripts/、references/、assets/ 等文件,请从 https://github.com/pluginagentmarketplace/custom-plugin-docker 取完整目录,不要只建一个 SKILL.md。

GitHub 完整包 ↗

终端安装 · Skills CLI

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

npx skills add 'https://github.com/pluginagentmarketplace/custom-plugin-docker' --list

npx skills add 'https://github.com/pluginagentmarketplace/custom-plugin-docker' --skill 'docker-swarm'

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

阅读排版
--- name: docker-swarm description: Docker Swarm orchestration, cluster management, and production deployments sasmp_version: "1.3.0" bonded_agent: 08-docker-orchestration bond_type: PRIMARY_BOND --- # Docker Swarm Skill Master Docker Swarm for container orchestration, cluster management, and production deployments. ## Purpose Set up and manage Docker Swarm clusters for high availability, service scaling, and production orchestration. ## Parameters | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | managers | number | No | 3 | Number of manager nodes | | workers | number | No | - | Number of worker nodes | | encrypted | boolean | No | true | Encrypt overlay networks | ## Cluster Setup ### Initialize Swarm ```bash # Initialize on first manager docker swarm init --advertise-addr # Get join tokens docker swarm join-token worker docker swarm join-token manager # Join as worker docker swarm join --token :2377 # Join as manager docker swarm join --token :2377 ``` ### High Availability (3 or 5 managers) ```bash # Manager quorum: N/2 + 1 # 3 managers = tolerates 1 failure # 5 managers = tolerates 2 failures ``` ## Service Deployment ### Basic Service ```bash # Create service docker service create \ --name webapp \ --replicas 3 \ --publish 80:80 \ nginx:alpine # Scale docker service scale webapp=5 # Update image docker service update --image nginx:1.25-alpine webapp # Rollback docker service rollback webapp ``` ### Full Service Configuration ```bash docker service create \ --name api \ --replicas 3 \ --network backend \ --publish 8080:3000 \ --mount type=volume,source=data,target=/data \ --secret db_password \ --env NODE_ENV=production \ --limit-cpu 0.5 \ --limit-memory 512M \ --update-delay 10s \ --update-parallelism 1 \ --update-failure-action rollback \ --health-cmd "curl -f http://localhost:3000/health" \ --health-interval 30s \ myapp:latest ``` ## Stack Deployment ### Production Stack ```yaml # stack.yaml services: frontend: image: frontend:${VERSION:-latest} deploy: replicas: 3 placement: constraints: - node.role == worker update_config: parallelism: 1 delay: 10s failure_action: rollback resources: limits: cpus: '0.5' memory: 256M ports: - "80:80" networks: - frontend healthcheck: test: ["CMD", "curl", "-f", "http://localhost/health"] interval: 30s backend: image: backend:${VERSION:-latest} deploy: replicas: 3 secrets: - db_password networks: - frontend - backend networks: frontend: driver: overlay backend: driver: overlay internal: true secrets: db_password: external: true ``` ```bash # Deploy stack docker stack deploy -c stack.yaml myapp # List services docker stack services myapp # Remove stack docker stack rm myapp ``` ## Secrets & Configs ### Secrets ```bash # Create secret echo "password" | docker secret create db_password - # Use in service docker service update --secret-add db_password myservice # Rotate secret echo "newpassword" | docker secret create db_password_v2 - docker service update \ --secret-rm db_password \ --secret-add source=db_password_v2,target=db_password \ myservice ``` ### Configs ```bash # Create config docker config create nginx_config ./nginx.conf # Use in service docker service create \ --config source=nginx_config,target=/etc/nginx/nginx.conf \ nginx ``` ## Node Management ```bash # List nodes docker node ls # Drain node (maintenance) docker node update --availability drain # Activate node docker node update --availability active # Add label docker node update --label-add role=database # Promote to manager docker node promote # Demote from manager docker node demote ``` ## Error Handling ### Common Errors | Error | Cause | Solution | |-------|-------|----------| | `no suitable node` | Constraints not met | Relax or add nodes | | `not converging` | Health check failing | Check service logs | | `Raft: no leader` | Quorum lost | Restore managers | ### Manager Recovery ```bash # If quorum lost, force new cluster docker swarm init --force-new-cluster --advertise-addr ``` ## Troubleshooting ### Debug Checklist - [ ] Swarm active? `docker info | grep Swarm` - [ ] Nodes healthy? `docker node ls` - [ ] Service running? `docker service ls` - [ ] Tasks placed? `docker service ps ` ### Diagnostics ```bash # Service status docker service ls # Task status docker service ps --no-trunc # Service logs docker service logs -f # Node issues docker node inspect --pretty ``` ## Usage ``` Skill("docker-swarm") ``` ## Assets - `assets/swarm-stack.yaml` - Stack template - `scripts/swarm-init.sh` - Init script ## Related Skills - docker-networking - docker-security - docker-production

相关技能

运维与云

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 部署命令带有内置…