跳到主内容
智客 ZICQ

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

Docker Compose Setup

用 Docker 编译器设置多容器应用程序, 包括服务、 网络和卷

209 安装量

官方网址:skills.sh

技能介绍

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

做什么

用 Docker 编译器设置多容器应用程序, 包括服务、 网络和卷

何时用

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

代理如何加载

按 Agent Skills 渐进披露:启动时只加载 name 与 description(约 100 token);任务匹配后才读入整份 SKILL.md 正文;scripts/、references/、assets/ 仅在需要时再读。 本文件正文结构:Docker Compose Setup Skill、Purpose、Parameters、Modern Compose File (2024-2025)、Environment Management、Base + Override Pattern。

文件分析

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

官方 description(原文)

Set up multi-container applications with Docker Compose including services, networks, and volumes

Docker Compose Setup SkillPurposeParametersModern Compose File (2024-2025)Environment ManagementBase + Override Patterndocker-compose.yaml (base)docker-compose.override.yaml (dev - auto-loaded)docker-compose.prod.yaml (production)Development (loads override automatically)ProductionEnvironment Variables

来源分类:skills.sh agent-skill

SKILL.md 与 Agent 调用

官方规范 ↗
name
docker-compose-setup
description
Set up multi-container applications with Docker Compose including services, networks, and volumes
  1. 发现技能客户端向 Agent 提供名称与描述目录。
  2. 匹配与调用用户指定或任务匹配后,载入 SKILL.md 指令。
  3. 按需加载按步骤读取参考文档、使用脚本与素材。

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

安装这个技能

Skills CLI ↗

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

交给 Agent 安装

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

把 Agent Skill「docker-compose-setup」安装到我的项目:SKILL.md 原文与官方 description 见 https://zicq.com/zh/skills/skl-ea0a2c83ea86c447-Docker-%E7%BC%96%E8%AF%91%E8%AE%BE%E7%BD%AE.html
请存为 .cursor/skills/docker-compose-setup/SKILL.md 或 .claude/skills/docker-compose-setup/SKILL.md,frontmatter 的 name 与 description 保持原样,不要改写。

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-compose-setup'

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

阅读排版
--- name: docker-compose-setup description: Set up multi-container applications with Docker Compose including services, networks, and volumes sasmp_version: "1.3.0" bonded_agent: 05-docker-compose bond_type: PRIMARY_BOND --- # Docker Compose Setup Skill Master Docker Compose for multi-container application orchestration with service dependencies, health checks, and environment management. ## Purpose Design and configure Docker Compose files for development and production environments with proper service orchestration. ## Parameters | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | services | array | No | - | List of services to configure | | environment | enum | No | dev | dev/staging/prod | | include_monitoring | boolean | No | false | Add monitoring services | ## Modern Compose File (2024-2025) **Note**: The `version` field is deprecated. Start directly with `services:`. ```yaml services: frontend: build: context: ./frontend target: production ports: - "80:80" depends_on: backend: condition: service_healthy healthcheck: test: ["CMD", "curl", "-f", "http://localhost/health"] interval: 30s timeout: 10s retries: 3 restart: unless-stopped backend: build: ./backend expose: - "3000" environment: DATABASE_URL: postgres://user:${DB_PASSWORD}@database:5432/app depends_on: database: condition: service_healthy healthcheck: test: ["CMD", "curl", "-f", "http://localhost:3000/health"] interval: 10s timeout: 5s retries: 5 database: image: postgres:16-alpine volumes: - db_data:/var/lib/postgresql/data environment: POSTGRES_PASSWORD: ${DB_PASSWORD} healthcheck: test: ["CMD-SHELL", "pg_isready -U postgres"] interval: 5s timeout: 5s retries: 5 volumes: db_data: ``` ## Environment Management ### Base + Override Pattern ```yaml # docker-compose.yaml (base) services: app: image: myapp:latest # docker-compose.override.yaml (dev - auto-loaded) services: app: build: . volumes: - ./src:/app/src environment: - DEBUG=true # docker-compose.prod.yaml (production) services: app: deploy: replicas: 3 restart: always ``` ```bash # Development (loads override automatically) docker compose up # Production docker compose -f docker-compose.yaml -f docker-compose.prod.yaml up -d ``` ### Environment Variables ```bash # .env file (auto-loaded) DB_PASSWORD=secret123 APP_VERSION=1.2.3 ``` ```yaml # Using in compose environment: - DB_PASSWORD=${DB_PASSWORD} - VERSION=${APP_VERSION:-latest} # Default value ``` ## Service Profiles ```yaml services: app: image: myapp # Only with --profile debug debugger: image: debug-tools profiles: - debug # Only with --profile testing test-db: image: postgres:alpine profiles: - testing ``` ```bash docker compose up # app only docker compose --profile debug up # app + debugger ``` ## Common Commands ```bash # Start services docker compose up -d # Rebuild and start docker compose up -d --build # View logs docker compose logs -f backend # Scale service docker compose up -d --scale backend=3 # Stop and clean docker compose down -v # Validate config docker compose config ``` ## Error Handling ### Common Errors | Error | Cause | Solution | |-------|-------|----------| | `undefined service` | Dependency missing | Define service | | `yaml syntax error` | Indentation | Fix YAML | | `port already in use` | Port conflict | Change port | | `healthcheck failing` | Service not ready | Increase start_period | ### Fallback Strategy 1. Validate with `docker compose config` 2. Start services individually 3. Use `--no-deps` to skip dependencies ## Troubleshooting ### Debug Checklist - [ ] Valid YAML? `docker compose config` - [ ] Images available? `docker compose pull` - [ ] Dependencies healthy? Check healthchecks - [ ] Environment set? Check .env file ### Health Check Debugging ```bash # Check health status docker inspect --format='{{json .State.Health}}' # View health logs docker inspect --format='{{range .State.Health.Log}}{{.Output}}{{end}}' ``` ## Usage ``` Skill("docker-compose-setup") ``` ## Related Skills - docker-networking - docker-volumes - 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 部署命令带有内置…