docker
Docker container platform for building, running, securing, and deploying containers. Use when creating Dockerfiles, building images, orchestrating services with Compose, optimizing performance, securi
SKILL.mdskills/docker/SKILL.md
GitHubDocker
Docker is a containerization platform that packages applications and their dependencies into portable, lightweight containers that run consistently across environments.
Table of Contents
- Core Concepts
- Common Workflows
- Dockerfile Reference
- Multi-Stage Builds
- Docker Compose
- Networking & Volumes
- Security Hardening
- CI/CD Integration
- Kubernetes Bridge Concepts
- CLI Reference
- Best Practices
- Troubleshooting
- References
Core Concepts
| Concept | Description |
|---|---|
| Image | Immutable template used to create containers |
| Container | Running instance of an image |
| Dockerfile | Build instructions for an image |
| Layer | Each instruction creates a cached filesystem layer |
| Volume | Persistent storage outside container lifecycle |
| Network | Enables container-to-container communication |
| Registry | Stores images (Docker Hub, ECR, GCR, GHCR) |
Common Workflows
Build an Image
docker build -t myapp:latest .
Specific Dockerfile:
docker build -f Dockerfile.prod -t myapp:prod .
Run a Container
docker run -d -p 8080:80 --name myapp myapp:latest
With environment variables:
docker run -d \
-e NODE_ENV=production \
-e DB_HOST=database \
-p 8080:3000 \
myapp:latest
Interactive shell:
docker run -it myapp bash
Manage Containers
docker ps
docker ps -a
docker logs myapp
docker exec -it myapp bash
docker stop myapp
docker rm myapp
Push to Registry
docker login
docker tag myapp:latest username/myapp:latest
docker push username/myapp:latest
Dockerfile Reference
Basic Example
FROM node:20-alpine
WORKDIR /app
COPY package*.json ./
RUN npm install --production
COPY . .
EXPOSE 3000
CMD ["node", "server.js"]
Environment Variables
ENV NODE_ENV=production
Non-Root User
RUN addgroup -S app && adduser -S app -G app
USER app
Multi-Stage Builds
Reduces final image size.
FROM node:20-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm install
COPY . .
RUN npm run build
FROM nginx:alpine
COPY --from=builder /app/dist /usr/share/nginx/html
Benefits:
- Smaller attack surface
- Reduced image size
- Production-only artifacts
Docker Compose
For multi-container applications.
docker-compose.yml
version: "3.9"
services:
app:
build: .
ports:
- "3000:3000"
environment:
- DB_HOST=db
depends_on:
- db
db:
image: postgres:15
environment:
POSTGRES_PASSWORD: example
volumes:
- db_data:/var/lib/postgresql/data
volumes:
db_data:
Run:
docker compose up -d
docker compose down
Networking & Volumes
Networks
docker network create mynetwork
docker run --network mynetwork myapp
Inspect:
docker network inspect mynetwork
Volumes
Create:
docker volume create myvolume
Mount:
docker run -v myvolume:/data myapp
Bind mount:
docker run -v $(pwd)/data:/app/data myapp
Security Hardening
Image Security
- Pin image versions (
node:20.11-alpine) - Avoid
latest - Use minimal base images (Alpine, distroless)
- Remove build tools from production image
Drop Privileges
docker run --user 1000:1000 myapp
Read-Only Filesystem
docker run --read-only myapp
Limit Resources
docker run --memory="512m" --cpus="1.0" myapp
Scan Images
docker scan myapp
CI/CD Integration
Build in CI
docker build -t myapp:${GIT_SHA} .
Tag & push:
docker tag myapp:${GIT_SHA} registry/myapp:${GIT_SHA}
docker push registry/myapp:${GIT_SHA}
Example GitHub Actions Snippet
- name: Build image
run: docker build -t myapp:${{ github.sha }} .
- name: Push image
run: |
docker tag myapp:${{ github.sha }} myrepo/myapp:${{ github.sha }}
docker push myrepo/myapp:${{ github.sha }}
Kubernetes Bridge Concepts
| Docker | Kubernetes Equivalent |
|---|---|
| Container | Pod |
| docker run | kubectl apply |
| docker-compose | Helm / K8s manifests |
| Network | Service |
| Volume | PersistentVolume |
Image built via Docker is deployed to Kubernetes cluster via:
kubectl apply -f deployment.yaml
CLI Reference
Image Commands
| Command | Description |
|---|---|
| docker build | Build image |
| docker images | List images |
| docker rmi | Remove image |
| docker pull | Pull image |
| docker push | Push image |
Container Commands
| Command | Description |
|---|---|
| docker run | Run container |
| docker start | Start container |
| docker stop | Stop container |
| docker rm | Remove container |
| docker logs | View logs |
| docker exec | Execute command |
System Commands
| Command | Description |
|---|---|
| docker system df | Disk usage |
| docker system prune | Remove unused data |
| docker inspect | Detailed JSON metadata |
Best Practices
Image Optimization
- Use multi-stage builds
- Use
.dockerignore - Copy dependency files first (cache leverage)
- Keep images under ~200MB if possible
- Minimize layers
Performance
- Avoid large build context
- Use build cache properly
- Avoid unnecessary package installs
- Remove temporary files
Reliability
- Add HEALTHCHECK:
HEALTHCHECK CMD curl --fail http://localhost:3000 || exit 1
- Use restart policies:
docker run --restart unless-stopped myapp
Troubleshooting
Container Exits Immediately
Check logs:
docker logs container_name
Common causes:
- Wrong CMD
- Crash on startup
- Missing env variable
- Port misconfiguration
Port Not Accessible
Verify:
- App listening on 0.0.0.0
- Correct port mapping (
-p host:container) - Firewall not blocking port
Disk Space Issues
Check:
docker system df
Cleanup:
docker system prune -a
Permission Errors (Linux)
If volume mount fails:
sudo chown -R 1000:1000 ./data
Or match container UID.
References
- https://docs.docker.com/
- https://docs.docker.com/engine/reference/commandline/cli/
- https://docs.docker.com/compose/
- https://docs.docker.com/develop/develop-images/dockerfile_best-practices/