Docker Patterns

Улучшите свой DevOps-процесс с помощью навыка Docker Patterns для Claude Code. Получите доступ к лучшим практикам для Docker Compose, усиления безопасности и оркестрации.

Деплой и DevOps ★ 172,009 GitHub (172,009 ★)

Этот навык предоставляет Claude специализированные знания для реализации надежных сред Docker и Docker Compose. Он предлагает стандартные шаблоны для многоконтейнерных архитектур, многоступенчатых Dockerfile, разделяющих разработку и production, а также продвинутые стратегии работы с сетями и томами. Создаете ли вы новый локальный стек разработки, усиливаете безопасность контейнеров с помощью непривилегированных пользователей или устраняете сложные проблемы оркестрации — этот навык гарантирует, что ваша инфраструктура соответствует отраслевым лучшим практикам производительности и сопровождаемости.

Ключевые особенности

01Стандартные шаблоны Docker Compose для локальных стеков веб-приложений

02Управление постоянными томами и шаблоны работы с данными

03172,009 звёзд на GitHub

04Усиление безопасности контейнеров: управление возможностями и непривилегированные пользователи

05Продвинутые сетевые стратегии для безопасного обнаружения сервисов

06Многоступенчатые шаблоны Dockerfile для оптимизации размеров образов и безопасности

Варианты использования

01Настройка локальной среды разработки с горячей перезагрузкой и интегрированными сервисами

02Конфигурирование многоконтейнерной сети с ограниченным доступом между контейнерами

03Оптимизация production Dockerfile для минимального размера и высокой безопасности

name	docker-patterns
description	Yerel geliştirme, konteyner güvenliği, ağ, volume stratejileri ve multi-servis orkestrasyon için Docker ve Docker Compose kalıpları.
origin	ECC

Docker Kalıpları

Konteynerize edilmiş geliştirme için Docker ve Docker Compose en iyi uygulamaları.

Ne Zaman Aktifleştirmeli

Yerel geliştirme için Docker Compose kurarken
Çok konteynerli mimariler tasarlarken
Konteyner ağ veya volume sorunlarını giderirken
Dockerfile'ları güvenlik ve boyut için incelerken
Yerel geliştirmeden konteynerize iş akışına geçerken

Yerel Geliştirme için Docker Compose

Standart Web Uygulaması Stack'i

# docker-compose.yml
services:
  app:
    build:
      context: .
      target: dev                     # Multi-stage Dockerfile'ın dev aşamasını kullan
    ports:
      - "3000:3000"
    volumes:
      - .:/app                        # Hot reload için bind mount
      - /app/node_modules             # Anonim volume -- konteyner bağımlılıklarını korur
    environment:
      - DATABASE_URL=postgres://postgres:postgres@db:5432/app_dev
      - REDIS_URL=redis://redis:6379/0
      - NODE_ENV=development
    depends_on:
      db:
        condition: service_healthy
      redis:
        condition: service_started
    command: npm run dev

  db:
    image: postgres:16-alpine
    ports:
      - "5432:5432"
    environment:
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: postgres
      POSTGRES_DB: app_dev
    volumes:
      - pgdata:/var/lib/postgresql/data
      - ./scripts/init-db.sql:/docker-entrypoint-initdb.d/init.sql
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U postgres"]
      interval: 5s
      timeout: 3s
      retries: 5

  redis:
    image: redis:7-alpine
    ports:
      - "6379:6379"
    volumes:
      - redisdata:/data

  mailpit:                            # Yerel email testi
    image: axllent/mailpit
    ports:
      - "8025:8025"                   # Web UI
      - "1025:1025"                   # SMTP

volumes:
  pgdata:
  redisdata:

Geliştirme vs Üretim Dockerfile

# Aşama: bağımlılıklar
FROM node:22-alpine AS deps
WORKDIR /app
COPY package.json package-lock.json ./
RUN npm ci

# Aşama: dev (hot reload, debug araçları)
FROM node:22-alpine AS dev
WORKDIR /app
COPY --from=deps /app/node_modules ./node_modules
COPY . .
EXPOSE 3000
CMD ["npm", "run", "dev"]

# Aşama: build
FROM node:22-alpine AS build
WORKDIR /app
COPY --from=deps /app/node_modules ./node_modules
COPY . .
RUN npm run build && npm prune --production

