技能介绍
先看中文介绍;官方 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
来源与网址
namedocker-swarm
description- Docker Swarm orchestration, cluster management, and production deployments
- 发现技能客户端向 Agent 提供名称与描述目录。
- 匹配与调用用户指定或任务匹配后,载入 SKILL.md 指令。
- 按需加载按步骤读取参考文档、使用脚本与素材。
指令中引用的文件 · 2
assets/swarm-stack.yamlscripts/swarm-init.sh
以下路径提取自原文;文件是否齐全请以来源仓库中的完整目录为准。
具体调用语法与可用工具以目标 Agent 客户端为准。 查看调用机制说明 ↗
先选择目标 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
相关技能
运维与云
用于容器管理,图像操作,调试的基本道克命令和工作流程.
运维与云
从开放的代理技能生态系统中发现并安装技能. 使用时:(1)用户问"我如何做X",X可能拥有现有技能,(2)用户说"为X找到技能"或"是否为X有技能",(3)用户问"你能否做X",X是专门能力,(4)用户想扩展代理能力,(5)用户想搜索工具,模板,或工作流程,(6)用户提到他们希望…
运维与云
构建,部署,评价,优化,微调,管理微软创始代理,模型,资源最终结束. 用法:铸造、azd ai代理、azd 提供/部署、托管代理脚手架/开发/运行/部署/拖放、即时代理创建、创建代理、更新代理、添加代理工具、援引代理、代理.yaml、评估代理、批量活化、连续活化、持续监测、代理C…
运维与云
执行已有.azure/部署计划.md和基础设施文件的ALREADY-PREPARED应用程序的Azure部署。 当用户向 CREATE 请求新应用程序时, 请不要使用此技能 。 这种技能运行了 azd上行, azd 部署, trarraform 应用, 和 az 部署命令带有内置…