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.md

GitHub

Docker

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

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


End of Skill