コンテナへのテナントサービスの導入

ウォークスルー

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

Dockerを使ってコンテナ環境にSitecore Data Exchange Framework(DEF)テナントサービス(TS)モジュールを追加できます。このウォークスルーでは以下の方法を説明します:

インストールファイルを準備してください。
テナントサービスコンテナを展開します。
Tenant Serviceコンテナにプラグインをデプロイします(任意)。

インストールファイルを準備してください

インストールに必要なファイルを準備するには:

SitecoreのダウンロードページからDEF-TSコンテナ展開パッケージをダウンロードしてください。フォルダ構造をそのままローカルワークステーションに展開してください。
DEF-TSコンテナデプロイメントパッケージを抽出したフォルダに行ってください。Windowsのバージョンとトポロジーのフォルダを探してください。例えばdef-ts\compose\ltsc2019\xp1。
tenant-service.override.ymlファイルをSitecoreコンテナデプロイメントcompose\\フォルダ(docker.compose.ymlファイルと同じ場所)にコピーしてください。
フォルダ内で、エディタで .env-exampleファイルを開きます。以下はファイルの内容の例です:

#The host for the Tenant Service website, for example, ts.localhost

TENANT_SERVICE_HOST=<...>

#The version tag for the Tenant service image MODULE_VERSION=<...>

#The Tenant Id after it is created in Sitecore SITECORE_TENANT_ID=<...>

#The Client Id of Sitecore Identity Server SITECORE_CLIENT_ID=<...>

#The Client Secret of Sitecore Identity Server SITECORE_CLIENT_SECRET=<...>
ファイル内のすべての変数をクリップボードにコピーします。
ローカルマシンのSitecoreコンテナデプロイメントフォルダで、エディタで .envファイルを開き、DEF-TSの .env-exampleファイルの変数を貼り付けます。
.envファイルを保存してください。

テナントサービスコンテナを展開する

インストールファイルを準備したら、DEF TSコンテナを展開する必要があります。

TSコンテナを展開するには:

テナントサービス用にHTTPS/TLS証明書を追加してください。詳細な手順については、Sitecoreダウンロードサイトにある「コンテナ付き開発者ワークステーションのインストールガイド」をご覧ください。
Windowsコンソールで、tenant-service.override.ymlファイルを含むフォルダへ行ってください。次のコマンドを実行します:

docker-compose -f docker-compose.yml -f docker-compose.override.yml -f tenant-service.override.yml up --detach
テナントサービスが稼働しているかどうかをテストするには、ブラウザを開き、https://ts.localhostに移動します。
検索インデックスを更新するには、Sitecore URL(例えばhttps://xp1cm.localhost/)にアクセスしてください。コントロールパネルを開き、「 **Solr Managed Schemaをポピュレート」**をクリックします。SitecoreがSolr Schemaを埋めた後、「 インデックスマネージャー」をクリックし、再構築するインデックスを選択し、「 再構築」をクリックします。
Sitecoreのコンテンツ管理コンテナでDEFテナントを作成し、テナントをアップグレードします。
DEFテナント内でDEFテナントサービスエンドポイントを作成します。DEFテナントとDEFテナントサービスエンドポイントを有効にします。
DEFテナントからDEFテナントのIDをコピーし、.envファイルにそれをSITECORE_TENANT_ID変数の値として貼り付けます。
管理者権限のあるPowerShellウィンドウを開き、ローカルのデプロイメントフォルダに移動します。
すべてのコンテナを更新するには、以下のコマンドを実行します:

Docker-compose -f docker-compose.yml -f docker-compose.override.yml -f tenant-service.override.yml up –detach
テナントが利用可能かどうかを確認するには、ブラウザを開き、https://.localhost/api/tenantをブラウズしてください。

!注Sitecoreのデプロイメントを変更する場合、接続文字列の追加やウェブ設定ファイルの変更など、設定変換を使う必要があります。設定変換の適用方法については、Sitecoreを参照してください。

Tenant Serviceコンテナにプラグインをデプロイします

例えばSalesforce CRM用のSitecore ConnectのようなコネクタモジュールでTSを使いたい場合は、そのコネクタ用のプラグインをデプロイする必要があります。

プラグインをTSコンテナにデプロイするには:

Windowsコンソールで、次のコマンドを実行してTSコンテナの名前を取得します:

docker-compose ps
TSコンテナを停止するには、次のコマンドを実行します:

docker stop
プラグインを追加するには、次のコマンドを実行します:

docker cp :"c:/inetpub/wwwroot"

!注をプラグインを含むフォルダへのパスに置き換えてください。
TSコンテナを再起動するには、次のコマンドを実行します:

docker start

この記事を改善するための提案がある場合は、お知らせください!