用途
该技能用于帮助用户将 Sitecore Marketplace 应用部署到 Vercel,并确保配置正确的 CSP 头与相关设置。它是一份带操作步骤的部署指南型技能。
主要能力
技能覆盖从部署前检查到部署后配置的完整流程:
-
部署前检查清单:
- 本地构建成功(
npm run build)。 - CSP 头已配置——检查
next.config.ts中的frame-ancestors,需包含:headers: [ { source: "/(.*)", headers: [ { key: "Content-Security-Policy", value: "frame-ancestors 'self' https://*.sitecorecloud.io", }, ], }, ] - 环境变量已设置——检查
.env.local是否存在且包含必需的值。 - 扩展点已注册——应用中定义的所有路由都应在 Developer Portal 中注册。
- 本地构建成功(
-
部署步骤:
- 安装 Vercel CLI(如需要):
npm i -g vercel - 链接到 Vercel 项目:
vercel link - 设置环境变量:
- 客户端应用:
vercel env add NEXT_PUBLIC_SITECORE_APP_ID - 全栈(Auth0)应用,需额外添加:
vercel env add AUTH0_SECRET vercel env add AUTH0_BASE_URL vercel env add AUTH0_ISSUER_BASE_URL vercel env add AUTH0_CLIENT_ID vercel env add AUTH0_CLIENT_SECRET vercel env add AUTH0_AUDIENCE vercel env add AUTH0_SCOPE
- 客户端应用:
- 部署:
- 预览部署:
vercel - 生产部署:
vercel --prod
- 预览部署:
- 部署后配置:
- 从 Vercel 复制生产 URL。
- 前往 Sitecore Developer Portal → Your App → Settings,将 App URL 设置为 Vercel 生产 URL。
- 如果使用 Auth0,在 Vercel 中更新
AUTH0_BASE_URL环境变量以匹配生产 URL。
- 安装 Vercel CLI(如需要):
使用方式
该技能以步骤指导的形式执行,并强调:此技能具有真实副作用(部署到生产环境),因此每一步执行前都需要与用户确认。
适用场景
适用于需要将 Sitecore Marketplace 应用(包括客户端应用与使用 Auth0 的全栈应用)部署到 Vercel,并需要正确配置 CSP 头、环境变量以及 Developer Portal 中应用地址的场景。
限制
技能资料未提供关于定价、平台限制、部署配额或具体错误处理的更多信息,暂未提供。参考文件部分提到 Vercel 配置——vercel.json 与 next.config.ts 模板,但资料中未提供模板内容。