---
name: docker-management
description: Docker container and image management including logs, stats, and compose operations. Use when managing Docker containers, debugging container issues, or working with Docker Compose.
allowed-tools: Bash, Read, Write
mcp_tools:
  - "docker_ps"
  - "docker_images"
  - "docker_logs"
  - "docker_inspect"
  - "docker_stats"
  - "docker_exec"
  - "docker_start"
  - "docker_stop"
  - "docker_restart"
  - "docker_rm"
  - "compose_ps"
  - "compose_logs"
  - "compose_up"
  - "compose_down"
---

# Docker Management Skill

**Version**: 1.0.0
**Purpose**: Docker container and compose management

---

## Triggers

| Trigger | Examples |
|---------|----------|
| Containers | "list containers", "docker ps", "コンテナ一覧" |
| Logs | "container logs", "docker logs", "ログ確認" |
| Debug | "debug container", "container issue", "デバッグ" |
| Compose | "compose up", "compose status", "Compose起動" |

---

## Integrated MCP Tools

### Container Operations

| Tool | Purpose |
|------|---------|
| `docker_ps` | List containers (running/all) |
| `docker_images` | List local images |
| `docker_logs` | Container logs (tail, follow) |
| `docker_inspect` | Container details (JSON) |
| `docker_stats` | Resource usage (CPU, memory) |
| `docker_exec` | Execute command in container |
| `docker_start` | Start stopped container |
| `docker_stop` | Stop running container |
| `docker_restart` | Restart container |
| `docker_rm` | Remove container |

### Compose Operations

| Tool | Purpose |
|------|---------|
| `compose_ps` | Compose project status |
| `compose_logs` | Service logs |
| `compose_up` | Start services |
| `compose_down` | Stop and remove services |

---

## Workflow: Container Debugging

### Phase 1: Assessment

#### Step 1.1: List Containers
```
Use docker_ps with:
- all: true (include stopped)
```

#### Step 1.2: Check Status
Look for:
- Exit codes
- Restart counts
- Health status

### Phase 2: Investigation

#### Step 2.1: View Logs
```
Use docker_logs with:
- container: Container name/ID
- tail: 100 (last N lines)
- timestamps: true
```

#### Step 2.2: Inspect Configuration
```
Use docker_inspect to check:
- Environment variables
- Mount points
- Network settings
- Health check config
```

#### Step 2.3: Resource Usage
```
Use docker_stats to monitor:
- CPU percentage
- Memory usage
- Network I/O
- Block I/O
```

### Phase 3: Resolution

#### Step 3.1: Restart Container
```
Use docker_restart for temporary fix
```

#### Step 3.2: Execute Commands
```
Use docker_exec to run diagnostics inside container:
- command: "sh -c 'ps aux'"
- command: "cat /var/log/app.log"
```

---

## Workflow: Docker Compose

### Step 1: Check Status
```
Use compose_ps to see all services
```

### Step 2: View Logs
```
Use compose_logs with:
- service: Specific service name
- tail: 50
```

### Step 3: Service Management
```
Use compose_up to start services
Use compose_down to stop and clean up
```

---

## Common Issues

| Symptom | Tool | Action |
|---------|------|--------|
| Container exits | docker_logs | Check error messages |
| High memory | docker_stats | Identify memory leak |
| Network issues | docker_inspect | Verify network config |
| Mount failures | docker_inspect | Check volume mounts |

---

## Best Practices

✅ GOOD:
- Check logs before restarting
- Use health checks
- Set resource limits
- Use named volumes

❌ BAD:
- Restart without investigation
- Run as root unnecessarily
- Store secrets in images
- Use latest tag in production

---

## Checklist

- [ ] Docker daemon running
- [ ] Container status checked
- [ ] Logs reviewed
- [ ] Resource usage normal
- [ ] Network connectivity OK