Sitecore画像参照

プラットフォーム画像

プラットフォーム画像にはSitecore Experience Platformのベース画像が含まれています(scr.sitecore.com/sxp)。Sitecoreプラットフォームバージョンがタグの最初の部分を構成します。

フルタグ:

..-.-

以下は例タグの後に内訳を示します。

10.4.0.004346.337-10.4.17763.1339-ltsc2022

..-.- \________________/ \_________________/ \______________/ \_______________/ \________________/ \_______/ | | | | | | 10.4.0 004346 337 10.4.17763 1339 ltsc2019

3桁のタグ:

-

以下は例タグです:

10.4.0-ltsc2022

2桁のタグ:

<Sitecore major + minor version>-

以下は例タグです:

10.4-ltsc2022

モジュールとツール

これには、Sitecore Experience Platform用のモジュール(scr.sitecore.com/sxp/modules)や一般的なツール(scr.sitecore.com/tools)などのイメージが含まれます。

モジュールやツールはプラットフォームに適合しないバージョンを持っている場合があります。モジュールやツールがプラットフォームのバージョンに適合 しない場合は 、Sitecoreナレッジベースに互換性マトリックスを提供します。

フルタグ:

..-.-

以下は例タグの後に内訳を示します。

14.4.0.00368.71-10.4.17763.1339-1809

..-.- \______________/ \_______________/ \____________/ \_______________/ \________________/ \_______/ | | | | | | 14.4.0 00368 71 10.4.17763 1339 1809

3桁のタグ:

-

以下は例タグです:

14.4.0-1809

2桁のタグ:

<module major + minor version>-

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がコンテナとその不変画像を管理する方法の性質上、コンテナ画像を作成する際には2桁のタグを利用するのが最善の方法です。これにより、最新のSitecoreコンテナが確保され、最新のアップデートも自動的に受け取れます。

10.X-ltsc2019のような2桁のタグを使うと、次にプルやビルド時に画像が自動的に最新のフルリリースリビジョン(例

/sxp-pre/名前空間からのプレリリース・デルタイメージは、前のフルリリースの上に適用されるように設計されています。例えば、10.X.Y PREデルタは10.X.0リリースの上に使用されることを想定しています。Sitecoreが後に対応するフルリリース(10.X.Yリリース)を公開すると、2桁タグは自動的にそれに解決されます。DockerfileからPREデルタを削除していなければ、コンテナには新しいリリースのSitecore.configが表示され、新しいプロセッサタイプを参照されます。しかし、その場合はPREデルタの古いSitecore.Kernel.dllを参照し、そのタイプは含まれていません。これにより起動失敗が発生します:

System.InvalidOperationException: Could not find type 'Sitecore.Pipelines.FilterItem.ResolveModeFromContext, Sitecore.Kernel'

正式リリースにはすでにPREデルタのすべての修正が含まれているため、正式リリースが利用可能になった時点でデルタは不要になります。

これを解決するために、以下のいずれかの選択肢を選びます。

• フルリリースにアップグレードしてください — .envファイルからDELTA_ASSET_IMAGE_VERSIONエントリとPREデルタイメージに対応するDockerfile命令を削除してください。その後、キャッシュされたアセンブリが持ち込まれていないことを確認するためにdocker-compose build --no-cacheを使って再構築します。下の表で目標リリースに適した正しいSitecore.Kernel.dllバージョンを確認してください。
• 前のリリースに留 まり、3桁のタグ(例: 10.X.0-ltsc2019)を使って前のフルリリースにピン留めてください。PREデルタはこのバージョンと互換性があり、削除の必要はありません。

もし10.X.Yにアップグレードするなら、Sitecore Experience Platformダウンロードページから更新されたSitecoreContainerDeployment.10.X.Y.*ファイルもダウンロードしてください。古いデプロイファイルを使用すると、イメージが見つからないエラー(例:sitecore-idX