Sitecoreイメージ参照
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
このトピックでは、Sitecore Container Registry (SCR)、scr.sitecore.comで見つけるイメージと、それらをカスタム ソリューションで使用する方法に関する追加情報を提供します。
Sitecore Container Registryの参照
利用可能なイメージ リポジトリとタグのリストは、GitHubのSitecore Dockerイメージ リポジトリにあります。
リポジトリの名前空間
Sitecoreイメージ リポジトリは、名前空間を使用してSitecore Container Registryに整理されています。
命名戦略
Sitecoreでは、画像を区別するためにいくつかの命名規則を利用しています。
-
アセット画像
モジュールなどの特定のイメージは、カスタムSitecoreイメージ ビルド中のソースとしてのみ意図されており、実行時に使用することはありません。これらのasset imagesには、-assetsサフィックスが付いた名前が付けられます。次に、イメージの例を示します。
-
spe-assets
-
sitecore-management-services-xm1-assets
-
sxa-xp1-assets
-
sitecore-docker-tools-assets
-
-
位相幾何学
特定のイメージはトポロジに固有です。この場合、トポロジ (-xp0、-xp1、または -xm1) が名前に含まれます。イメージの名前にトポロジが含まれていない場合、そのイメージはトポロジに依存しません。次に、イメージの例を示します。
-
sitecore-xp0-cm
-
sitecore-xp1-cortexreporting
-
jss-xm1-assets
-
タグ付け戦略
すべてのSitecoreイメージは、full tag、three-digit tag、two-digit tagで構成されるタグ付けシステムを使用しています。一般に、タグの最初の部分はSitecoreまたはモジュール バージョンを表し、残りの部分は、それが構築されているベースMicrosoftイメージに関する詳細を提供します。
Sitecoreでは、latestタグがあいまいすぎて、通常、Microsoftやその他のOSベースのイメージが後に続かないため、タグは使用しません。
プラットフォームイメージ
プラットフォーム イメージには、Sitecore Experience Platform (scr.sitecore.com/sxp) の基本イメージが含まれます。Sitecoreプラットフォーム バージョンは、タグの最初の部分を構成します。
フルタグ:
<Sitecore version>.<Sitecore revision>.<Sitecore build>-<Windows version>.<Windows revision>-<OS name>
以下は、タグの例とそれに続く内訳です。
10.4.0.004346.337-10.4.17763.1339-ltsc2022
<Sitecore version>.<Sitecore revision>.<Sitecore build>-<Windows version>.<Windows revision>-<OS name>
\________________/ \_________________/ \______________/ \_______________/ \________________/ \_______/
| | | | | |
10.4.0 004346 337 10.4.17763 1339 ltsc2019
3 桁のタグ:
<Sitecore version>-<OS name>
次にタグの例を示します。
10.4.0-ltsc2022
2 桁のタグ:
<Sitecore major + minor version>-<OS name>
次にタグの例を示します。
10.4-ltsc2022
モジュールとツール
これには、Sitecore Experience Platform(scr.sitecore.com/sxp/modules)や一般ツール(scr.sitecore.com/tools)のモジュールなどの画像が含まれます。
モジュールとツールには、プラットフォームと一致するバージョンがない場合があります。モジュールまたはツールがプラットフォームのバージョンと一致しnot場合は、Sitecoreナレッジベースで互換性マトリックスを提供します。
フルタグ:
<module version>.<module revision>.<module build>-<Windows version>.<Windows revision>-<OS name>
以下は、タグの例とそれに続く内訳です。
14.4.0.00368.71-10.4.17763.1339-1809
<module version>.<module revision>.<module build>-<Windows version>.<Windows revision>-<OS name>
\______________/ \_______________/ \____________/ \_______________/ \________________/ \_______/
| | | | | |
14.4.0 00368 71 10.4.17763 1339 1809
3 桁のタグ:
<module version>-<OS name>
次にタグの例を示します。
14.4.0-1809
2 桁のタグ:
<module major + minor version>-<OS name>
14.4-1809
タグの選択
OSのバージョン
異なるOSタグ ( 10.0.0-ltsc2019と10.0.0-1909など) を選択する場合は、Microsoftイメージを選択するときと同じルールに従います。Windowsでは、ホストOSのバージョンがコンテナーのOSバージョンと一致する必要があります。新しいWindowsビルドに基づいてコンテナーを実行する場合は、同等のホスト ビルドがあることを確認してください。それ以外の場合は、Hyper-V分離を使用して、新しいホスト ビルドで古いコンテナーを実行できます。
Windowsコンテナバージョンの互換性の詳細については、Microsoftのドキュメントを参照してください。
アセットイメージでは、これらのイメージは実行されないため、これは問題になりません。通常、使用可能なOSタグは1つだけです。
フル タグと短いタグ
完全なタグは、正確なイメージ バージョンにロックします。
3桁と2桁のタグを使用すると、よりダイナミックになり、最新の画像バージョンをプルできます。メインバージョン( <Sitecore version>など)のみをロックし、残りのバージョン( <Sitecore revision>、<Sitecore build>、<Windows revision>など)は最新のバージョンを使用できるようにします。
完全なタグを使用するか、短いタグを使用するかは、ビルドとリリースのプロセス、および必要なイメージ バージョンをどの程度制御するかによって異なります。たとえば、開発目的で短いタグを使用し、デプロイのために完全なタグに移行する場合があります。常に最新の画像が必要な場合は、全体に短いタグを使用します。
Sitecoreがコンテナとその不変イメージを維持する方法の性質上、コンテナ イメージを作成するときは2桁のタグを使用するのがベスト プラクティスです。これにより、最新のSitecoreコンテナーが確保され、最新の更新も自動的に取得されます。
最新の画像を取り込む
Sitecoreイメージのショート タグを使用すると、Dockerはイメージ ダイジェスト (不変のSHA256ベースの識別子) をプル時にキャッシュし、イメージを削除するかイメージを明示的にプルするまで使用し続けます。必要なときに最新のイメージをプルする必要があります (たとえば、ローカル開発環境やCI環境の場合)。
Docker Composeの推奨セットアップでは、オーバーライドを除き、docker-compose pullコマンドでこのほとんどを実行できます。
docker-compose -f docker-compose.yml pull
このコマンドは、最新のSitecoreとTraefikのベース イメージをプルします。ただし、ビルド目的で使用するイメージ (モジュールやツールのアセット イメージなど) はプルされません。残念ながら、Docker Composeの問題/制限により、現在docker-compose build --pullは不可能であるため、そのようなイメージを個別に(docker pullを使用して)プルするか、これらに完全なタグを使用する必要があります。
最新のイメージをプルするのを忘れがちなため、通常はこれらのコマンドを自動化します。これを行うには、CIビルド スクリプトまたはローカル開発用のカスタムupスクリプトに追加します。