导航|地址|刷新
Configuration

Skip to contentDocumentation Index
Fetch the complete documentation index at: https://developers.cloudflare.com/workers/llms.txt
Use this file to discover all available pages before exploring further.



DocsDirectoryAPISDKsChangelog

Search

Log in






Workers

/




Overview


Getting started


CLI

Dashboard

Prompting

Templates





Examples

Tutorials


Best practices


Workers Best Practices






Demos and architectures


Overview

Build an Interactive ChatGPT App






Local development


Overview

Environment variables and secrets

Vite Plugin ↗

Choosing between Wrangler & Vite

Developing with multiple Workers

Adding local data

Supported bindings per development mode

Local Explorer

Share a local dev server





Playground


Configuration


Overview


Workers Sites


Overview

Start from existing

Start from scratch

Start from Worker

Workers Sites configuration





Bindings ↗

Compatibility dates

Compatibility flags

Cron Triggers

Environment variables


Integrations


Overview

APIs

External Services





Multipart upload metadata

Page Rules

PlacementBeta


Routes and domains


Overview

Custom Domains

Routes

workers.dev





Secrets






Versions & deployments


Overview

Deployment management

Preview URLs


Gradual deployments


Overview

Version affinity

With Durable Objects





Version overrides

Rollbacks






CI/CD


Overview


Builds


Overview

Configuration

Automatic pull requests


Git integration


Overview

GitHub integration

GitLab integration





Build image

Build caching

Build branches

Build watch paths

Deploy Hooks

Advanced setups

Event subscriptions

Troubleshooting builds

Builds API reference

Limits & pricing

MCP serverMCP






External CI/CD


Overview

GitHub Actions

GitLab CI/CD










Workers Cache


Overview

Configuration

Cache keys

Purging the cache

Examples

Debugging

Limitations






Runtime APIs


Overview


Remote-procedure call (RPC)


Overview

Lifecycle

Reserved Methods

Visibility and Security Model

TypeScript

Error handling






WebAssembly (Wasm)


Overview

Wasm in JavaScript






Bindings (env)


Overview

AI ↗

Analytics Engine ↗

Assets ↗

Browser Run ↗

D1 ↗

Dispatcher (Workers for Platforms) ↗

Durable Objects ↗

Dynamic Worker Loaders

Environment Variables ↗

Hyperdrive ↗

Images ↗

KV ↗

Media Transformations ↗

mTLS

Queues ↗

R2 ↗

Rate Limiting

Secrets ↗

Secrets Store ↗Beta


Service bindings


Overview

HTTP

RPC (WorkerEntrypoint)





Stream ↗

Vectorize ↗

Version metadataBeta

Workflows ↗





Cache

Console

Context (ctx)

Encoding

EventSource

Fetch


Handlers


Overview

Alarm Handler ↗

Email Handler ↗

Fetch Handler

Queue Handler ↗

Scheduled Handler

Tail Handler





Headers

HTMLRewriter

MessageChannel


Node.js compatibility


Overview

assert

AsyncLocalStorage

Buffer

crypto

Diagnostics Channel

dns

EventEmitter

fs

http

https

net

path

process

Streams

StringDecoder

test

timers

tls

url

util

zlib





Performance and timers

Request

Response

Scheduler


Streams


Overview

ReadableStream

ReadableStream BYOBReader

ReadableStream DefaultReader

TransformStream

WritableStream

WritableStream DefaultWriter





TCP sockets

Web Crypto

Web standards

WebSockets






Static Assets


Overview

Get Started

Configuration and Bindings


Routing


Full-stack application

Single Page Application (SPA)

Static Site Generation (SSG) and custom 404 pages

Worker script


Advanced


Gradual rollouts ↗

HTML handling

Serving a subdirectory









Headers

Redirects

Direct Uploads

Billing and Limitations


Migration Guides


Migrate from Pages to Workers

Migrate from Netlify to Workers

Migrate from Vercel to Workers










Framework guides


Deploy an existing project


Web applications


React + Vite

Astro

React Router (formerly Remix)

Next.js

Vue

RedwoodSDK

TanStack Start

Microfrontends

SvelteKit

Vike


More guides...


Analog

Angular

Docusaurus

Gatsby

Hono

Nuxt

Qwik

SolidBeta

Waku










Mobile applications


Expo






APIs


FastAPI ↗

Hono ↗






AI & agents


Agents SDK ↗

LangChain ↗










Databases


Connect to databases

Analytics Engine ↗

Vectorize (vector database) ↗

Cloudflare D1 ↗

Hyperdrive ↗


3rd Party Integrations


Overview

Neon

PlanetScale

Supabase

Turso

Upstash

Xata










Testing


Overview


Vitest integration


Overview

Write your first test

Recipes and examples

Configuration

Test APIs

Isolation and concurrency

Debugging

Known issues


Migration guides


Migrate from Vitest 3 to Vitest 4

Migrate from Miniflare 2's test environments

Migrate from unstable_dev










Integration test harness


Overview

Get started

Configure the test harness

Prepare test state

Interact with Workers

Integrations






Miniflare


Overview

Get Started

Writing tests


Core


Compatibility Dates

Fetch Events

Modules

Multiple Workers

Queues

Scheduled Events

Variables and Secrets

Web Standards

WebSockets






Developing


Attaching a Debugger

Live Reload






Migrations


Migrating from Version 2






Storage


Cache

D1

Durable Objects

KV

R2









