攻略 KubernetesサービスでSitecoreにSFMCBDEを追加する方法
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
Salesforceマーケティングクラウド行動データ交換(SFMCBDE)コネクタのSitecore Connectは、テナントサービスの有無にかかわらず、Azure Kubernetesサービス(AKS)に追加できます。
マーケティング自動化のアクティビティやSitecore同期のアクティビティを使う場合は、テナントサービスと一緒にSFMCBDEを展開する必要があります。
このウォークスルーでは、以下の方法を説明します:
- イメージを作成し、それをAzureにプッシュします。
- 展開用のファイルやフォルダを準備してください。
- コンテナはkubectlコマンドで展開します。
- Solrインデックスを更新してください。
!注AKSでSFMCBDEをサポートしているトポロジーはXP1のみです。 XM1トポロジーはサポートされていません。
イメージを構築してAzureにプッシュします
SFMCBDE用のイメージを構築してAzureにプッシュするには:
-
Walkthrough: Preparing to Installation SFMC Behavioral Data Exchange in a container environment(ウォークスルー)で説明されている通り、SFMCBDEのイメージを構築してください。
-
テナントサービスを設置する場合は、web.configファイルの以下の値をインストール用のテナントサービスのURLで更新してください:
詳細については、Sitecoreのドキュメントをご覧ください。
-
テナントサービスをインストールする場合は、「 Walkthrough: Install SFMC Behavioral Data Exchange in Docker with the Tenant Service」で説明されている通り、SFMCBDEテナントサービスのイメージを構築してください。
-
Windowsコンソールを開き、docker tagコマンドを使って画像にタグ付けします。例えば:
docker tag sfmcce/sitecore-xp1-cm
.1.0.005207.643-10.0.17763.1757-ltsc2019 $registry/modules/sitecore-sfmcbde-xp1-cm -
コンソールでdocker pushコマンドを使って画像をAzureレジストリにプッシュしてください。例えば:
docker push $registry/modules/sitecore-sfmcbde-xp1-cm
展開のためのファイルやフォルダの準備
インストール内のファイルやフォルダをデプロイ用に準備するには:
-
テナントサービスをインストールしていない場合は、SitecoreのダウンロードページからSFMCBDEコンテナデプロイメントパッケージをダウンロードしてください。テナントサービスをインストールする場合は、SFMCBDE-TSコンテナデプロイメントパッケージをダウンロードしてください。選択したパッケージをローカルワークステーションのフォルダに展開してください。
-
例えばSFMCBDE\k8s\
フォルダに移動してください。 SFMCBDE\k8s\ltsc2019。 overridesサブフォルダをSitecore Experience Platform(SXP)コンテナデプロイメントパッケージフォルダk8s\ ( xp1フォルダと同じレベル)にコピーします。 -
SXPコンテナデプロイメントパッケージのoverrides\xp1とoverrides\xp1\secretsフォルダの各フォルダで、kustomization.yamlファイルを見つけます。各ファイルで、インストールに適したフォルダ名(例えば../../xp1)でbasesパラメータを更新します。
!注basesパラメータは、kustomization.yamlファイルが上書きする元のSitecoreコンテナ展開ファイルの配置を示します。
-
overrides\xp1\secretsフォルダのsitecore-salesforce-bde-connection-string.txtファイルで、Walkthroughで作成した接続文字列に置き換えてください
準備。
残りの手続きは、テナントサービスを設置するかどうかによります。
テナントサービスを設置していない場合:
- 各 kustomization.yaml ファイルの images: セクションで、 newName と newTag パラメータを、 m、xdbcollection、 xdbsearch、 xdbsearchworker、 xdbautomationworker 画像の値をAzureレジストリに更新してください。
- Sitecoreコンテナデプロイメントパッケージで overrides\xp1\kustomization.yaml ファイルを開いて、 cd と id イメージを削除します。
テナントサービスを設置する場合:
- テナントサービスの設定を準備してください。この方法については、Azure Kubernetes Sitecoreダウンロードページの「データ交換テナントWeb ServiceのI個停止ガイド」の「*サービスにテナントサービスを追加」セクションの「サービスにテナントサービスを追加Sitecore」*セクションをご覧ください。
- SFMCBDE-TSコンテナデプロイメントパッケージを抽出したフォルダで、例えば TenantService.SFMCBDE\k8s\
フォルダに移動してください。 TenantService.SFMCBDE\k8s\ltsc2019。 overrides サブフォルダの内容をSitecore Experience Platform(SXP)コンテナデプロイメントパッケージフォルダにコピーします。 k8s\ \overrides\xp1。もしターゲット overrides フォルダにすでにファイルが存在している場合は、新しいコンテンツで更新してください。 - SXPコンテナデプロイメントパッケージの各フォルダの overrides\xp1 と overrides\xp1\secrets フォルダで、 kustomization.yaml ファイルを見つけてください。kustomization.yamlの各ファイルの images: セクションで、 newName と newTag パラメータを、 cm、 cd、 id、 xdbcollection、 xdbsearch、 xdbsearchworker、 xdbautomationworker、 tenantservice イメージの値をAzureレジストリにプッシュした値を更新してください。
- overrides\xp1\secretsフォルダで、Sitecore Identity ServerのクライアントIDとクライアントシークレットを含むsitecore-tenant-connection-string.txtファイルを更新してください。
!注Sitecoreでテナントを作成した後、patch-ts.yamlファイルのTENANT_SERVICE_CONFIG_EXECUTE_URL変数にあるテナントサービスのエンドポイントIDを更新できます。これを行う場合は、テナントサービスを再デプロイする必要があります。
コンテナを展開してください
AKSクラスタの設定を準備し、イングレスコントローラを展開します。この方法については、Sitecoreのダウンロードページで入手可能な「Installation Guide for Production Environment for Production Environment for Kubernetes」をご覧ください。
コンテナと必要なKubernetesコンポーネントを展開するには:
-
Windowsコンソールを開き、XP1と オーバーライド フォルダが入っているフォルダに移動します。
-
秘密を展開する。次のコマンドを使ってください:
kubectl apply -k ./overrides/xp1/secrets/
-
externalフォルダを実行してください。次のコマンドを使ってください:
kubectl apply -k ./xp1/external/
-
すべてのコンテナにステータスOk/Runningがつくまで待ちます。このコマンドでステータスを確認できます:
kubectl get pods -o wide
-
initフォルダを実行してください。次のコマンドを使ってください:
kubectl apply -k ./overrides/xp1/init/
-
すべてのコンテナにステータスCompletedがつくまで待ちます。このコマンドでステータスを確認できます:
kubectl get pods
-
永続的ボリュームを作成するには、次のコマンドを実行します:
kubectl apply -f ./xp1/volumes/azurefile
-
SitecoreコンテナをSFMCBDEの変更で実行してください。以下のコマンドを使ってください:
kubectl apply -k ./overrides/xp1/
-
すべてのコンテナにステータスOk/Runningがつくまで待ちます。 kubectl get podsコマンドでステータスを確認できます。
-
ローカルホストファイルを更新してください。この方法については、Sitecoreのダウンロードページにある「 Installation Guide for Production Environment for Production Environment for Kubernetes」をご覧ください。
コンテナが展開されたら、検索インデックスを再構築してください。