---
title: "アップグレードの準備をしてください"
slug: "prepare-for-the-upgrade"
abstract: ""
---
# アップグレードの準備をしてください

Sitecoreコンテナアップグレードプロセスを実行するには、以下の要件を準備する必要があります:

-   該当バージョンのSitecore XPの[Sitecoreコンテナデプロイメントパッケージ](https://developers.sitecore.com/downloads/Sitecore_Experience_Platform) をダウンロードして抽出してください。
    
    このパッケージには、各SitecoreトポロジーごとのSitecoreアップグレードDocker ComposeファイルおよびSitecore Kubernetes仕様ファイルが含まれています。
    
-   環境変数を指定します。
    
-   Sitecoreライセンスファイルを準備してください。
    
-   Sitecore XP 9.3.0から10.0.Xへアップグレードする場合:
    
    アップグレードするSitecoreインスタンスで、**Sitecore Launchpad**にアクセスし、**コントロールパネル**を選択し、**データベース** セクションで **「データベースのクリーンアップ**」を選択します。
    

## 環境変数

環境変数は、設定設定をSitecoreのアップグレードコンテナに渡すための優先的な仕組みです。

### Docker Composeの環境変数

Docker Composeの環境変数は環境変数の設定ファイル – upgrade.envに保存されます。Docker Compose起動時にこれらの変数を自動的に読み込みます。

Sitecoreのアップグレードコンテナを展開する前に、すべての環境変数に必要な値を指定する必要があります。

Dockerのenv変数の完全なリストおよび個別変数の詳細については、[付録C – 環境変数リスト](https://doc.sitecore.com/xp/ja/developers/105/guides/sitecore-xp-105-upgrade-container-deployment-guide/appendix-c---the-environment-variables-list.html "Appendix C - The environment variables list")をご覧ください。

> !重要すべての環境変数はupgrade.envファイルに収まらなければなりません。32,767文字の単一のブロック内です。変数の総サイズがこのサイズを超えると、新しい値を設定できず、データベースのアップグレードも成功しません。

複数の環境で環境変数を再利用するには、ホストWindows OS上で環境変数を設定し、Docker Composeで使われる環境変数の設定ファイルから対応するキーを削除することを検討してください。

### Kubernetes構成

SitecoreのアップグレードKubernetesデプロイメントでは、Kubernetesクラスタ内のコンテナで使用される文字列を安全に保存するためにシークレットを使用します。

シークレットはSQL Serverのユーザー名やパスワード、Sitecoreライセンスなどを保存するために使われます。

Kubernetesの構成には、アップグレードコンテナに必要なSQLサーバーアドレスやSitecoreデータベースのプレフィックスなどのConfigMap値も含まれています。

SitecoreアップグレードコンテナをKubernetesクラスタに展開する前に、設定テキストファイルのシークレットとConfigMapの値を必要なものに更新する必要があります。

秘密とConfigMap値の完全なリストについては、[付録B – Kubernetes秘密リスト](https://doc.sitecore.com/xp/ja/developers/105/guides/sitecore-xp-105-upgrade-container-deployment-guide/appendix-b---the-kubernetes-secrets-list.html "Appendix B - The Kubernetes secrets list")をご覧ください。

すべての秘密とConfigMap値を一つのコマンドで展開するKubectl kustomization.yamlファイルを提供しています。

### Sitecoreライセンスファイル

Sitecoreライセンスファイルは通常、環境変数としてエンコード文字列形式でコンテナインスタンスに渡されます。Sitecoreライセンスファイルは非常に大きいです。したがって、すべての環境変数に対してWindowsで許可されている最大サイズに適合するかを確認するために、圧縮およびBase64エンコードを行う必要があります。

ライセンスファイルを圧縮・エンコードした後、Docker環境変数設定ファイルに文字列値をコピーするか、アップグレードコンテナに選ぶオーケストレーターによってライセンス秘密テキストファイル( sitecore-license.txt )にコピーします。

[付録A – ライセンスファイルの圧縮とエンコーディングPowerShellヘルパー関数](https://doc.sitecore.com/xp/ja/developers/105/guides/sitecore-xp-105-upgrade-container-deployment-guide/appendix-a---license-file-compression-and-encoding-powershell-helper-function.html "Appendix A - License file compression and encoding PowerShell helper function") には、ライセンスファイルを環境変数で使用するためのBase64圧縮文字列に変換するサンプルPowerShellスクリプトが含まれています。