導入
Experience Cloudサイト開発においてレンダリング速度に優れるLightning Web Runtime(LWR)が主流となる中、構築したサイトのリリースを支えるメタデータ構造も大きく進化しています。ここでCI/CD構築を担うエンジニアが最も注意すべきは、同じLWRサイトであっても、旧仕様の「非拡張LWRサイト(Auraサイトを含む)」と新仕様の「拡張LWRサイト」で、根底となるアーキテクチャが全く異なる点です。
本連載では、拡張LWRサイトのCI/CDパイプラインをゼロから構築・運用するための実践的なアプローチを解説します。
前編となる本記事では、すべての基礎となる最新のメタデータ構造(DigitalExperienceBundle)の全貌と、それをローカル環境へ正確に抽出するための構成管理について整理します。
【比較】メタデータモデルの進化:単一バンドルからモジュール化へ
サイトのデプロイを成功させるには、対象サイトが依存しているメタデータ型を正確に特定することが第一歩です。ここでは、旧アーキテクチャと新アーキテクチャのフォルダ構造を比較します。
【事実・仕様】従来の非拡張サイト(ExperienceBundle)
Winter ’23以前に作成された非拡張LWRサイト、およびすべてのAuraベースのサイトは、ExperienceBundle という単一のメタデータ型を中心に構成されています。ルートディレクトリ experiences/ 配下にサイトごとのフォルダが生成され、サイトのページやテーマ設定などが一元管理されます。
公式のメタデータAPI開発者ガイドに基づくと、ファイルシステム上の構造は以下のようになります。
experiences/
└ My_Customer_Site1/ <-- サイト名(API名)のフォルダ
├── brandingSets/ <-- カラーパレットやフォントなどのブランド定義
├── config/ <-- ゲストアクセス制御や多言語化などサイト全体の基本設定
├── routes/ <-- ページ単位のURLルーティングやアクセスレベル設定
├── themes/ <-- カスタムCSSやレイアウトテーマの構成定義
├── variations/ <-- 対象読者(Audience)に基づく動的な表示切り替え
└── views/ <-- ページのレイアウト領域と配置コンポーネントの定義
各サブフォルダ内には要素ごとの設定を保持するJSONファイルが格納され、これらすべてがサイト全体の「巨大な単一バンドル」としてデプロイ単位となります。
【事実・仕様】拡張LWRサイト(DigitalExperienceBundle)へのパラダイムシフト
Winter ’23以降に導入された「拡張LWRサイト」では、ExperienceBundle が非推奨となり、メタデータ構造が以下の2つに分離・細分化されました。
- DigitalExperienceBundle: サイトのページ、ルート、ビューなどを独立した「コンテンツアイテム」として管理するモジュール型のメタデータ。
- DigitalExperienceConfig: サイトのURLパスプレフィックスや表示ラベルなど、サイト全体の構成設定。
ファイルシステム上では digitalExperiences/site/ ディレクトリ配下に格納され、構造は以下のように変化します。
digitalExperiences/
└ site/ <-- ワークスペースタイプ
└ My_Customer_Site1/ <-- ワークスペース名(サイトのAPI名)
├─ sfdc_cms__route/ <-- コンテンツタイプ(ルート設定)
│ ├─ home/
│ │ ├─ _meta.json
│ │ └─ content.json
│ └─ login/
│ ├─ _meta.json
│ └─ content.json
├─ sfdc_cms__view/ <-- コンテンツタイプ(画面ビュー)
│ ├─ home/
│ │ ├─ _meta.json
│ │ └─ content.json
│ └─ login/
│ ├─ _meta.json
│ └─ content.json
└─ sfdc_cms__theme/ <-- コンテンツタイプ(テーマ設定)
└─ theme1/
├─ _meta.json
└─ content.json
【背景】新アーキテクチャへの移行理由と今後の展望
なぜSalesforceはメタデータ構造を根底から変更したのか、その背景と今後のスケジュールを整理します。
【見解・推測】新アーキテクチャ採用のトレードオフとエンジニアの判断基準
従来の ExperienceBundle はサイト全体を単一の塊として扱うため、特定のページだけをデプロイしたい場合(パーシャルデプロイメント)に、Gitなどのバージョン管理上で深刻なマージコンフリクトが発生しやすいという弱点がありました。DigitalExperienceBundle のようなモジュール化された構造への移行により、コンポーネント単位での細かいバージョン管理が可能になります。開発チームが複数人で同時並行にサイト改修を行うプロジェクトでは、拡張LWRサイトの構造を採用することで、競合解決にかかる運用コストを大幅に削減できます。
【事実・仕様】新規LWRサイトの拡張LWR専用化
Winter ’24リリース以降、新たに作成されるLWRサイトはすべて標準で「拡張LWRサイト」としてプロビジョニングされる仕様に変更されました。
現在、旧仕様である非拡張のLWRサイトを新規作成することはできません(Auraサイトは作成可能)。このプラットフォームの標準化は、今後のExperience Cloudのエコシステムが完全に拡張LWR(DigitalExperienceBundle)を前提として発展していくことを示しています。
【事実・仕様】強制アップグレードの撤回について
当初、Spring ’26リリースにて、既存の非拡張LWRサイトを新しい拡張LWRサイトへ強制的に自動アップグレードする予定が発表されていました。しかし、Summer ’25以降の公式リリースノートにおいてこの強制適用は撤回されています。
期日をもってシステム側で自動的に切り替わることはなくなりましたが、パーシャルデプロイメントや拡張CMSワークスペースなどの最新機能を利用するため、開発者任意のタイミングで拡張LWRサイトへアップグレードすることが引き続き強く推奨されています。
【実践】DigitalExperienceBundleの深層とUIの対応
CI/CDを設計するためには、ローカルに抽出されたファイル群が、実際のサイトのどの要素を指しているのかを理解する必要があります。
【事実・仕様】構成ファイル群の役割
DigitalExperienceBundle における各階層は以下のように定義されています。
- ワークスペースタイプ: データの種類を決定します。拡張LWRサイトの場合は
siteが指定されます。 - コンテンツタイプ: ワークスペース内のデータをカテゴリ分けします。以下の主要なタイプが存在します。
- ページのURLパスやアクセス権限を司る
sfdc_cms__route - レイアウトやコンポーネント構成を司る
sfdc_cms__view - ランディング設定を司る
sfdc_cms__brandingSet
- ページのURLパスやアクセス権限を司る
- コンテンツアイテム: 各フォルダに格納される単一の設定群(例:home, login)を指します。
各コンテンツアイテムは、主に以下の2ファイルで構成されます。
_meta.json: メタデータを定義するルーターの役割を果たし、コンテンツアイテムの配置場所(apiName)や親要素の階層関係(parentプロパティ)などを定義します。content.json: プロパティ設定など実際のデータを保持します。

