docker compose — стек контейнеров одним файлом

docker compose — плагин Docker для стека из нескольких контейнеров. Сервисы, их образы, порты, тома, переменные и порядок запуска описаны в одном файле compose.yaml. docker compose up -d создаёт по нему сеть, тома и контейнеры, down убирает их. Всё, что делает compose, можно сделать и руками командами docker — файл избавляет от длинных docker run и порядка запуска в голове.

На машине тренажёра — Docker Compose 2.40, команда пишется через пробел: docker compose. Старой программы docker-compose через дефис нет. Как и остальные команды Docker, compose идёт через sudo.

Compose ищет compose.yaml (или docker-compose.yml) в текущем каталоге. Другой файл — -f stack.yaml.

Файл compose.yaml

Стек из двух сервисов: backend отдаёт страницу из тома, proxy — nginx перед ним, единственный с портом наружу.

services:
  backend:
    image: busybox
    command:
      - sh
      - -c
      - >-
        echo "<h1>$$GREETING</h1>" > /www/index.html &&
        exec httpd -f -p 8000 -h /www
    environment:
      GREETING: ${GREETING:-hello}
    volumes:
      - data:/www
    healthcheck:
      test: ["CMD", "wget", "-q", "-O", "/dev/null",
             "http://127.0.0.1:8000/"]
      interval: 5s
      timeout: 3s
      retries: 3
  proxy:
    image: nginx:alpine
    ports:
      - "8090:80"
    volumes:
      - ./nginx.conf:/etc/nginx/conf.d/default.conf:ro
    depends_on:
      backend:
        condition: service_healthy
    restart: unless-stopped
volumes:
  data:

Рядом лежит nginx.conf с proxy_pass http://backend:8000; — nginx ходит к соседу по имени сервиса.

Ключ volumes верхнего уровня объявляет именованные тома, networks — дополнительные сети. Синтаксис — YAML: отступы пробелами, табуляция запрещена. Порт пиши в кавычках: "8090:80".

Том, созданный заранее (docker volume create keep), подключают как внешний — compose его не создаёт и не удаляет:

volumes:
  data:
    external: true
    name: keep

Внешнего тома нет — up падает: external volume "keep" not found. Без external: true compose создаёт свой пустой том <проект>_data, даже если рядом лежит keep с данными.

Без ключа networks все сервисы проекта в одной сети. Свои сети объявляют в networks: верхнего уровня и перечисляют у сервиса: networks: [front, back]. Имя сервиса видно только в общих сетях: web из сети front не находит db из back (server can't find db), а app, подключённый к обеим, видит обоих.

Проект: имена контейнеров, сети и томов

Файл описывает проект. Имя проекта — имя каталога, где лежит compose.yaml; от него строятся имена всего, что создаёт compose:

student@ubuntu:~/stack$ sudo docker compose up -d
 Network stack_default  Created
 Volume stack_data  Created
 Container stack-backend-1  Created
 Container stack-proxy-1  Created
 Container stack-backend-1  Started
 Container stack-backend-1  Waiting
 Container stack-backend-1  Healthy
 Container stack-proxy-1  Started

Все сервисы проекта в одной сети, и каждый виден соседям по имени сервиса:

student@ubuntu:~/stack$ sudo docker compose exec proxy nslookup backend
Server:         127.0.0.11
…
Name:   backend
Address: 172.18.0.2

Команды compose работают с сервисами по их именам из файла: logs backend, exec proxy, restart proxy. Их нужно запускать из каталога проекта — или с -f и -p.

Переменные

${GREETING:-hello} в файле compose подставляет сам, до запуска контейнеров: значение переменной окружения или hello, если её нет. Переменные берутся из файла .env рядом с compose.yaml:

student@ubuntu:~/stack$ echo GREETING=privet > .env
student@ubuntu:~/stack$ sudo docker compose up -d
 Container stack-backend-1  Recreate
 Container stack-backend-1  Recreated
 Container stack-proxy-1  Running
…
student@ubuntu:~/stack$ curl -s localhost:8090/
<h1>privet</h1>

up -d пересоздал только backend: у него поменялось окружение. proxy не менялся и продолжил работать.

Переменная оболочки перед sudo до compose не доходит: sudo чистит окружение, и GREETING=privet sudo docker compose up -d ничего не меняет. Пиши значение в .env.

$$ — буквальный знак доллара: $$GREETING в command compose не трогает, его раскроет оболочка внутри контейнера. Что получилось после подстановки, показывает docker compose config.

Порядок запуска и healthcheck

depends_on: [backend] только задаёт порядок: proxy стартует после того, как контейнер backend запущен, — готов он отвечать или нет. Ждать готовности умеет condition: service_healthy — тогда compose ждёт статуса healthy от проверки здоровья backend.

healthcheck.test — команда внутри контейнера: код 0 — здоров. Docker выполняет её каждые interval, ждёт не дольше timeout, после retries неудач подряд ставит unhealthy. Статус виден в ps:

student@ubuntu:~/stack$ sudo docker compose ps
NAME              …   SERVICE   …   STATUS
stack-backend-1   …   backend   …   Up 6 seconds (healthy)
stack-proxy-1     …   proxy     …   Up Less than a second

У proxy в столбце PORTS — 0.0.0.0:8090->80/tcp, [::]:8090->80/tcp.

Команда проверки должна быть в образе: в busybox и alpine есть wget, curl нет.

Команды стека

Правку compose.yaml или .env применяет только up -d. restart перезапускает процесс в старом контейнере: файлы с хоста он прочитает заново, а переменные останутся прежними.

student@ubuntu:~/nets$ echo GREETING=privet > .env
student@ubuntu:~/nets$ sudo docker compose restart app
student@ubuntu:~/nets$ sudo docker compose exec app env | grep GREETING
GREETING=hello
student@ubuntu:~/nets$ sudo docker compose up -d
 Container nets-app-1  Recreate
…
student@ubuntu:~/nets$ sudo docker compose exec app env | grep GREETING
GREETING=privet

• docker — контейнеры, тома, сети и inspect без compose.
• container-images — откуда берутся образы сервисов.
• dockerfile — собрать свой образ для build:.
• env-vars — переменные окружения в сервисах.
• nginx — прокси перед сервисами стека.
• curl — проверить ответ стека с хоста.
• jq — разобрать ps --format json.