Provision
—— XP

Практика: разработка и сервер из одного описания

практика~35 минут+425 XP

Сейчас всё в одном compose.yaml: и публикация порта приложения, нужная на стенде, и отсутствие лимитов, недопустимое на сервере. Разведём это по трём файлам и проверим итог не глазами, а командой.

Шаг 1. Убрать порт из общего файла

Списки при наложении складываются, и пустой список поверх ничего не убирает, поэтому опасное в общем файле не держат. Открой compose.yaml и удали у сервиса app блок ports — две строки.

Исключение у правила одно, и оно появится в миссии: порты прокси, единственного входа на стенд. Они нужны в любом окружении, поэтому им как раз место в общем файле. Проверки этой практики смотрят только на сервис app, так что миссия их не сломает.

nano ~/infra/stand/compose.yaml, у сервиса app удалить
    ports:
      - "127.0.0.1:8012:8000"

Проверим: grep -c считает строки с публикациями в итоговом описании.

ubuntu@stand:~$
cd ~/infra/stand
ubuntu@stand:~$
docker compose config | grep -c published
ubuntu@stand:~$
0

Ноль: общий файл больше ничего не открывает. Если вместо нуля ошибка no configuration file provided, ты не в каталоге стенда.

Шаг 2. Файл разработки

Отличия разработки — в compose.override.yaml. Его Compose подхватит сам. Вернём туда порт приложения.

nano ~/infra/stand/compose.override.yaml
services:
  app:
    ports:
      - "127.0.0.1:${APP_PORT:-8012}:8000"

Порт — подстановкой со значением по умолчанию: можно поменять в .env, не трогая файл.

ubuntu@stand:~$
docker compose config | grep -c published
ubuntu@stand:~$
1

Одна публикация, на петле. Порт базы сюда же можно добавить, когда понадобится подключаться к ней с ноутбука клиентом; пока не нужно.

Шаг 3. Файл сервера

На сервере у приложения соседи, и одно приложение не должно съесть всю машину. Начнём с памяти: это то, что кончается первым.

nano ~/infra/stand/compose.prod.yaml
services:
  app:
    deploy:
      resources:
        limits:
          memory: 512M

limits.memory — потолок памяти. Превысит — ядро убьёт процесс в контейнере, и в docker inspect будет OOMKilled: true. Лучше одно упавшее приложение, чем вставший сервер. Ниже, на том же уровне, что memory, — процессор:

compose.prod.yaml, под memory
          cpus: "1.0"

cpus — сколько ядер можно занять, дробное число: "0.5" — половина. Процессор, в отличие от памяти, не убивает: приложение просто работает медленнее. Третья вещь — журнал. По умолчанию журнал контейнера растёт, пока не кончится диск; на сервере это частая причина «встал на ровном месте». Допиши на уровне deploy:

compose.prod.yaml, на уровне deploy
    logging:
      options:
        max-size: "10m"
        max-file: "3"

logging.options оставляет не больше трёх файлов журнала по десять мегабайт, старые удаляются сами.

Шаг 4. Включить набор сервера

На сервере набор файлов задают переменной COMPOSE_FILE. Попробуем её здесь в оболочке: export делает переменную видимой для всех следующих команд.

ubuntu@stand:~$
export COMPOSE_FILE=compose.yaml:compose.prod.yaml

Теперь docker compose читает основной файл и серверный, а override — нет: список задан явно.

ubuntu@stand:~$
docker compose config | grep -c published
ubuntu@stand:~$
0
ubuntu@stand:~$
docker compose config | grep memory
ubuntu@stand:~$
          memory: "536870912"

Ни одной публикации, и лимит на месте: 512 мегабайт Compose записал в байтах. Флаг -A2 у grep показывает ещё две строки после найденной — так видно и процессор:

ubuntu@stand:~$
docker compose config app | grep -A2 limits
ubuntu@stand:~$
        limits:
          cpus: 1
          memory: "536870912"

Шаг 5. Образ на сервере — из реестра

На стенде приложение собирается из твоего Dockerfile строкой build: ../app. На сервере так не делают: там запускают образ, который уже собран и лежит в реестре, — один и тот же для всех машин. Допиши в compose.prod.yaml у сервиса app две строки, с тем же отступом, что у deploy.

compose.prod.yaml, у сервиса app
    build: !reset null
    image: ${APP_IMAGE:?задай образ в .env}

image — одиночное значение, и файл поверх просто его задаёт. А build из основного файла иначе доехал бы до сервера: тег !reset из урока про окружения убирает ключ целиком. Почему это важно, а не для красоты: если в итоге есть и build, и image, Compose при неудачном скачивании образа молча соберёт его из исходников под тем же тегом — и на сервер уедет не тот код, что в реестре. Без build неудачное скачивание остановит запуск.

Значение образа — подстановкой с формой :?. Посмотрим, как она работает: переменной в .env ещё нет, а набор сервера включён с прошлого шага.

ubuntu@stand:~$
docker compose config app
ubuntu@stand:~$
error while interpolating services.app.image: required variable APP_IMAGE is missing a value: задай образ в .env

Запуск прервался сразу и твоими словами — в отличие от простой формы ${APP_NAME}, которая в практике про первый файл подставила пустую строку. Образ возьмём тот, что ты выложил в реестр в миссии раздела про Docker. Допиши строку в конец .env.

