Cloudflare Artifacts 在 Cloudflare 内提供与 Git 兼容的存储。Workers Builds 可以直接从 Artifacts 仓库构建并部署 Worker。
借助 Artifacts 和 Workers Builds，你可以在 Cloudflare 内托管源代码、运行构建、使用 Worker Previews 测试更改，并部署 Worker。
你的 Cloudflare 账户角色必须包含 Artifacts Read 和 Artifacts Edit 权限。仓库必须包含构建和部署 Worker 所需的源代码和项目配置。
在将项目连接到 Workers Builds 之前，请先将项目推送到仓库。你可以连接空仓库，但第一次构建会失败，因为没有可构建的内容。推送一次提交即可开始新的构建。
-
在 Cloudflare 仪表板中，前往 Workers & Pages。
前往 Workers & Pages ↗ -
选择 Create application（创建应用程序） > Continue with Artifacts（继续使用 Artifacts）。
-
选择包含仓库的 namespace。
-
选择包含项目的仓库。
-
检查项目名称、部署命令和 Preview command（预览命令）。
-
（可选）如果项目需要构建步骤，请输入构建命令。
-
（可选）在 Advanced settings（高级设置） 下，如果项目不在仓库根目录，请设置 Path（路径）。
-
选择 Deploy（部署）。
开始之前，请将现有 Worker 的源代码和配置推送到 Artifacts。连接现有 Worker 不会从已部署的 Worker 复制其原始源代码。
-
在 Cloudflare 仪表板中，前往 Workers & Pages。
前往 Workers & Pages ↗ -
选择要连接的 Worker。
-
前往 Settings（设置） > Builds（构建）。
-
选择 Connect（连接）。
-
在 Git connection（Git 连接） 下拉菜单中，选择包含仓库的 Artifacts namespace。
-
选择仓库。
-
检查构建命令、部署命令和 Preview command（预览命令）。确认 Wrangler 配置指向现有 Worker。
-
（可选）在 Advanced settings（高级设置） 下，如果项目不在仓库根目录，请设置 Path（路径）。
-
保存连接。
-
向仓库推送提交以开始构建。
向生产分支推送会运行已配置的构建和部署命令。Artifacts 集成仅支持将 main 作为生产分支。默认部署命令 npx wrangler deploy 会将更改部署到生产环境。
要在生产前测试更改，请在 Cloudflare 仪表板中打开 Worker。前往 Settings（设置） > Builds（构建），选择 Previews Base，然后打开 Builds for Preview branches（为 Preview 分支构建）。更多信息请参阅 Preview 构建。向非生产分支推送会运行 Preview command（预览命令），默认为 npx wrangler preview。构建成功后，会在 Worker 的 Previews 部分创建或更新分支 Preview URL。
要更改仓库或源提供商，请断开 Workers Builds 连接并创建新连接。断开仓库后，现有部署会继续提供流量。
有关构建设置和环境变量，请参阅 Workers Builds 配置。