1. コンテナへのテナントサービスのインストール

チュートリアル: DockerのSitecoreにテナント サービス モジュールを追加する

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

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

Dockerを使用して、Sitecore Data Exchange Framework (DEF) テナント サービス (TS) モジュールをコンテナ環境に追加できます。このチュートリアルでは、次の方法について説明します。

  • インストール ファイルを準備します。

  • テナント サービス コンテナをデプロイします。

  • プラグインをテナントサービスコンテナにデプロイします(オプション)。

インストール ファイルを準備する

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

  1. Sitecoreのダウンロード ページからDEF-TSコンテナ デプロイメント パッケージをダウンロードします。フォルダ構造をそのままにして、ローカルワークステーションに抽出します。

  2. DEF-TSコンテナデプロイメントパッケージを抽出したフォルダに移動します。使用しているWindowsのバージョンとトポロジのフォルダ ( def-ts\compose\ltsc2019\xp1など) を見つけます。

  3. tenant-service.override.ymlファイルをSitecoreコンテナー デプロイメントcompose\<version>\<topology> フォルダー (docker.compose.ymlファイルと同じ場所) にコピーします。

  4. フォルダ内の .env-exampleファイルをエディタで開きます。次に、ファイルの内容の例を示します。

    #The host for the Tenant Service website, for example, <topology-to-deploy>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=<...>

  5. ファイル内のすべての変数をクリップボードにコピーします。

  6. ローカル マシンのSitecoreコンテナー デプロイ フォルダーで、エディターで .envファイルを開き、DEF-TS .env-exampleファイルの変数を貼り付けます。

  7. .envファイルを保存します。

テナント サービス コンテナをデプロイする

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

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

  1. テナント サービスのHTTPS/TLS証明書を追加します。詳細な手順については、Sitecoreダウンロード サイトで入手できるInstallation Guide for Developer Workstation with Containersを参照してください。

  2. Windowsコンソールで、tenant-service.override.ymlファイルが含まれているフォルダーに移動します。次のコマンドを実行します。

    docker-compose -f docker-compose.yml -f docker-compose.override.yml -f tenant-service.override.yml up --detach

  3. テナント サービスが実行されているかどうかをテストするには、ブラウザを開き、https://<topology>ts.localhostに移動します。

  4. 検索インデックスを更新するには、SitecoreのURLを参照します (例: https://xp1cm.localhost/)。コントロールパネルを開き、Populate Solr Managed Schemaをクリックします。SitecoreがSolrスキーマに入力したら、Indexing Managerをクリックし、再構築するインデックスを選択して、Rebuildをクリックします。

  5. Sitecoreコンテンツ管理コンテナーで、DEFテナントを作成し、テナントをアップグレードします。

  6. DEFテナントで、DEFテナント サービス エンドポイントを作成します。DEFテナントとDEFテナント サービス エンドポイントを有効にします。

  7. DEFテナントからDEFテナントIDをコピーし、.envファイルにSITECORE_TENANT_ID変数の値として貼り付けます。

  8. 管理者権限でPowerShellウィンドウを開き、ローカルのデプロイ フォルダーに移動します。

  9. すべてのコンテナを更新するには、次のコマンドを実行します。

    Docker-compose -f docker-compose.yml -f docker-compose.override.yml -f tenant-service.override.yml up –detach

  10. テナントが使用可能かどうかをテストするには、ブラウザーを開き、https://<topology>.localhost/api/tenantを参照します。

メモ

接続文字列の追加やWeb設定ファイルの変更など、Sitecoreデプロイメントに対する一部の変更では、設定ファイルを変更するために設定変換を使用する必要があります。設定変換を適用する方法については、Sitecoreを参照してください。

プラグインをテナントサービスコンテナにデプロイする

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

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

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

    docker-compose ps

  2. 次のコマンドを実行して、TSコンテナを停止します。

    docker stop <container name>

  3. 次のコマンドを実行してプラグインを追加します。

    docker cp <source path> <container name>:"c:/inetpub/wwwroot"
    手記

    <source path> をプラグインを含むフォルダーへのパスに置き換えます。

  4. 次のコマンドを実行して、TSコンテナを再度起動します。

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