SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场deployment

deployment

部署与运维

查看项目

更新于 10-16 05:57

技能介绍

用途

该技能面向 Astro v6 + Cloudflare Workers 项目的部署工作流，适用于：为新项目配置部署、通过 Workers Builds 连接 GitHub 仓库实现推送即部署、部署到预览或生产环境、部署后调试 500 错误 / 构建失败 / wrangler 问题、更新依赖并检查兼容性、以及原本正常的部署开始失败时排查原因。

主要能力

  • 部署流程：以 Workers Builds 为主要 CI/CD 方式，提供 GitHub 推送即部署与自动预览 URL。每个拉取请求会生成独立的预览部署 URL，构建状态以 GitHub check run 显示，无需单独的分支环境。支持通过监控路径配置实现单仓库多站点只重建相关站点。
  • CLI 备用流程：当未配置 Workers Builds 时，可使用 npx wrangler deploy --dry-run（测试部署）、npx wrangler deploy（部署）、npx wrangler tail（实时日志）、npx wrangler rollback（回滚上次部署）。
  • 部署前关键检查：包括禁止使用 context.locals.runtime.env（Astro v6 已移除，改用 import { env } from "cloudflare:workers"）、服务器代码中禁止 process.env、Worker 名称必须与 Cloudflare Dashboard 中完全一致、通过 "overrides": { "vite": "^7" } 防止 Vite 8 被提升、Node.js 22+、启用 nodejs_compat 标志、构建后校验 dist/_worker.js/ 与 dist/client/ 存在。
  • 阻塞条件分层：Tier 1 为部署阻塞（构建失败、名称不匹配、Vite 版本、Node 版本、TypeScript 错误、缺少构建产物、密钥泄露、缺少 nodejs_compat）；Tier 2 为运行时崩溃（locals.runtime、process.env、环境变量/密钥缺失、依赖兼容性）；Tier 3 为质量项（Lighthouse、表单、预览索引、客户确认）。需按 Tier 1 → 2 → 3 顺序修复。
  • 500 错误调试：Astro v6 的 astro dev 运行在真实 workerd 运行时，本地正常则线上 500 多为环境变量/密钥问题。提供症状到成因与修复的对照表，建议从 npx wrangler tail 入手。
  • 密钥安全规则：本地仅使用 .dev.vars，生产使用 Dashboard 或 wrangler secret put，wrangler.jsonc 只写 secrets.required 中的名称不写值。提供一组部署前密钥泄露检测命令（gitignore、wrangler 配置、源码硬编码、console 日志、客户端环境变量泄露、git 跟踪），任一 FAIL 则阻止部署。
  • Astro v6 服务器端模式：环境变量正确写法、Astro Actions 类型安全表单处理（内置 Zod 4，从 astro/zod 导入）、按需启用 SSR 端点（export const prerender = false）、Sessions 通过 Workers KV 实现多步表单状态持久化。
  • 依赖兼容性检查：强调不硬编码版本锁定，应查阅活跃来源（适配器 changelog、Workers changelog、兼容性标志、Wrangler releases、Vite releases、Resend / Brevo 的 Cloudflare 相关 issue、Astro Images 与 sitemap 等），仅在必要时锁定并附注释与 issue 链接，每两个月复查。邮件建议优先直接 fetch() 调用 Resend REST API。
  • MCP 集成：若已连接 GitHub 或 Cloudflare MCP，优先使用而非 CLI/手动检查。GitHub MCP 用于搜索依赖相关 issue、阅读适配器 changelog；Cloudflare MCP 用于部署前确认 Worker 名称、环境变量/密钥、DNS、Workers Builds 状态，部署后检查状态、日志与预览 URL。
  • 从 Pages 迁移：针对使用 fix-wrangler.mjs 的旧 Pages 站点，提供删除该脚本及相关 postbuild、升级适配器、替换为 Workers 配置模板、添加 nodejs_compat、重建 Worker、迁移环境变量/密钥、更新 DNS、测试并部署的步骤，预计每站点 15–30 分钟。

使用方式

技能包含参考文档：cloudflare-setup.md（CF Workers 初始设置 + Workers Builds）、troubleshooting.md（常见问题与修复）、wrangler-template.md（基础、KV、D1 配置模板）。初始化设置需在 Cloudflare Dashboard 中创建 Worker 并从 GitHub 导入仓库、选择分支、设置构建命令 npm run build 与部署命令 npx wrangler deploy、设置 NODE_VERSION=22。

适用场景

适用于使用 Astro v6 与 @astrojs/cloudflare v13 的站点，部署目标为 Cloudflare Workers（适配器已移除 Pages 支持）。静态资源由 Workers 提供免费且不限量，仅 SSR 请求计入配额。Astro v6 内置 Zod 4（import { z } from 'astro/zod'），无需额外安装依赖。

限制

资料未提供该技能的具体收费、价格或授权信息。依赖版本、兼容性标志与相关 issue 状态可能随时间变化，需以资料中列出的活跃来源为准。部署前的预生产检查（Lighthouse > 90、表单发送、GTM、链接、移动端真机测试、404 页面、法律页面、联系信息、客户确认、站点地图提交）仅在首次部署时执行。