marketplace-deploy について
marketplace-deployは、Sitecore MarketplaceアプリをVercelにデプロイするスキルです。ビルドや設定の確認からデプロイ後のURL設定まで案内し、本番環境に影響する操作の前に確認を求めます。
主な機能
- 01ローカルビルドの検証
- 02CSPと環境変数の確認
- 03拡張ポイント登録の確認
- 04Vercelプロジェクトの連携とデプロイ
- 05デプロイ後のSitecore設定
活用シーン
- 01Sitecore MarketplaceアプリのVercelデプロイ準備
- 02デプロイ前の必須設定の確認
- 03プレビュー版または本番版のデプロイ
- 04Sitecore 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 へのデプロイをユーザーに案内します。
重要:このスキルには実際の副作用(本番環境へのデプロイ)があります。実行する前に、各手順についてユーザーに確認してください。
デプロイ前のチェックリスト
デプロイする前に、以下を確認してください。
- ローカルでビルドが成功する:
npm run build
- 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",
},
],
},
]
-
環境変数が設定されている —
.env.localが存在し、必要な値が設定されていることを確認します。 -
拡張ポイントが登録されている — アプリで定義されているすべてのルートが 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:デプロイ後の設定
デプロイ後:
- Vercel から本番環境の URL をコピーします
- Sitecore Developer Portal → Your App → Settings に移動します
- App URL に Vercel の本番環境 URL を設定します
- Vercel の
AUTH0_BASE_URL環境変数を本番環境の URL に合わせて更新します(Auth0 を使用している場合)
参考ファイル
- Vercel の設定 — vercel.json と next.config.ts のテンプレート
コメント
Markdown 対応