Wrangler's unstable_startWorker()






Observability


Overview

Metrics and analytics


Logs


Overview

Workers Logs

Real-time logs

Tail Workers

Workers Logpush






TracesBeta


Overview

Custom spansBeta

Spans and attributes

Known limitations






DevTools


Overview

Breakpoints

Profiling CPU usage

Profiling Memory





Query Builder


Exporting OpenTelemetry Data


Overview

Export to Honeycomb

Export to Grafana Cloud

Export to Axiom

Export to Sentry

Export to PostHog





MCP serverMCP

Errors and exceptions


Integrations


Sentry





Source maps and stack traces






Wrangler


Overview

Install/Update Wrangler


Migrations


Migrate from Wrangler v3 to v4

Migrate from Wrangler v2 to v3


Migrate from Wrangler v1 to v2



Wrangler v1 (legacy)


Overview

Install / Update

Authentication

Commands

Configuration

Webpack





1. Migrate webpack projects

2. Update to Wrangler v2









API


Commands


Overview

Workers

General commands

Artifacts

Browser

Certificates

Containers

D1

Flagship

Hyperdrive

KV

Pages

Pipelines

Queues

R2

Secrets Store

Tunnel

Vectorize

VPC

Workers for Platforms

Workflows





Authentication profiles

Bundling

Configuration

Custom builds

Deprecations

Environments

System environment variables






Vite plugin


Overview

Get started

Tutorial - React SPA with an API


Reference


API

Static Assets

Debugging

Migrating from wrangler dev

Secrets

Vite Environments

Cloudflare Environments

Non-JavaScript modules

Programmatic configuration










Languages


Overview


JavaScript


Overview

Examples ↗






TypeScript


Overview

Examples ↗






Python WorkersBeta


Overview

The Basics

How Python Workers Work

Foreign Function Interface (FFI)

Standard Library

Examples


Packages


Overview

FastAPI

Langchain










RustBeta


Overview

Supported crates










Platform


Overview

Pricing


Changelog


Overview

Workers (Historic)

Wrangler





Limits

Choose a data or storage product

Betas

Deploy to Cloudflare buttons

Claim deployments (temporary accounts)

Built with Cloudflare button

Known issues

Workers for Platforms ↗

Infrastructure as Code (IaC)





Glossary


Reference


How the Cache works

How Workers works

Migrate from Service Workers to ES Modules

Protocols

Security model






Agent resources


Agent setup ↗

Cloudflare Skills ↗

Code Mode MCP Server ↗

Domain-specific MCP Servers ↗MCP

Workers llms.txt ↗

Workers llms-full.txt ↗

Cloudflare Docs llms.txt ↗

Cloudflare Docs llms-full.txt ↗













Home

/Workers

/…
CI/CD


/Builds

/Configuration



Configuration


Last updated Jul 3, 2026|Copy as Markdown|View as Markdown|Agent setup

OverviewHow Workers Builds worksBuild settings Overview Deploy command Non-production branch deploy command Automatic configuration for new projects API tokenFramework supportEnvironment variables Default variables




When connecting your Git repository to your Worker, you can customize the configurations needed to build and deploy your Worker.


How Workers Builds works


When a commit is pushed to your connected repository, Workers Builds runs a two-step process:

Build command(optional) - Compiles your project (for example, npm run build for frameworks like Next.js or Astro)

Deploy command - Deploys your Worker to Cloudflare (defaults to npx wrangler deploy)

For preview builds (commits to branches other than your production branch), the deploy command is replaced with a preview deploy command (defaults to npx wrangler versions upload), which creates a preview version without promoting it to production.


Build settings


Build settings can be found by navigating to Settings > Build within your Worker.

Note that when you update and save build settings, the updated settings will be applied to your next build. When you retry a build, the build configurations that exist when the build is retried will be applied.


Overview

Setting	Description
Git account	Select the Git account you would like to use. After the initial connection, you can continue to use this Git account for future projects.
Git repository	Choose the Git repository you would like to connect your Worker to.
Git branch	Select the branch you would like Cloudflare to listen to for new commits. This will be defaulted to main.
Build command(Optional)	Set a build command if your project requires a build step (e.g. npm run build). This is necessary, for example, when using a front-end framework such as Next.js or Remix.
Deploy command	The deploy command lets you set the specific Wrangler command used to deploy your Worker. Your deploy command will default to npx wrangler deploy but you may customize this command. Workers Builds will use the Wrangler version set in your package json.
Non-production branch deploy command	Set a command to run when executing a build for commit on a non-production branch. This will default to npx wrangler versions upload but you may customize this command. Workers Builds will use the Wrangler version set in your package json.
Root directory(Optional)	Specify the path to your project. The root directory defines where the build command will be run and can be helpful in monorepos to isolate a specific project within the repository for builds.
API token(Optional)	The API token is used to authenticate your build request and authorize the upload and deployment of your Worker to Cloudflare. By default, Cloudflare will automatically generate an API token for your account when using Workers Builds, and continue to use this API token for all subsequent builds. Alternatively, you can create your own API token, or select one that you already own.
Build variables and secrets(Optional)	Add environment variables and secrets accessible only to your build. Build variables will not be accessible at runtime. If you would like to configure runtime variables you can do so in Settings > Variables & Secrets

Note


Currently, Workers Builds does not honor the configurations set in Custom Builds within your Wrangler configuration file.


…(内容过长已截断)

------
导航页 打开网址