# Aşama: production (minimal image)
FROM node:22-alpine AS production
WORKDIR /app
RUN addgroup -g 1001 -S appgroup && adduser -S appuser -u 1001
USER appuser
COPY --from=build --chown=appuser:appgroup /app/dist ./dist
COPY --from=build --chown=appuser:appgroup /app/node_modules ./node_modules
COPY --from=build --chown=appuser:appgroup /app/package.json ./
ENV NODE_ENV=production
EXPOSE 3000
HEALTHCHECK --interval=30s --timeout=3s CMD wget -qO- http://localhost:3000/health || exit 1
CMD ["node", "dist/server.js"]

Override Dosyaları

# docker-compose.override.yml (otomatik yüklenir, sadece dev ayarları)
services:
  app:
    environment:
      - DEBUG=app:*
      - LOG_LEVEL=debug
    ports:
      - "9229:9229"                   # Node.js debugger

# docker-compose.prod.yml (üretim için açıkça)
services:
  app:
    build:
      target: production
    restart: always
    deploy:
      resources:
        limits:
          cpus: "1.0"
          memory: 512M

# Geliştirme (override'ı otomatik yükler)
docker compose up

# Üretim
docker compose -f docker-compose.yml -f docker-compose.prod.yml up -d

Ağ (Networking)

Servis Keşfi

Aynı Compose ağındaki servisler servis adıyla çözümlenir:

# "app" konteynerinden:
postgres://postgres:postgres@db:5432/app_dev    # "db" db konteynerine çözümlenir
redis://redis:6379/0                             # "redis" redis konteynerine çözümlenir

Özel Ağlar

services:
  frontend:
    networks:
      - frontend-net

  api:
    networks:
      - frontend-net
      - backend-net

  db:
    networks:
      - backend-net              # Sadece api'den erişilebilir, frontend'den değil

networks:
  frontend-net:
  backend-net:

Sadece Gereklileri Açığa Çıkarma

services:
  db:
    ports:
      - "127.0.0.1:5432:5432"   # Sadece host'tan erişilebilir, ağdan değil
    # Üretimde port'ları tamamen çıkar -- sadece Docker ağı içinden erişilebilir

Volume Stratejileri

volumes:
  # İsimli volume: konteyner yeniden başlatmalarında kalıcı, Docker tarafından yönetilir
  pgdata:

  # Bind mount: host dizinini konteynere eşler (geliştirme için)
  # - ./src:/app/src

  # Anonim volume: bind mount override'ından konteyner tarafından oluşturulan içeriği korur
  # - /app/node_modules

Yaygın Kalıplar

services:
  app:
    volumes:
      - .:/app                   # Kaynak kodu (hot reload için bind mount)
      - /app/node_modules        # Konteyner'ın node_modules'ünü host'tan koru
      - /app/.next               # Build cache'ini koru

  db:
    volumes:
      - pgdata:/var/lib/postgresql/data          # Kalıcı veri
      - ./scripts/init.sql:/docker-entrypoint-initdb.d/init.sql  # Init scriptleri

Konteyner Güvenliği

Dockerfile Sıkılaştırma

# 1. Belirli tag'ler kullanın (:latest asla)
FROM node:22.12-alpine3.20

# 2. Root olmayan kullanıcı olarak çalıştır
RUN addgroup -g 1001 -S app && adduser -S app -u 1001
USER app

# 3. Capability'leri düşür (compose'da)
# 4. Mümkün olduğunda salt okunur kök dosya sistemi
# 5. Image layer'larında secret yok

Compose Güvenliği

services:
  app:
    security_opt:
      - no-new-privileges:true
    read_only: true
    tmpfs:
      - /tmp
      - /app/.cache
    cap_drop:
      - ALL
    cap_add:
      - NET_BIND_SERVICE          # Sadece < 1024 port'lara bind için

Secret Yönetimi

# İYİ: Ortam değişkenleri kullanın (runtime'da enjekte edilir)
services:
  app:
    env_file:
      - .env                     # .env'i asla git'e commit etmeyin
    environment:
      - API_KEY                  # Host ortamından miras alır

# İYİ: Docker secrets (Swarm modu)
secrets:
  db_password:
    file: ./secrets/db_password.txt

