Среда выполнения контейнера

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

Образ и архитектура

  • Образы должны быть Linux-образами для архитектуры amd64 (x86-64). Из мультиархитектурного образа используется вариант linux/amd64. Образ, собранный только для arm64, не запустится.
  • Образ запускается со своими ENTRYPOINT, CMD, WORKDIR и USER.
  • Команда запуска, если она задана, заменяет ENTRYPOINT и CMD и выполняется как /bin/sh -c "<команда>". В этом случае образ должен содержать /bin/sh.
  • При каждом деплое тег разрешается в дайджест, и релиз запускает именно этот дайджест. Загрузка нового образа под тем же тегом ни на что не влияет до следующего деплоя.
  • Контейнеры работают в изолированной песочнице. Привилегированный режим, устройства хоста, сеть хоста и raw-сокеты (например, ping) недоступны.

Пользователь и файловая система

  • Процесс работает от пользователя, заданного инструкцией USER в образе. Если она не задана, процесс работает от root внутри песочницы. Поддерживаются образы и с root, и с обычным пользователем; переопределить пользователя в настройках сервиса нельзя.
  • Процесс root может менять владельца файлов, переключаться на другого пользователя и слушать порты ниже 1024. Setuid-программы не дают дополнительных привилегий, поэтому sudo и su не работают для обычного пользователя.
  • Если образ работает от обычного пользователя, слушайте порт выше 1024.
  • Файловая система контейнера доступна для записи, но временная: всё записанное вне тома теряется при каждом перезапуске или замене экземпляра.
  • Файлы вне томов вместе с выводом логов контейнера могут занимать до 512 MiB на экземпляр. Экземпляр, превысивший это ограничение, останавливается и заменяется.
  • Вывод логов ротируется автоматически и занимает не более примерно 30 МиБ, поэтому одни только логи не могут исчерпать это ограничение.

Тома

Том — это постоянный каталог, смонтированный по выбранному вами пути. Его содержимое сохраняется при перезапусках и новых релизах.

  • У каждого экземпляра собственный диск. Если экземпляров больше одного или один том смонтирован в двух сервисах, каждый экземпляр видит свои данные. Поэтому однофайловой базе данных, такой как SQLite, нужен replicas 1.
  • Диск подключён только к одному экземпляру одновременно. При релизе старый экземпляр останавливается до запуска нового, поэтому две версии никогда не пишут в один том.
  • Том монтируется как файловая система ext4 запрошенного размера, от 1 до 100 ГиБ на диск. При заполнении диска возвращается ошибка «no space left on device». Новый диск содержит каталог lost+found; программам, которым нужен пустой каталог, следует использовать подкаталог.
  • Смонтированный каталог принадлежит группе 1000 и доступен ей для записи, а каждый процесс в контейнере входит в группу 1000 независимо от пользователя. Поэтому образ с обычным пользователем может писать в том без смены владельца.
  • В приложении может быть до 10 дисков и 100 GiB суммарно, считая каждый экземпляр каждого сервиса.
  • Том можно увеличить в любой момент, но нельзя уменьшить. Новый размер применяется при следующем деплое.
  • API не сообщает, насколько заполнен диск. Проверяйте свободное место изнутри контейнера.
  • При отключении тома, уменьшении числа экземпляров, остановке или удалении сервиса диски сохраняются и продолжают оплачиваться. Данные удаляются, только когда вы удаляете том или приложение.

Тома хранятся на одном сервере, не реплицируются и не резервируются. Если этот сервер недоступен, сервис не работает до его возвращения, а данные могут быть потеряны. Храните важные файлы и резервные копии баз данных в ACDN Storage.

Окружение и секреты

  • У сервиса может быть до 64 переменных. Имена начинаются с буквы или подчёркивания и состоят из латинских букв, цифр и подчёркиваний; значения — до 8192 символов.
  • И переменные, и секреты попадают в контейнер как обычные переменные окружения. Секрет отличается обращением: он хранится в зашифрованном виде, никогда не возвращается через API и заменяется на [REDACTED] в логах, читаемых через ACDN.
  • Изменения применяются при следующем деплое. Каждый релиз сохраняет значения, с которыми он был выпущен, поэтому откат восстанавливает также окружение и секреты этого релиза.
  • Платформа задаёт HOSTNAME и может задавать для сервисов приложения, включая сам сервис, переменные вида WEB_SERVICE_HOST, WEB_SERVICE_PORT и WEB_PORT, где WEB — имя сервиса в верхнем регистре. WEB_PORT имеет вид tcp://адрес:порт. Не полагайтесь на эти переменные и не читайте переменную ИМЯ_PORT как число, если не задали её сами: ваши переменные с такими же именами имеют приоритет.
  • Переменной PORT нет. Ваш процесс должен слушать порт, указанный в http_port.

Запуск и завершение

  • Экземпляр завершается при каждом релизе, перезапуске, остановке и уменьшении числа экземпляров, а также когда платформе нужно его переместить.
  • При завершении главному процессу отправляется SIGTERM или сигнал, объявленный в образе инструкцией STOPSIGNAL, после чего платформа ждёт до 30 секунд. Процесс, который всё ещё работает, получает SIGKILL.
  • Главный процесс — это процесс 1 контейнера. Если задана команда запуска, процессом 1 становится оболочка: начинайте команду с exec, чтобы сигнал получила ваша программа, например exec node server.js.
  • По SIGTERM прекратите принимать соединения, закройте открытые, включая WebSocket, сбросьте данные на том и завершите процесс. Экземпляр исключается из маршрутизации в момент начала завершения.
  • Если главный процесс завершился по любой причине, экземпляр автоматически перезапускается с растущей задержкой между попытками.

Ограничения ресурсов

  • CPU: до 4 ядер на экземпляр. Потребление сверх ограничения замедляется, а не прерывается.
  • Память: до 8 GiB на экземпляр. Экземпляр, превысивший ограничение, принудительно завершается и перезапускается, а хронология деплоя сообщает о превышении ограничения памяти.
  • Эти ограничения одинаковы для всех сервисов и не настраиваются. Вы платите за фактически использованные процессорное время и память, а не за ограничения.
  • Экземпляры: в одном приложении одновременно работает не более 3, считая временный дополнительный экземпляр при релизе сервиса без томов. API отклоняет конфигурацию, которая не помещается.
  • Тома: от 1 до 100 ГиБ на диск, 10 дисков и 100 GiB на приложение.
  • Исходящая полоса: 1 Gbit/s на экземпляр.
  • Временные файлы и логи: 512 MiB на экземпляр.

Точные поля запросов и ответов, ограничения и ответы с ошибками приведены в справочнике Management API.