Sitecoreイメージ参照

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

このページの翻訳は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 tagthree-digit tagtwo-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>

以下は、タグの例とそれに続く内訳です。

RequestResponse
10.4.0.004346.337-10.4.17763.1339-ltsc2022
RequestResponse
<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>

次にタグの例を示します。

RequestResponse
10.4.0-ltsc2022

2 桁のタグ:

<Sitecore major + minor version>-<OS name>

次にタグの例を示します。

RequestResponse
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>

以下は、タグの例とそれに続く内訳です。

RequestResponse
14.4.0.00368.71-10.4.17763.1339-1809
RequestResponse
<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>

次にタグの例を示します。

RequestResponse
14.4.0-1809

2 桁のタグ:

<module major + minor version>-<OS name>

RequestResponse
14.4-1809

タグの選択

OSのバージョン

異なるOSタグ ( 10.0.0-ltsc201910.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コマンドでこのほとんどを実行できます。

RequestResponse
docker-compose -f docker-compose.yml pull

このコマンドは、最新のSitecoreとTraefikのベース イメージをプルします。ただし、ビルド目的で使用するイメージ (モジュールやツールのアセット イメージなど) はプルされません。残念ながら、Docker Composeの問題/制限により、現在docker-compose build --pullは不可能であるため、そのようなイメージを個別に(docker pullを使用して)プルするか、これらに完全なタグを使用する必要があります。

最新のイメージをプルするのを忘れがちなため、通常はこれらのコマンドを自動化します。これを行うには、CIビルド スクリプトまたはローカル開発用のカスタムupスクリプトに追加します。

何かフィードバックはありますか?

この記事を改善するための提案がある場合は、