services:
  db:
    secrets:
      - db_password

# KÖTÜ: Image'de hardcode
# ENV API_KEY=sk-proj-xxxxx      # ASLA BUNU YAPMAYIN

.dockerignore

node_modules
.git
.env
.env.*
dist
coverage
*.log
.next
.cache
docker-compose*.yml
Dockerfile*
README.md
tests/

Hata Ayıklama

Yaygın Komutlar

# Logları görüntüle
docker compose logs -f app           # App loglarını takip et
docker compose logs --tail=50 db     # db'den son 50 satır

# Çalışan konteynerde komut çalıştır
docker compose exec app sh           # app'e shell ile gir
docker compose exec db psql -U postgres  # postgres'e bağlan

# İncele
docker compose ps                     # Çalışan servisler
docker compose top                    # Her konteynerdeki işlemler
docker stats                          # Kaynak kullanımı

# Yeniden build et
docker compose up --build             # Image'leri yeniden build et
docker compose build --no-cache app   # Tam rebuild'i zorla

# Temizle
docker compose down                   # Konteynerleri durdur ve kaldır
docker compose down -v                # Volume'leri de kaldır (YIKıCı)
docker system prune                   # Kullanılmayan image/konteynerleri kaldır

Ağ Sorunlarını Hata Ayıklama

# Konteyner içinde DNS çözümlemesini kontrol et
docker compose exec app nslookup db

# Bağlantıyı kontrol et
docker compose exec app wget -qO- http://api:3000/health

# Ağı incele
docker network ls
docker network inspect <project>_default

Anti-Kalıplar

# KÖTÜ: Üretimde orkestrasyon olmadan docker compose kullanma
# Üretim çok konteynerli iş yükleri için Kubernetes, ECS veya Docker Swarm kullanın

# KÖTÜ: Volume olmadan konteynerlerde veri depolama
# Konteynerler geçicidir -- volume olmadan yeniden başlatmada tüm veri kaybolur

# KÖTÜ: Root olarak çalıştırma
# Daima root olmayan bir kullanıcı oluşturun ve kullanın

# KÖTÜ: :latest tag kullanma
# Yeniden üretilebilir build'ler için belirli versiyonlara sabitle

# KÖTÜ: Tüm servisleri içeren tek dev konteyner
# Endişeleri ayırın: konteyner başına bir işlem

# KÖTÜ: Secret'ları docker-compose.yml'e koymak
# .env dosyaları (gitignore'lanmış) veya Docker secrets kullanın

📦 Что это

Набор проверенных шаблонов и практик для работы с Docker и Docker Compose, ориентированный на локальную разработку, безопасность контейнеров, управление сетями и томами, а также оркестрацию нескольких сервисов. Помогает инженерам быстро настраивать рабочие окружения, избегать типовых ошибок и внедрять best practices с первых строк docker-compose.yml.

🛠️ Как работает

⚙️ Docker Compose для локальной разработки

Главный сценарий — описание полноценного стека сервисов в одном файле. На примере типового веб-приложения:

Сервис приложения (app): собирается из Dockerfile с multi-stage, использует target: dev для этапа разработки. Пробрасывает порт 3000, монтирует исходный код через bind mount (.:/app) для hot reload, а node_modules сохраняется анонимным томом (/app/node_modules) — чтобы не затирать зависимости хоста.
Зависимости: depends_on с condition: service_healthy для PostgreSQL и service_started для Redis — гарантирует, что приложение стартует только после готовности базы.
Вспомогательные сервисы: PostgreSQL 16 Alpine, Redis 7 Alpine, Mailpit для тестирования отправки писем (SMTP + веб-интерфейс на порту 8025).
Тома: именованные pgdata и redisdata для персистентности данных.

🧩 Production-сборка через Override-файлы

Используются два подхода:

docker-compose.override.yml — автоматически подгружается при простом docker compose up, содержит отладочные настройки (порт 9229 для Node.js debugger, переменные DEBUG, LOG_LEVEL).
docker-compose.prod.yml — включается явно (-f), переопределяет target: production, добавляет restart: always и ограничения ресурсов (cpus, memory).

Пример запуска:

# разработка
docker compose up

# production (явно два файла)
docker compose -f docker-compose.yml -f docker-compose.prod.yml up -d

