b2c-code

B2C Code Skill

b2c CLI を使用して、Salesforce B2C Commerce インスタンス上のコードバージョンをデプロイ、ダウンロード、管理します。

ヒント： b2c がグローバルにインストールされていない場合は、代わりに npx @salesforce/b2c-cli を使用してください（例：npx @salesforce/b2c-cli code deploy）。

MCP 相当の機能

カートリッジのアップロードには cartridge_deploy を優先して使用してください。必要に応じて codeVersion を明示的に設定します。files では、検出されたカートリッジ内にある projectDirectory からの相対パスで、ローカルファイルを最大 100 個（合計 64 MiB）選択できます。カートリッジ全体を対象にする場合は、files を省略します。一致するリモートファイルは上書きされ、選択ファイルモードでは他のファイルが保持されます。reload で対象を有効化できる場合があります。リロードに失敗した場合も、アップロードの成功結果と警告は保持してください。コードモードの builtin/code-version-inspect は、有効化中のバージョンとロールバックバージョン、および有効化メタデータを読み取ります。builtin/site-cartridge-inspect は、サイトのカートリッジ順序を読み取り、想定される名前を確認します。SCAPI の dx/scripts/v1 はバージョン管理を提供し、site/sites/v1 はサイトパスを管理します。監視、再帰的なダウンロード、追加のデプロイフラグには CLI を使用してください。

設定と認証

CLI は、SFCC_* 環境変数（プロジェクトの .env を含む）、選択されているプロジェクトローカルまたは共有の dw.json、および設定プラグインから、対象インスタンスと認証情報を自動検出します。package.json から取得されるのは、機密情報を含まないデフォルト値のみです。--server、--client-id、--client-secret、--username、--password などのフラグは通常不要です。自動検出された値を上書きする場合にのみ指定してください。

b2c setup inspect を実行すると、解決された設定と、各値の取得元を確認できます（スクリプトで使用する場合は --json を指定してください。シークレットはデフォルトでマスクされます）。優先順位のルールとトラブルシューティングについては、b2c-cli:b2c-config スキルを参照してください。

例

カートリッジをデプロイする

# deploy all cartridges from current directory
b2c code deploy

# deploy cartridges from a specific directory
b2c code deploy ./my-cartridges

# deploy to a specific server and code version
b2c code deploy --server my-sandbox.demandware.net --code-version v1

# deploy and reload (re-activate) the code version
b2c code deploy --reload

# delete existing cartridges before upload and reload
b2c code deploy --delete --reload

# deploy only specific cartridges
b2c code deploy -c app_storefront_base -c plugin_applepay

# exclude specific cartridges from deployment
b2c code deploy -x test_cartridge

カートリッジをダウンロードする

# download all cartridges from the active code version
b2c code download

# download to a specific directory
b2c code download -o ./downloaded

# download from a specific server and code version
b2c code download --server my-sandbox.demandware.net --code-version v1

# download only specific cartridges
b2c code download -c app_storefront_base -c plugin_applepay

# exclude specific cartridges from download
b2c code download -x test_cartridge

# mirror: extract to local cartridge project locations
b2c code download --mirror

変更を監視する

# watch cartridges and upload changes automatically
b2c code watch

# watch a specific directory
b2c code watch ./my-cartridges

# watch with specific server and code version
b2c code watch --server my-sandbox.demandware.net --code-version v1

# watch only specific cartridges
b2c code watch -c app_storefront_base

# watch excluding specific cartridges
b2c code watch -x test_cartridge

コードバージョンを一覧表示する

# list code versions on the instance
b2c code list

# list with JSON output
b2c code list --json

コードバージョンを有効化する

# activate a code version
b2c code activate <version-name>

# reload (re-activate) the current code version
b2c code activate --reload

注： 有効化は冪等です。バージョンがすでに有効な場合、コマンドは変更を加えずに成功します。有効なバージョンにコードをアップロードした場合、またはカスタム API を変更した場合は、エンドポイントを更新して登録するため、デプロイまたは有効化時に --reload を使用してください。登録状況は b2c-cli:b2c-scapi-custom スキルで確認できます。

コードバージョンを削除する

# delete a code version
b2c code delete <version-name>

API バックエンド

code list、code activate、code delete、および code deploy における有効バージョンの検出／有効化／リロードの手順は、SCAPI 経由で実行されます。shortCode、tenantId、および sfcc.scripts／sfcc.scripts.rw スコープを設定すれば、そのまま使用できます。読み取りスコープ（sfcc.scripts）は code list と検出に必要です。書き込みスコープ（sfcc.scripts.rw）は、有効化、削除、リロード、およびデプロイ時の --activate／--reload フラグに必要です。

code deploy（ファイルのアップロード自体）、code download、および code watch は常に WebDAV を使用します。SCAPI を使用するのは、周辺のコードバージョン操作のみです。

OCAPI は非推奨であり、新しいインスタンスでは無効になっています。--api-backend auto（デフォルト）は、安全な SCAPI の機能／認証／リクエスト拒否時に OCAPI Data API へフォールバックします。必要に応じて --api-backend scapi|ocapi でバックエンドを指定してください。--reload フラグは、選択されたバックエンドを使用して activate(alternate) + activate(target) を実行し、コードキャッシュのリロードを強制します。そのため、SCAPI が設定されていれば OCAPI が無効なインスタンスでも機能します。

その他のコマンド

code トピックで使用できるコマンドとオプションの一覧については、b2c code --help を参照してください。

注： b2c code deploy はカートリッジの コード をインスタンスにアップロードします。サイトで有効な カートリッジ（カートリッジパス）を管理するには、b2c sites cartridges コマンドについて b2c-cli:b2c-sites スキルを参照してください。

関連スキル

• b2c-cli:b2c-sites - サイトのカートリッジパスを管理します（有効なカートリッジの一覧表示、追加、削除、設定）
• b2c-cli:b2c-scapi-custom - デプロイ後にカスタム API の登録状況を確認します
• b2c-cli:b2c-webdav - 低レベルのファイル操作（カートリッジの削除、ファイルの一覧表示）
• b2c:b2c-custom-api-development - カスタム API エンドポイントの作成