AgentSkillsCN

docker-compose-operations

针对 docker-compose.yaml 或 docker-compose/ 目录中定义的本地容器堆栈的操作。处理 AI/ML 服务(Ollama、ComfyUI)、独立数据库及本地可观测性堆栈。适用于 ‘docker compose’ 命令、检查容器日志或重启特定本地服务。对于集群 Grafana/Prometheus(通过 kubectl 或集群/manifests/),则使用 kubernetes-operations。

SKILL.md
--- frontmatter
name: docker-compose-operations
description: Operations for local container stacks defined in docker-compose.yaml or docker-compose/ directory. Handles AI/ML services (Ollama, ComfyUI), standalone databases, and local observability stacks. Use for 'docker compose' commands, checking container logs, or restarting specific local services. For cluster Grafana/Prometheus (via kubectl or cluster/manifests/), use kubernetes-operations instead.
context: fork
keywords: docker-compose, compose, container, local-dev, ollama, comfyui, stable-diffusion, mcp-server, container-logs, envoy-local, コンテナ, ローカル環境
  • Access services via *.127.0.0.1.nip.io domains through Envoy gateway
  • GPU services require runtime: nvidia (NVIDIA Docker runtime)
  • Use docker compose logs -f <service> for real-time log monitoring

Service Categories

CategoryServicesAccess
AI/ML (profile)comfyui, stable-diffusion-*, llama.cpp, yueProfile-based
AI/ML (always-on)ollama, open-webuiAlways-on
Observabilitygrafana, prometheus, jaeger, pyroscopeAlways-on
Datastoresmysql, redis, minio, qdrant, cassandra, influxdbAlways-on
Gatewayenvoy, mitmproxyAlways-on
MCP Serversgithub-mcp-server, playwright-mcp, chrome-devtools-mcp, mcp-filesystemAlways-on

Available Profiles

ProfileDescriptionGPU
stable-diffusion-webuiOriginal Stable Diffusion WebUIYes
stable-diffusion-webui-forgeImproved Stable Diffusion WebUIYes
comfyuiNode-based AI image generationYes
llama.cppLLaMA.cpp for LLM inferenceYes
yueYue serverYes

Common Commands

bash
# Start profile-based services
docker compose --profile=comfyui up -d

# View logs
docker compose logs -f grafana

# Execute commands in container
docker compose exec redis redis-cli
docker compose exec mysql mysql -u hippocampus -p

# Check GPU status
docker compose exec dcgm-exporter nvidia-smi

# Restart service
docker compose restart prometheus

Web Interfaces

Services are accessible via http://{service}.127.0.0.1.nip.io. See docker-compose/envoy/envoy.yaml for available domains.

ServiceURLNote
Envoy Adminhttp://localhost:9901Direct access
mitmproxy Webhttp://localhost:18081Direct access

Debugging Workflow

  1. Check service status: docker compose ps
  2. View logs: docker compose logs -f <service>
  3. Check health: docker compose exec <service> healthcheck-command
  4. Inspect network: docker compose exec envoy curl -s http://<service>:<port>/health
SymptomAction
Service not startingCheck logs, verify dependencies, check volumes
Connection refusedVerify network, check service health
GPU not availableCheck nvidia-smi, verify runtime configuration
Model download failedCheck HF_HUB_TOKEN, verify network access

Volume Management

bash
# List volumes
docker volume ls | grep hippocampus

# Inspect volume
docker volume inspect hippocampus_comfyui-models

# Access volume data via ephemeral-container
docker compose exec ephemeral-container ls /home/nonroot/ComfyUI/models

Reference

If managing AI/ML services: See AI/ML Services