【見解・推測】ビルダー操作とメタデータの対応関係
初心者がつまずきやすいのが、エクスペリエンスビルダー上のUI操作がどのファイルに影響を与えるかという点です。例えば、ビルダー上で「新規ページの追加」を行うと新しい sfdc_cms__view と sfdc_cms__route フォルダが生成され、「LWCコンポーネントの配置」を行うと該当ビューの content.json 内にプロパティ定義が追記されます。UIの変更とソースコードの差分(Git diff)を突き合わせる癖をつけることで、メタデータの構造理解が飛躍的に早まります。


【事実・仕様】抽出時の package.xml (マニフェスト) 記述例
この複雑な構造を漏れなくローカルに抽出(Retrieve)するため、マニフェストファイル(package.xml)には以下のように DigitalExperienceBundle と DigitalExperienceConfig を定義します。対象環境のAPIバージョンに合わせて <version> を指定します(例はAPIバージョン68.0)。
<?xml version="1.0" encoding="UTF-8"?>
<Package xmlns="[http://soap.sforce.com/2006/04/metadata](http://soap.sforce.com/2006/04/metadata)">
<!-- デプロイ対象を明示するため、特定の拡張LWRサイト名(ここでは My_Customer_Site1)を指定 -->
<types>
<members>My_Customer_Site1</members>
<name>DigitalExperienceBundle</name>
</types>
<types>
<members>My_Customer_Site1</members>
<name>DigitalExperienceConfig</name>
</types>
<version>68.0</version>
</Package>
【見解・推測】多言語対応サイトの運用における注意点
多言語対応サイトの場合、上記ファイルに加えて言語翻訳を表すバリアントJSONファイルが生成されます。ソース環境とターゲット環境間でこの翻訳JSONファイルに差分や欠損があると、デプロイ全体が即座にロールバックされる制約があります。そのため、Git上での完全な同期と、手動での一時的な変更を避ける運用ルールの徹底が必要です。
前編のまとめと後編の予告
- 【事実・仕様】: 拡張LWRサイトは、従来の
ExperienceBundleから脱却し、より細かい粒度で管理されるDigitalExperienceBundleおよびDigitalExperienceConfigへ移行しました。これらはsiteワークスペースとして、ビューやルートなどが明確に構造化されています。 - 【見解・推測】: このアーキテクチャの進化は、大規模なチーム開発におけるGitでのマージコンフリクトを低減させます。本記事で解説した
package.xmlを用いてメタデータを正確に抽出し、構成を把握することが、自動化への第一歩です。
後編では、この抽出したメタデータを基に、Salesforce CLI(sf v2)を用いた実際のCI/CDパイプラインの実装手順と、実運用で直面するデプロイ障害へのトラブルシューティングを解説します。
参考URL
DigitalExperienceBundle
DigitalExperienceBundle: Site Workspace Bundle and Folders
New LWR Sites Are Now Enhanced Only
Upgrade to Enhanced LWR Sites (Release Update)


読者の声