← Cloudflare Workers / workers / wrangler / commands

Containers

Работа с Containers с помощью Wrangler.

Соберите образ контейнера из файла Dockerfile.

wrangler containers build [PATH] [OPTIONS]

• PATH string необязательно
  • Путь к каталогу, содержащему Dockerfile для сборки.
• -t, --tag string обязательно
  • Имя и, при необходимости, тег (формат: "name:tag").
• --path-to-docker string необязательно
  • Путь к исполняемому файлу docker, если он отсутствует в $PATH.
  • По умолчанию: "docker"
• -p, --push boolean необязательно
  • Отправьте собранный образ в управляемый реестр Cloudflare.
  • По умолчанию: false

Удалить Container (приложение).

wrangler containers delete <CONTAINER_ID> [OPTIONS]

• CONTAINER_ID string обязательно
  • ID Container, который нужно удалить.

Выполняйте операции с образами в вашем реестре контейнеров.

Список образов в реестре контейнеров.

wrangler containers images list [OPTIONS]

• --filter string необязательно
  • Регулярное выражение для фильтрации результатов.
• --json boolean необязательно
  • Возвращает результат в виде корректного JSON.
  • По умолчанию: false

Удаление образа из реестра контейнеров.

wrangler containers images delete [IMAGE] [OPTIONS]

• IMAGE string обязательно
  • Изображение для удаления вида IMAGE:TAG

Настройте и просмотрите реестры, доступные вашему контейнеру. Подробнее о том, какие внешние реестры мы сейчас поддерживаем.

Список реестров, которые могут использовать ваши контейнеры.

wrangler containers registries list [OPTIONS]

• --json boolean необязательно
  • Возвращает результат в виде корректного JSON.
  • По умолчанию: false

Настройте новый реестр для вашего аккаунта.

wrangler containers registries configure [DOMAIN] [OPTIONS]

• DOMAIN string обязательно
  • Домен для настройки реестра.
• --dockerhub-username string необязательно
  • Имя пользователя Docker Hub для аутентификации. Используется с docker.io домен. Секрет представляет собой персональный токен доступа Docker Hub.
• --aws-access-key-id string необязательно
  • Идентификатор ключа доступа AWS, используемый для аутентификации. Применяется вместе с доменом Amazon ECR. При этом секретом служит соответствующий секретный ключ доступа AWS.
• --gar-email string необязательно
  • Email сервисного аккаунта Google для аутентификации. Используется с *-docker.pkg.dev домен.
• --secret-store-id string необязательно
  • ID хранилища секретов для хранения учетных данных реестра
• --secret-name string необязательно
  • Имя, под которым Wrangler должен сохранять учетные данные реестра

Флаги учётных данных являются взаимоисключающими. Используйте тот, который соответствует настраиваемому реестру.

В интерактивном режиме wrangler запросит у вас секрет и сохранит его в Secrets Store. Чтобы выполнить команду в неинтерактивном режиме, можно передать значение секрета в wrangler через stdin, и секрет будет создан автоматически.

Удаление конфигурации реестра из вашей учётной записи.

wrangler containers registries delete [DOMAIN] [OPTIONS]

• DOMAIN string обязательно
  • домен реестра для удаления

Генерирует временные учётные данные для отправки (push) или получения (pull) образов из управляемого реестра Cloudflare (registry.cloudflare.com).

wrangler containers registries credentials [OPTIONS]

• --push boolean необязательно
  • Сгенерируйте учётные данные с правом push.
• --pull boolean необязательно
  • Сгенерируйте учётные данные с правом pull.
• --expiration-minutes number необязательно
  • Как долго учётные данные должны оставаться действительными (в минутах).
  • По умолчанию: 15

Хотя бы один из --push или --pull должен быть указан.

Получить сведения об определённом Container: общие данные и список экземпляров.

wrangler containers info <CONTAINER_ID> [OPTIONS]

• CONTAINER_ID string обязательно
  • ID контейнера, о котором нужно получить информацию.

Получить список всех экземпляров Container для указанного приложения. Отображает ID экземпляра, имя, статус, местоположение, версию и время создания.

В интерактивном режиме результаты разбиваются на страницы. Нажмите Enter чтобы загрузить следующую страницу или Esc/q до остановки. В неинтерактивных средах (например, при перенаправлении вывода через pipe или запуске в CI) все страницы загружаются автоматически.

Используйте --json флаг, чтобы вывести результат в виде плоского массива JSON. Каждый элемент содержит поля id, name, state, location, version, а также created. Это также формат вывода по умолчанию в неинтерактивных средах.

wrangler containers instances <APPLICATION_ID> [OPTIONS]

• APPLICATION_ID string обязательно
  • UUID приложения, для которого нужно получить список экземпляров. Используйте wrangler containers list чтобы найти идентификаторы приложений.
• --per-page number необязательно
  • Количество экземпляров на странице.
  • По умолчанию: 25
• --json boolean необязательно
  • Возвращает результат в виде корректного JSON.
  • По умолчанию: false

Например, чтобы получить список экземпляров приложения:

wrangler containers instances 12345678-abcd-1234-abcd-123456789abc

INSTANCE                              NAME        STATE          LOCATION  VERSION  CREATED
a1b2c3d4-e5f6-7890-abcd-ef1234567890  worker-12   running        sfo06     3        2025-06-01T12:00:00Z
b2c3d4e5-f6a7-8901-bcde-f12345678901  worker-47   provisioning   iad01     2        2025-06-01T13:00:00Z

Чтобы получить те же данные в формате JSON:

wrangler containers instances 12345678-abcd-1234-abcd-123456789abc --json

[
	{
		"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
		"name": "worker-12",
		"state": "running",
		"location": "sfo06",
		"version": 3,
		"created": "2025-06-01T12:00:00Z"
	}
]

Список Containers в вашем аккаунте.

wrangler containers list [OPTIONS]

Отправьте образ с тегом в управляемый реестр Cloudflare, автоматически связанный с вашей учётной записью.

wrangler containers push [TAG] [OPTIONS]

• TAG string обязательно
  • Имя и тег отправляемого (push) образа контейнера.
• --path-to-docker string необязательно
  • Путь к исполняемому файлу docker, если он отсутствует в $PATH.
  • По умолчанию: "docker"

Подключитесь к запущенному экземпляру Container по SSH. См. SSH для получения сведений о конфигурации.

wrangler containers ssh <INSTANCE_ID>

Также вместо оболочки по умолчанию можно указать команду для запуска. Например:

wrangler containers ssh <INSTANCE_ID> -- ls -al

• INSTANCE_ID string обязательно
  • ID экземпляра Container, к которому выполняется подключение по SSH.