borghei/Claude-Skills / engineering/docker-development
docker-development
FlaggedAnalyse Dockerfiles and Compose files for security, image size, cache and config problems, with CI-ready exit codes. Use when reviewing or optimising a Dockerfile, validating docker-compose, or adding a container lint step.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 7.1 KB |
| examples/Dockerfile.sample | other | 1.9 KB |
| examples/docker-compose.sample.yml | config | 3.0 KB |
| examples/docker-compose.sound.yml | config | 787 B |
| references/docker-best-practices.md | markdown | 2.8 KB |
| scripts/compose_validator.py | script | 17.1 KB |
| scripts/dockerfile_analyzer.py | script | 15.2 KB |
references/docker-best-practices.md
View on GitHub# Docker Best Practices Reference
## Base Image Selection
### Image Size Hierarchy (smallest to largest)
1. **scratch** - Empty image, for statically compiled binaries
2. **distroless** - Google's minimal images, no shell
3. **alpine** - ~5MB, musl libc, good for most use cases
4. **slim** - Debian-based, ~80MB, glibc compatible
5. **full** - Complete OS, 200MB+, use only when necessary
### Version Pinning
- Always pin major.minor: `python:3.12-slim`
- For reproducibility, pin digest: `python:3.12-slim@sha256:abc...`
- Never use `latest` in production Dockerfiles
## Multi-Stage Build Patterns
### Builder Pattern
```dockerfile
# Pin to the Go release you build with
FROM golang:1.25 AS builder
WORKDIR /app
COPY go.mod go.sum ./
RUN go mod download
COPY . .
RUN CGO_ENABLED=0 go build -o /app/server
FROM gcr.io/distroless/static
COPY --from=builder /app/server /server
CMD ["/server"]
```
### Testing Pattern
```dockerfile
FROM node:24-slim AS base
WORKDIR /app
COPY package*.json ./
RUN npm ci
FROM base AS test
COPY . .
RUN npm test
FROM base AS production
COPY . .
RUN npm prune --production
USER node
CMD ["node", "server.js"]
```
## Layer Optimization
### Combine RUN Instructions
```dockerfile
# Good: single layer
RUN apt-get update \
&& apt-get install -y --no-install-recommends curl ca-certificates \
&& rm -rf /var/lib/apt/lists/*
# Bad: multiple layers
RUN apt-get update
RUN apt-get install -y curl
RUN apt-get install -y ca-certificates
```
### Order for Cache Efficiency
1. System dependencies (rarely change)
2. Language runtime setup
3. Dependency files (package.json, requirements.txt)
4. Dependency install
5. Application code (changes most often)
6. Build step
## Security Hardening
### Non-Root User
```dockerfile
RUN addgroup --system app && adduser --system --ingroup app app
USER app
```
### Read-Only Filesystem
```yaml
# docker-compose.yml
services:
app:
read_only: true
tmpfs:
- /tmp
- /var/run
```
### Secrets Management
- Use Docker BuildKit secrets: `RUN --mount=type=secret,id=key`
- Use runtime environment variables for application secrets
- Never COPY .env files or embed secrets in images
## Compose Best Practices
### Health Checks
```yaml
healthcheck:
test: ["CMD", "curl", "-f", "http://localhost:8080/health"]
interval: 30s
timeout: 10s
retries: 3
start_period: 40s
```
### Resource Limits
```yaml
deploy:
resources:
limits:
cpus: '0.5'
memory: 512M
reservations:
cpus: '0.25'
memory: 256M
```
### Networking
- Use custom networks for service isolation
- Avoid `network_mode: host` in production
- Use internal networks for backend services
## .dockerignore Essentials
```
.git
.gitignore
node_modules
__pycache__
*.pyc
.env*
.vscode
.idea
*.md
Dockerfile*
docker-compose*
.dockerignore
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |