Связаться с намиПодключиться

Контейнер

Статья создана
Обновлена 2 апреля 2025 г.

Контейнер позволяет запустить в Yandex Cloud приложение, которое содержится в Docker-образе. После создания ревизии контейнера его можно вызвать:

  • через HTTPS;
  • с помощью триггера;
  • с помощью расширения Yandex API Gateway.

Подробнее о вызове контейнера.

Ревизия контейнера

Ревизию контейнера можно создать только из Docker-образа, который загружен в реестр Yandex Container Registry. Другие реестры не поддерживаются. Ревизия содержит всю информацию, необходимую для запуска контейнера.

Возможные статусы ревизии:

  • Active — активная;
  • Obsolete — устаревшая.

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

Примечание

Для сохранения целостности связей изменение и удаление ревизий контейнера не предусмотрено.

Создавать новую ревизию необходимо в следующих случаях:

  • загрузка новой версии Docker-образа в Yandex Container Registry;
  • изменение настроек ревизии.

Если реестр или репозиторий с Docker-образом не являются публичными, необходимо указать в настройках ревизии сервисный аккаунт, у которого есть права на скачивание Docker-образа. Например, роль container-registry.images.puller на каталог или реестр, в которых находится Docker-образ.

Если в настройках ревизии указан сервисный аккаунт, у пользователя или сервисного аккаунта, от имени которого создается ревизия, должна быть роль iam.serviceAccounts.user. Она подтверждает права на использование сервисного аккаунта.

Режим работы контейнера

Serverless Containers поддерживает следующие режимы работы контейнера:

Режим работы Описание работы Что возвращается при успешном вызове контейнера Данные HTTP-запроса к контейнеру Ограничения
HTTP-сервер HTTP-запросы к контейнеру принимает HTTP-сервер, который должен быть запущен на порту из переменной окружения PORT. Значение переменной задается сервисом автоматически HTTP-ответ, полученный от HTTP-сервера. При передаче в контейнер некоторые HTTP-заголовки ответа изменяются Передаются в HTTP-запросе к HTTP-серверу —
Выполнение команд При каждом HTTP-запросе к контейнеру выполняются инструкции ENTRYPOINT из Dockerfile или команды, заданные при создании ревизии. Если команды заданы, они переопределяют инструкции ENTRYPOINT из Dockerfile Код ответа 200 и код завершения в заголовке ответа X-Task-Exit-Code Находятся в файле по пути из переменной окружения REQUEST_PATH Количество одновременных вызовов одного экземпляра контейнера не может быть больше 1

Масштабирование контейнера

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

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

Настройки масштабирования применяются в течение 5 минут после их задания.

Подготовленные экземпляры

Подготовленный экземпляр — это экземпляр контейнера, при запуске которого гарантированно нет холодного старта. В подготовленном экземпляре до вызова контейнера:

  • инициализируются компоненты среды выполнения Serverless Containers;
  • загружается и инициализируется пользовательское приложение.

Время простоя подготовленных экземпляров и выполнения в них контейнера тарифицируется дополнительно.

Если количество вызовов контейнера превышает количество подготовленных экземпляров, Serverless Containers масштабирует контейнер в пределах квот, но в неподготовленных экземплярах при их первом запуске происходит холодный старт.

Подготовленные экземпляры расходуют следующие квоты, даже если не запущены:

  • Количество экземпляров контейнеров в каждой зоне доступности.
  • Суммарный объем RAM для всех запущенных экземпляров контейнеров в каждой зоне доступности.
  • Количество подготовленных экземпляров контейнеров в одном облаке.

Примеры использования

См. также

Предыдущая
Обзор
Следующая
Вызов контейнера