Образы и реестры

Публичные образы, учётные данные для приватных образов и загрузка в собственный реестр ACDN.

Публичные образы

  • Развернуть можно любой образ, который анонимно загружается по HTTPS: с Docker Hub, GitHub Container Registry и других реестров, реализующих стандартный API реестра.
  • Указывайте полный адрес с хостом реестра, репозиторием и тегом или дайджестом, например ghcr.io/example/chat:1.4.2 или docker.io/library/nginx:1.27. Без хоста подразумевается Docker Hub, без тега — latest.
  • Для публичных образов учётные данные не нужны. Оставьте deploy_registry_id пустым.

Приватные образы на Docker Hub и GitHub

Сохраните токен доступа один раз и указывайте его в каждом сервисе, использующем приватный образ из этого реестра.

Shell
python3 acdn-agent.py call /api/user/deploy/registries -- \
  --json '{"provider":"github","username":"example","token":"ghp_..."}'

# используйте полученный id как "deploy_registry_id" сервиса
  • Docker Hub (provider docker_hub): имя пользователя Docker Hub и токен доступа с правом чтения, для образов на docker.io.
  • GitHub Container Registry (provider github): имя пользователя GitHub и персональный токен доступа с областью read:packages, для образов на ghcr.io.
  • Учётные данные должны соответствовать хосту реестра образа.
  • Приватные образы в других реестрах не поддерживаются. Загрузите их в свой реестр ACDN.
  • Токены хранятся в зашифрованном виде и никогда не возвращаются.

Собственный реестр ACDN

Каждый аккаунт может создать один приватный реестр с собственным именем хоста. Он принимает docker push и docker pull по HTTPS, поэтому можно развернуть образ, который есть только на вашем компьютере.

Shell
python3 acdn-agent.py call /api/user/deploy/registries/personal -- --request POST

# повторяйте, пока не появится "status":"ready", затем получите данные для входа
python3 acdn-agent.py call /api/user/deploy/registries/personal
python3 acdn-agent.py call /api/user/deploy/registries/personal/credentials

printf '%s' 'REGISTRY_PASSWORD' | docker login REGISTRY_HOSTNAME --username owner --password-stdin
docker build --platform linux/amd64 --tag REGISTRY_HOSTNAME/chat:1.4.2 .
docker push REGISTRY_HOSTNAME/chat:1.4.2
  • Укажите REGISTRY_HOSTNAME/chat:1.4.2 как образ сервиса и оставьте deploy_registry_id пустым: сервисы того же аккаунта загружают образы из этого реестра без сохранённых учётных данных.
  • Имена репозиториев пишутся в нижнем регистре и могут содержать цифры, точки, подчёркивания, дефисы и косые черты.
  • На загрузку больших слоёв не влияет 15-секундное ограничение ответа точек доступа: оно отсчитывается только после того, как загрузка получена.
  • Данные для входа в реестр позволяют загружать, скачивать и удалять любые образы. Получайте их через операцию credentials по мере необходимости, а не храните у себя.
  • При создании реестра добавляются приложение Deploy, в котором он работает, и Storage Zone, в которой хранятся образы. Оба ресурса оплачиваются по обычным тарифам Deploy и Storage.
  • Статус реестра: provisioning (ждите), ready, failed (отправьте запрос на создание ещё раз), deleting (ждите, пока реестр не начнёт возвращать 404), delete_failed (отправьте запрос на удаление ещё раз). Данные для входа и деплой его образов доступны, только пока статус ready.
  • При удалении реестра Storage Zone и образы в ней сохраняются. Созданный после этого реестр получает новое имя хоста и отдаёт образы, сохранённые в этой Storage Zone, поэтому обновите образ в каждом сервисе, который использовал прежнее имя хоста.

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