SuperAPI AI 工具集

marketplace-deploy

部署与运维

查看项目

更新于 10-16 02:14

技能介绍

用途

该技能用于帮助用户将 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 中注册。
  • 部署步骤:

    1. 安装 Vercel CLI(如需要):npm i -g vercel
    2. 链接到 Vercel 项目:vercel link
    3. 设置环境变量:
      • 客户端应用: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
        
    4. 部署:
      • 预览部署:vercel
      • 生产部署:vercel --prod
    5. 部署后配置:
      • 从 Vercel 复制生产 URL。
      • 前往 Sitecore Developer Portal → Your App → Settings,将 App URL 设置为 Vercel 生产 URL。
      • 如果使用 Auth0,在 Vercel 中更新 AUTH0_BASE_URL 环境变量以匹配生产 URL。

使用方式

该技能以步骤指导的形式执行,并强调:此技能具有真实副作用(部署到生产环境),因此每一步执行前都需要与用户确认。

适用场景

适用于需要将 Sitecore Marketplace 应用(包括客户端应用与使用 Auth0 的全栈应用)部署到 Vercel,并需要正确配置 CSP 头、环境变量以及 Developer Portal 中应用地址的场景。

限制

技能资料未提供关于定价、平台限制、部署配额或具体错误处理的更多信息,暂未提供。参考文件部分提到 Vercel 配置——vercel.json 与 next.config.ts 模板,但资料中未提供模板内容。