ubuntu@stand:~$
echo 'APP_IMAGE=localhost:5000/provision/app:1.0.0' >> .env
ubuntu@stand:~$
docker compose config app | grep image
ubuntu@stand:~$
    image: localhost:5000/provision/app:1.0.0
    image: postgres:17-alpine
    image: postgres:17-alpine

После имени сервиса config печатает и его зависимости — отсюда два образа PostgreSQL, у db и migrate. А строки с каталогом сборки нет совсем: сборки на сервере не будет. Проверим это отдельно — у собираемого сервиса в итоге есть ключ context.

ubuntu@stand:~$
docker compose config app | grep -c context
ubuntu@stand:~$
0

Шаг 6. Запустить как на сервере

Применим серверный набор на стенде, чтобы увидеть разницу вживую.

ubuntu@stand:~$
docker compose up -d
ubuntu@stand:~$
[+] Running 3/3
 ✔ Container provision-db-1       Healthy
 ✔ Container provision-migrate-1  Exited
 ✔ Container provision-app-1      Started

Приложение пересоздано с новыми настройками и из образа реестра, а не из сборки. Флаг --max-time 3 у curl не даёт ждать дольше трёх секунд, -w печатает код ответа.

ubuntu@stand:~$
curl -s --max-time 3 -w '%{http_code}' localhost:8012
ubuntu@stand:~$
000

Код 000 — ответа нет вовсе: порт не опубликован, как и задумано для сервера. Лимит виден в docker stats.

ubuntu@stand:~$
docker stats --no-stream provision-app-1
ubuntu@stand:~$
NAME              CPU %   MEM USAGE / LIMIT   MEM %
provision-app-1   0.10%   61.3MiB / 512MiB    11.97%

Шаг 7. Вернуться к разработке

Пока у стека нет своего прокси, проверять приложение удобнее через 8012, поэтому возвращаем режим разработки. unset убирает переменную из оболочки.

ubuntu@stand:~$
unset COMPOSE_FILE
ubuntu@stand:~$
docker compose up -d
ubuntu@stand:~$
[+] Running 3/3
 ✔ Container provision-db-1       Running
 ✔ Container provision-migrate-1  Exited
 ✔ Container provision-app-1      Started
ubuntu@stand:~$
curl -s localhost:8012/health
ubuntu@stand:~$
ok

Порт снова на месте, и приложение снова собирается из Dockerfile.

ubuntu@stand:~$
docker compose config app | grep -c context

ubuntu@stand:~$
1
В миссии у стека появится свой прокси, и серверный режим станет основным.

Шаг 8. Шаблон и коммит

Новые переменные APP_IMAGE и APP_PORT должны быть видны коллеге в шаблоне.

ubuntu@stand:~$
echo 'APP_IMAGE=' >> .env.example
ubuntu@stand:~$
echo 'APP_PORT=' >> .env.example
ubuntu@stand:~$
git -C ~/infra add stand
ubuntu@stand:~$
git -C ~/infra commit -m "stand: разработка и сервер"

Если что-то не работает

Почти всё здесь проверяется одной командой config.

Симптом и причина
PROD не ноль
Публикация осталась в compose.yaml: наложением её не убрать, только удалить из общего файла.
DEV ноль
Файл называется не compose.override.yaml или в оболочке всё ещё задан COMPOSE_FILE: echo $COMPOSE_FILE.
NOW пустой
Стенд остался в серверном режиме: unset COMPOSE_FILE и docker compose up -d.

Что спросят на собеседовании

  • Почему порт приложения держат в файле разработки, а не в общем?
    Списки при наложении складываются. Порт из общего файла доедет до сервера, и файлом поверх его не убрать.
  • Зачем на сервере ротация журнала контейнера?
    По умолчанию журнал растёт без ограничений и однажды занимает весь диск. max-size и max-file держат его в заданных размерах.
Практика 03+425 XP

Развести окружения разработки и сервера файлами отличий и доказать сравнением итоговых описаний, что отличия именно те, что задуманы.

  • Три файла описания
  • В разработке порты открыты
  • На сервере ничего не опубликовано
  • На сервере у приложения лимит памяти
  • На сервере образ из реестра, без сборки
  • В общем файле у приложения нет портов
  • Стенд снова в режиме разработки и отвечает
Команда сдачи — выполни на своей машине
команда
cd ~/infra/stand 2>/dev/null || echo NOSTAND; ls compose*.yaml; echo "DEV=$(docker compose config app | grep -c published)"; echo "PROD=$(docker compose -f compose.yaml -f compose.prod.yaml config app | grep -c published)"; echo "LIMIT=$(docker compose -f compose.yaml -f compose.prod.yaml config app | grep -c 536870912)"; echo "SRVIMG=$(docker compose -f compose.yaml -f compose.prod.yaml config app | grep -c 'image: localhost:5000/')"; echo "SRVBUILD=$(docker compose -f compose.yaml -f compose.prod.yaml config app | grep -c context)"; echo "BASE=$(docker compose -f compose.yaml config app | grep -c published)"; echo "NOW=$(curl -s localhost:8012/health)"

Нашёл ошибку или непонятное место? Наведи на абзац — слева появится «+», нажми и напиши, что не так. Замечание увидит автор курса.Нашёл ошибку или непонятное место? Нажми «+» справа от заголовка раздела и напиши, что не так. Замечание увидит автор курса.