チュートリアル: Kubernetes 上での SCCH 4.0 から 5.0 へのアップグレード
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
このセクションでは、Kubernetes の Sitecore Connect for Content Hub (SCCH) コンテナーを 5.0 にアップグレードする方法について説明します。
SCCH コンテナーのバージョン 5.0 へのアップグレードを実行する前に、SCCH 4.0 を使用した Sitecore AKS 10.1 デプロイと、10.1 データベースの最新のバックアップが必要です。
このチュートリアルでは、次の方法について説明します。
-
mssql-upgrade イメージの構築とプッシュ
-
アップグレードの実行
mssql-upgrade イメージの構築とプッシュ
SCCH をアップグレードするには、mssql-upgrade イメージを構築する必要があります。これを行うには:
-
??? の mssql-upgrade イメージを構築するセクションの説明に従って、SCCH 用のイメージを構築します。
-
PowerShell ウィンドウで、Docker ファイルを含むフォルダーに移動し、イメージを構築してタグ付けします。次に例を示します。
RequestResponsedocker build . -t sitecore-scch-xp1-cm:<imageVersionTag> $registry/sitecore-scch-xp1-cm:<newTag>
-
Docker がイメージを作成したことを確認します。
-
作成したイメージを Azure レジストリにプッシュします。次に例を示します。
RequestResponsedocker push $registry/sitecore-scch-xp1-cm:<newTag>
アップグレードの実行
コンテナー イメージを構築したら、SCCH をアップグレードできます。
Sitecore 10.2 上で SCCH 5.0 にアップグレードするには:
-
Sitecore のダウンロード ページから Sitecore 10.2 Sitecore コンテナー デプロイ パッケージをダウンロードして展開します。フォルダー構造を維持したままローカルのワークステーションに展開します。
-
使用している Windows のバージョンとトポロジに対応したアップグレード フォルダー (例:
k8s\ltsc2019\upgrade\xp1
) に移動します。kustomization.yaml
ファイルで、以前に作成してプッシュしたカスタム mssql-upgrade イメージのnewName
とnewTag
を使用してイメージ セクションを更新します。 -
configuration
フォルダーで、シークレット ファイルを更新します。シークレット ファイルの詳細については、Sitecore のダウンロード ページにある「Kubernetes を使用した実稼働環境のインストール ガイド」を参照してください。 -
Sitecore のダウンロード ページから、SCCH コンテナー デプロイ 5.0 パッケージをダウンロードし、フォルダー構造を維持したままローカルのワークステーションに展開します。
SCCH\k8s\<windows version>\overrides
フォルダーをコピーし、SXP 10.2 のデプロイ構造内の\k8s\<windows version>\
フォルダーに貼り付けます。 -
SXP 10.2 構成内の
secrets
フォルダー (例:k8s\ltsc2019\overrides\xp1\secrets
) で次のシークレット ファイルを更新します。-
sitecore-cmp-content-hub.txt
-
sitecore-cmp-service-bus-entity-path-in.txt
-
sitecore-cmp-service-bus-entity-path-out.txt
-
sitecore-cmp-service-bus-subscription.txt
-
sitecore-dam-content-hub.txt
-
sitecore-dam-external-redirect-key.txt
-
sitecore-dam-search-page.txt
-
-
Azure CLI にログインし、サブスクリプションを設定します。
RequestResponseaz login az account set --subscription "Your Subscription"
-
AKS クラスターで作成された Kubernetes クラスターの資格情報を取得します。
RequestResponsezaks get-credentials --resource-group <10.1 resource group>--name <10.1 cluster>
-
Sitecore のアップグレード ジョブをデプロイするには、更新されたファイルがある フォルダー (例:
k8s\ltsc2019\upgrade\xp1
) に移動し、次のコマンドを実行します。RequestResponsekubectl apply -k .\
-
ジョブが完了したかどうかを確認するには、次のコマンドを実行します。
RequestResponsekubectl get pod
-
アップグレード プロセスが完了したら、Kubernetes のアップグレード ジョブとアップグレード シークレットを削除できます。コンソールで、手順 2 のアップグレード フォルダーに移動し、次のコマンドを実行します。
RequestResponsekubectl delete -f .\ kubectl delete -k .\
カスタム mssql-image を使用したアップグレードには、SCCH 5.0 がリソース ファイルの使用に移行したため、データベースからの SCCH アイテムのクリーンアップが含まれます。これには、Sitecore ロール インスタンス cm、xconnect、および xdbsearchworkerの再構築とアップグレードが必要です。
Sitecore ロール インスタンスを構築してデプロイする方法の詳細については、Sitecore ダウンロード ページの「Sitecore アップグレード コンテナー デプロイ ガイド」を参照してください。