🌐 Сеть и Service Discovery

Автоматический DNS: в рамках одной сети Compose сервисы доступны по имени: db:5432, redis:6379. Никаких жестко заданных IP.
Изоляция через несколько сетей: frontend-net и backend-net — frontend видит только API, API видит и frontend, и БД. База изолирована от фронтенда.
Безопасное пробрасывание портов: для dev-доступа с хоста используйте 127.0.0.1:5432:5432 — порт открыт только для localhost. В production порты из сервисов лучше убрать совсем, оставив доступ только через внутреннюю сеть.

💾 Volume-стратегии

Тип тома	Назначение
Именованный (`pgdata`)	Персистентность данных БД, управляется Docker
Bind mount (`./src:/app/src`)	Живая синхронизация кода для разработки
Анонимный (`/app/node_modules`)	Предотвращает перезапись содержимого контейнера хостом (например, node_modules, .next cache)

Популярный паттерн для приложения:

volumes:
  - .:/app               # код
  - /app/node_modules    # защита node_modules в контейнере
  - /app/.next           # сохранение билд-кэша

🔒 Контейнерная безопасность

В Dockerfile:

Фиксированные версии базовых образов (node:22.12-alpine3.20 вместо :latest).
Создание непривилегированного пользователя (adduser -S app -u 1001) и переключение на него (USER app).
Минимизация слоёв и никаких секретов в образе.

В docker-compose.yml:

security_opt: [no-new-privileges:true] — запрет повышения привилегий.
read_only: true + tmpfs для /tmp и /app/.cache — файловая система контейнера только для чтения, запись только во временные каталоги.
cap_drop: ALL + cap_add: NET_BIND_SERVICE — удалить все capability, оставить только привязку к привилегированным портам (<1024).

Секреты:

Никаких хардкодных ENV API_KEY=... в образе.
Использование внешних .env-файлов (не коммитятся в git) или Docker Secrets для Swarm-режима.

🧹 Anti-паттерны (чего делать нельзя)

❌ Использовать docker compose как продакшн-оркестратор — для этого есть Kubernetes, ECS, Swarm.
❌ Хранить данные без томов — контейнер эфемерен, после перезапуска всё пропадёт.
❌ Работать от root — всегда создавайте отдельного пользователя.
❌ Использовать тег :latest — нарушает воспроизводимость сборок.
❌ Мешать всё в один контейнер — один контейнер = один процесс.
❌ Зашивать секреты в docker-compose.yml — используйте .env или secrets.

🔍 Диагностика и отладка

Набор команд для частых сценариев:

# логи конкретного сервиса
docker compose logs -f app

# выполнить команду внутри контейнера
docker compose exec app sh
docker compose exec db psql -U postgres

# проверка сетевой связности
docker compose exec app nslookup db
docker compose exec app wget -qO- http://api:3000/health

# сброс состояния
docker compose down -v          # удалить всё, включая тома
docker system prune            # очистить неиспользуемые образы/контейнеры

📌 Когда использовать

На старте нового микросервиса — скопировать шаблон docker-compose.yml с нужными сервисами, подогнать порты и переменные.
Перевод проекта с локального запуска в контейнеры — взять готовый паттерн multi-stage Dockerfile и структуру volume.
Диагностика сетевых проблем — изоляция сетей, проверка DNS, проброс только необходимых портов.
Аудит безопасности — сверка с чеклистом: no-new-privileges, read_only, cap_drop, пользователь не root, отсутствие секретов в образе.
Оптимизация размера образа — внедрение multi-stage сборки, dockerignore, фиксация версий базовых образов.

⚠️ Важно знать

Примеры в этом патерне преимущественно для Node.js, но концепции универсальны: достаточно заменить базовый образ и команды.
docker-compose.override.yml подходит только для разработки — в CI/CD или production используйте явный -f с двумя файлами.
Перед запуском production-сборки убедитесь, что secrets и .env-файлы не попали в репозиторий (добавьте .env* в .gitignore).
Паттерн не заменяет полноценный оркестратор — для нескольких нод, автоскейлинга и rolling updates смотрите в сторону Kubernetes.

Установите одной командой.

npx skillfish add affaan-m/everything-claude-code docker-patterns

Источник: https://mcpmarket.com/tools/skills/docker-patterns-5