mcpField
M
marketplace-deploy

marketplace-deploy

github.com/vercel-labs云与 DevOps553 次安装29 周前更新
代码仓库

关于 marketplace-deploy

marketplace-deploy 是将 Sitecore Marketplace 应用部署到 Vercel 的技能，涵盖构建和配置检查、部署及部署后设置；执行会影响生产环境的操作前需确认。

主要功能

  1. 01验证本地构建
  2. 02检查 CSP 和环境变量
  3. 03检查扩展点注册
  4. 04关联 Vercel 项目并部署
  5. 05配置部署后的 Sitecore 设置

适用场景

  1. 01准备将 Sitecore Marketplace 应用部署到 Vercel
  2. 02检查部署前所需配置
  3. 03部署预览版或生产版本
  4. 04在 Sitecore Developer Portal 更新应用 URL

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/vercel-labs/sitecore-skills --skill marketplace-deploy

安装后在 Claude Code 中输入/marketplace-deploy确认已加载。

附带文件references/vercel-config.md

详细介绍

部署到 Vercel

你正在帮助用户将其 Sitecore Marketplace 应用部署到 Vercel。

重要：此操作会产生实际影响（部署到生产环境）。执行前，请逐步向用户确认。

部署前检查清单

部署前，请确认：

  1. 本地构建成功：
npm run build
  1. 已配置 CSP 标头 — 检查 next.config.ts 中的 frame-ancestors：
// next.config.ts must include:
headers: [
  {
    source: "/(.*)",
    headers: [
      {
        key: "Content-Security-Policy",
        value: "frame-ancestors 'self' https://*.sitecorecloud.io",
      },
    ],
  },
]

  1. 已设置环境变量 — 检查 .env.local 是否存在且包含必需的值

  2. 已注册扩展点 — 应用中定义的所有路由都应在 Developer Portal 中注册

部署步骤

步骤 1：安装 Vercel CLI（如有需要）
npm i -g vercel
步骤 2：关联 Vercel 项目
vercel link
步骤 3：设置环境变量
# For client-side apps
vercel env add NEXT_PUBLIC_SITECORE_APP_ID

# For full-stack (Auth0) apps — add all Auth0 vars too
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：部署
# Preview deployment
vercel

# Production deployment
vercel --prod
步骤 5：部署后配置

部署后：

  1. 从 Vercel 复制生产环境 URL
  2. 前往 Sitecore Developer Portal → Your App → Settings
  3. 将 App URL 设置为 Vercel 生产环境 URL
  4. 在 Vercel 中更新 AUTH0_BASE_URL 环境变量，使其与生产环境 URL 一致（如果使用 Auth0）

参考文件

评论

支持 Markdown