← Cloudflare Workers / workers / ci-cd / builds

Konfigurace

Při propojování repozitáře Git s vaším Workerem můžete přizpůsobit konfiguraci potřebnou k sestavení a nasazení Workeru.

Když je commit odeslán do vašeho propojeného repozitáře, Workers Builds spustí dvoukrokový proces:

1. Příkaz sestavení (optional) : zkompiluje váš projekt (například npm run build pro frameworky jako Next.js nebo Astro)
2. Příkaz pro nasazení - Nasadí váš Worker do Cloudflare (výchozí je npx wrangler deploy)

U náhledových sestavení (commitů do jiných větví, než je vaše produkční větev) se příkaz deploy nahrazuje příkaz pro nasazení náhledu (výchozí hodnota je npx wrangler versions upload), což vytvoří náhledovou verzi bez jejího povýšení do produkce.

Nastavení sestavení najdete v části Nastavení > Sestavit v rámci vašeho Workeru.

Mějte na paměti, že po aktualizaci a uložení nastavení sestavení se tato aktualizovaná nastavení použijí na vaše další build. Když opakovat sestavení, použijí se konfigurace sestavení, které existují v okamžiku opakování sestavení.

Příkaz pro nasazení můžete spustit pomocí správce balíčků dle vlastního výběru.

Pokud jste přidali příkaz Wrangler deploy jako skript v package.json, pak jej můžete spustit tak, že jej nastavíte jako svůj deploy command. Například npm run deploy.

Mezi další příkazy pro nasazení, které můžete nastavit, patří:

Příkaz pro nasazení neprodukční větve lze použít pouze v případě, že jste povolili sestavení neprodukčních větví.

Výchozí hodnota je npx wrangler versions upload, což vytvoří URL náhledu. Podobně jako příkazy build a deploy lze i tento upravit tak, aby místo toho spouštěl cokoli jiného.

Mezi další příkazy pro nasazení neprodukčních větví, které můžete nastavit, patří:

Pokud váš repozitář neobsahuje konfigurační soubor Wrangler, příkaz pro nasazení (wrangler deploy) spustí automatická konfigurace projektu. Tím se detekuje váš framework, vytvoří se potřebná konfigurace a otevře se pull request ke kontrole. Jakmile PR sloučíte, váš projekt je nakonfigurován a další buildy se budou nasazovat běžným způsobem.

Token API ve Workers Builds určuje přístup, který má Workers Builds k interakci se zdroji vašeho účtu. V současnosti jsou podporovány pouze uživatelské tokeny, podpora tokenů vlastněných účtem se chystá.

Když vyberete Vytvoření nového tokenu, automaticky se vytvoří nový token API s následujícími oprávněními:

• Účet: Account Settings (read), Workers Scripts (edit), Workers KV Storage (edit), Workers R2 Storage (edit)
• Zóna: Workers Routes (edit) for all zones on the account
• Uživatel: User Details (read), Memberships (read)

Oprávnění tohoto API tokenu můžete nakonfigurovat přechodem na My Profile > API Tokens pro uživatelské tokeny.

Doporučuje se používat stále stejný API token pro všechna nahrání a nasazení Workeru, aby byla zachována konzistentní oprávnění přístupu.

Statické prostředky a frameworky jsou nyní v Cloudflare Workers podporovány. Postup nastavení projektů Workers a příkazy pro jednotlivé frameworky najdete v příručkách k jednotlivým frameworkům:

• Nasaďte existující projekt
• Webové aplikace
  • React + Vite
  • Astro
  • React Router (dříve Remix)
  • Next.js
  • adaptér OpenNext
  • Vue
  • RedwoodSDK
  • TanStack Start
  • Mikrofrontendy
  • SvelteKit
  • Vike
  • Další příručky...
    • Analog
    • Angular
    • Docusaurus
    • Gatsby
    • Hono
    • Nuxt
    • Qwik
    • Solid
    • Waku
• Mobilní aplikace
  • Expo
• API
  • FastAPI
  • Hono
• AI a agenti
  • Agents SDK
  • LangChain

Svému sestavení můžete poskytnout vlastní proměnné prostředí.

{
	"$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

Následující proměnné systémového prostředí se ve výchozím nastavení vkládají automaticky (lze je ale přepsat):