← Cloudflare Workers / workers / ci-cd / builds

Конфигурация

При подключении Git-репозитория к вашему Worker можно настроить параметры, необходимые для его сборки и развертывания.

Когда коммит отправляется в подключенный репозиторий, Workers Builds выполняет процесс из двух этапов:

1. Команда сборки (необязательно) - компилирует ваш проект (например, npm run build для фреймворков, таких как Next.js или Astro)
2. Команда развертывания - Разворачивает ваш Worker в Cloudflare (по умолчанию npx wrangler deploy)

Для предварительных сборок (коммитов в ветки, отличные от продакшен-ветки) команда развёртывания заменяется на команда развёртывания предпросмотра (по умолчанию: npx wrangler versions upload), которая создаёт предварительную версию без продвижения в продакшен.

Настройки сборки можно найти в разделе Настройки > Build внутри вашего Worker.

Обратите внимание, что при обновлении и сохранении настроек сборки они будут применены к далее сборки. Когда вы повторить сборку, будут применены конфигурации сборки, существовавшие на момент повторного запуска.

Команду деплоя можно выполнить с помощью любого удобного пакетного менеджера.

Если вы добавили команду развертывания Wrangler в качестве скрипта в package.json, тогда вы можете запустить его, указав в качестве команды развёртывания. Например, npm run deploy.

Примеры других команд развёртывания, которые можно задать:

Команда развёртывания для ветки, отличной от production, применяется только в том случае, если у вас включена функция сборки непродакшен-веток.

По умолчанию: npx wrangler versions upload, создавая URL предпросмотра. Как и команды build и deploy, её можно настроить на выполнение произвольной команды.

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

Если в репозитории нет файла конфигурации Wrangler, команда развёртывания (wrangler deploy) запустит автоматическая настройка проекта. Это определяет ваш фреймворк, создаёт необходимую конфигурацию и открывает pull request для проверки. После того как вы смержите PR, ваш проект будет настроен, и последующие сборки будут развёртываться в обычном режиме.

API-токен в Workers Builds определяет доступ, предоставляемый Workers Builds для взаимодействия с ресурсами вашего аккаунта. В настоящее время поддерживаются только пользовательские токены, поддержка токенов уровня аккаунта появится позже.

Если вы выбираете Создать новый токен, будет автоматически создан новый API токен со следующими разрешениями:

• Аккаунт: Account Settings (read), Workers Scripts (edit), Workers KV Storage (edit), Workers R2 Storage (edit)
• Зона: Workers Routes (edit) for all zones on the account
• Пользователь: User Details (read), Memberships (read)

Разрешения этого API токена можно настроить, перейдя в My Profile > API-токены для пользовательских токенов.

Рекомендуется всегда использовать один и тот же API-токен для всех загрузок и развёртываний Worker, чтобы права доступа оставались неизменными.

Static Assets и фреймворки теперь поддерживаются в Cloudflare Workers. Узнайте, как настроить проекты Workers и команды для каждого фреймворка, в руководствах по фреймворкам:

• Развертывание существующего проекта
• Веб-приложения
  • React + Vite
  • Astro
  • React Router (ранее Remix)
  • Next.js
  • Адаптер OpenNext
  • Vue
  • RedwoodSDK
  • TanStack Start
  • Микрофронтенды
  • SvelteKit
  • Vike
  • Больше руководств...
    • Analog
    • Angular
    • Docusaurus
    • Gatsby
    • Hono
    • Nuxt
    • Qwik
    • Solid
    • Waku
• Мобильные приложения
  • Expo
• API
  • FastAPI
  • Hono
• ИИ и агенты
  • Agents SDK
  • LangChain

Для сборки можно указать пользовательские переменные окружения.

{
	"$schema": "./node_modules/wrangler/config-schema.json",
	"name": "my-worker-dev",
	"vars": {
		"API_HOST": "example.com",
		"API_ACCOUNT_ID": "example_user",
		"SERVICE_X_DATA": {
			"URL": "service-x-api.dev.example",
			"MY_ID": 123
		}
	}
}

"$schema" = "./node_modules/wrangler/config-schema.json"
name = "my-worker-dev"

[vars]
API_HOST = "example.com"
API_ACCOUNT_ID = "example_user"

  [vars.SERVICE_X_DATA]
  URL = "service-x-api.dev.example"
  MY_ID = 123

По умолчанию внедряются следующие системные переменные окружения (их можно переопределить):