← Sandbox SDK / sandbox / guides

Разверните приложение Sandbox

Песочница выполняется на Containers. О командах развертывания, Workers Builds и флагах rollout см. Развертывание Containers и Развёртывания.

Чтобы поместить exposePort() на пользовательском домене см. Настройте preview URL на собственном домене.

Worker зависит от @cloudflare/sandbox (или @cloudflare/sandbox@next). Образ контейнера должен принадлежать той же ветке релизов (Dockerfile и теги базового образа из шаблона или документации для этой версии).

При обновлении версии пакета npm:

1. Обновите Dockerfile или ссылку на образ для той же строки.

2. Запустите wrangler deploy чтобы новый образ был опубликован.

3. Если Worker и образ контейнера нужно переключить одновременно, разверните их с немедленным rollout:

   npmyarnpnpm

   npx wrangler deploy --containers-rollout=immediate

   Используйте это для stable до @next переключений и других несовместимых пар package/image. См. Миграция и Развёртывания.

Не смешивайте stable-пакет с @next образ, или наоборот.

1. Запустите Docker, если image это путь к Dockerfile. Ссылки на образы из реестра не требуют Docker на этапе развертывания.

2. Из корня проекта:

   npmyarnpnpm

   npx wrangler deploy

3. Убедитесь, что URL Worker отвечает, а затем проверьте маршрут песочницы.

Первое развёртывание может занять несколько минут, пока подготавливается образ.

В продакшене используйте wrangler deploy чтобы пакет и образ можно было обновлять вместе.

В непроизводственной среде Workers Builds по умолчанию используется wrangler versions upload, который не публикует новый образ. Preview URLs не создаются для таких Workers (они реализуют Durable Objects). Тестируйте с помощью wrangler dev, либо со staging-Worker, либо окружение который запускает wrangler deploy.

Подробнее: Перед выходом в продакшен.

• Развертывание Containers
• Развёртывания
• Настройте preview URL на собственном домене
• Переход на предварительную версию Sandbox SDK 1.0