1. Docker イメージのビルド

ここでは Sitecore Experience Platform 9.3.0 を Docker に展開するための手順を紹介しています。 作業環境として便利な Git for Windows、GitHub Desktop および Visual Studio Code を事前にインストールしてください。

1.1. Docker 環境の構築

Windows 上で Docker を利用するための環境を設定していきます。まず Windows の環境において、Containers と Hyper-V の機能を有効にしてください。

Hyper-V を有効化 Containers を有効化

環境を仮想マシン上に展開する場合は、以下のように仮想マシン上で Hyper-V を利用できるように設定してください。

続いて、Docker for Windows をインストールします。インストールは以下のサイトからダウンロードをして実行してください。

ダウンロードしたファイルを実行すると、Docker のインストールが始まります。初期設定に関して、今回は Windows Container を利用することになるため、チェックしてください(インストール後変更は可能です)。

インストールの開始

ファイルのコピーなどが進みます。

ファイルのコピー

インストールが終了すると画面が切り替わります。はじめてインストールするときには、ユーザーの権限を有効にするために一度ログオフが求められます。

インストール完了

Windows のコンテナが有効になっているか確認をします。Switch to Linux .. と記載されている場合は、Windows が有効になっている形です。

Containers の設定を確認

PowerShell を起動して、docker -v のコマンドを実行します。

docker version

これで Docker の準備ができました。

1.2. Docker Images の準備

ここから先は、 https://dev.sitecore.net からモジュールのダウンロードが出来る権限、およびライセンスファイルが必要となります。

Docker の環境が整った次のステップとして、Github に公開されている Docker images リポジトリを活用します。

今回は Github Desktop を利用して、 c:projectsdocker-images のディレクトリにリポジトリのクローンを展開します。

クローンの作成

すでに手元にパッケージがある場合、 packages というフォルダを作成してファイルをコピーしてください。ダウンロードの時間を省略することができます。

パッケージ一覧

ファイルとして、以下のファイル一覧が揃っていることを確認してください。

PS C:\projects\docker-images\packages> dir


    ディレクトリ: C:\projects\docker-images\packages


Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----       2019/12/23     11:44      392594063 Sitecore 9.3.0 rev. 003498 (WDP XM1 packages).zip
-a----       2019/12/23     11:57      293163136 Sitecore 9.3.0 rev. 003498 (WDP XP0 packages).zip
-a----       2019/12/23     12:47     1306889900 Sitecore 9.3.0 rev. 003498 (WDP XP1 packages).zip
-a----       2019/12/23     12:48        3907601 Sitecore Experience Accelerator 9.3.0.2589 CD.scwdp.zip
-a----       2019/12/23     12:47       17235647 Sitecore Experience Accelerator 9.3.0.2589.scwdp.zip
-a----       2019/12/23     12:49        3907601 Sitecore Experience Accelerator XM 9.3.0.2589 CD.scwdp.zip
-a----       2019/12/23     12:49       17235627 Sitecore Experience Accelerator XM 9.3.0.2589.scwdp.zip
-a----       2019/12/23     12:50       17626005 Sitecore Publishing Service 4.2.0-win-x64.zip
-a----       2019/12/23     12:49        1921044 Sitecore.PowerShell.Extensions-6.0.scwdp.zip

Publishing Service に関するファイルが準備されていないため、 Download-PS-Prerequisites.ps1 のファイルを利用してモジュールを作成します。

このスクリプトを実行するにあたって、Web Deploy 3.6 for Hosting Servers を事前にインストールしておく必要があります。インストールをしていない場合のエラー画面は以下のようになります。

インストールをしていない場合のエラー画面

モジュールのインストールには、 Web Platform Installer をインストールして、 Web Deploy 3.6 for Hosting Servers をインストールします。インストールは以下のサイトからダウンロードをして実行してください。

Web Platform Installer

インストールが完了したあと、以下のようにスクリプトを実行します。

.\Download-PS-Prerequisites.ps1 -SitecoreUsername "YOUR dev.sitecore.net USERNAME" -SitecorePassword "YOUR dev.sitecore.net PASSWORD"
Publishing Service のモジュール作成

サイトからモジュールをダウンロード、またモジュールを作成するために Sitecore Azure Toolkit をダウンロードして、展開、zip ファイル化まで実行します。

Downloading 'https://dev.sitecore.net/~/media/417C43AC4F334C4085D18925367FE79A.ashx' to 'C:\projects\docker-images\packages\Sitecore Publishing Module 9.3.0.0 rev. r00546.2197.zip'...
Downloading 'https://dev.sitecore.net/~/media/B627BFA7070B40AD854A0FF08719381D.ashx' to 'C:\projects\docker-images\packages\Sitecore Azure Toolkit 2.4.0-r02514.1001.zip'...
Prepare Azure toolkit
Sitecore Azure Toolkit directory C:\projects\docker-images\tools\sat
Create SAT directory C:\projects\docker-images\tools\sat
Import Sitecore Azure Toolkit
Convert to WDP C:\projects\docker-images\packages\Sitecore Publishing Module 9.3.0.0 rev. r00546.2197.zip
C:\projects\docker-images\packages\Sitecore Publishing Module 9.3.0.0 rev. r00546.2197.scwdp.zip
DONE
PS C:\projects\docker-images>

続いて build.ps1 を利用して、Sitecore の Docker イメージを作成します。このコマンドに、ユーザー名、パスワードを渡して実行をします。

.\Build.ps1 -SitecoreUsername "YOUR dev.sitecore.net USERNAME" -SitecorePassword "YOUR dev.sitecore.net PASSWORD"

このプロセスは非常に時間がかかります。プロセス上タイムアウトをしてしまうようなケースでは、再度実行をすることでイメージのビルドを続けることができます。

イメージ名

フラグ

フラグ

Num

ベースイメージ

sitecore-assets:9.3.0-nanoserver-1809

True

False

0

{mcr.microsoft.co...

mssql-developer:2017-windowsservercore-ltsc2019

True

False

3

{mcr.microsoft.co...

sitecore-xp-xconnect:9.3.0-windowsservercore-ltsc2019

True

False

6

{sitecore-assets:...

sitecore-xm-sqldev:9.3.0-windowsservercore-ltsc2019

True

False

13

{sitecore-assets:...

sitecore-xp-sqldev:9.3.0-windowsservercore-ltsc2019

True

False

13

{sitecore-assets:...

sitecore-xm-cd:9.3.0-windowsservercore-ltsc2019

True

False

14

{sitecore-assets:...

sitecore-xm-cm:9.3.0-windowsservercore-ltsc2019

True

False

14

{sitecore-assets:...

sitecore-xp-cd:9.3.0-windowsservercore-ltsc2019

True

False

14

{sitecore-assets:...

sitecore-xp-standalone:9.3.0-windowsservercore-ltsc2019

True

False

14

{sitecore-assets:...

sitecore-xp-xconnect-automationengine:9.3.0-windowsservercore-ltsc2019

True

False

15

{sitecore-assets:...

sitecore-xp-xconnect-indexworker:9.3.0-windowsservercore-ltsc2019

True

False

15

{sitecore-assets:...

sitecore-xp-xconnect-processingengine:9.3.0-windowsservercore-ltsc2019

True

False

15

{sitecore-assets:...

sitecore-xm-spe-sqldev:9.3.0-windowsservercore-ltsc2019

True

False

16

{sitecore-assets:...

sitecore-xp-spe-sqldev:9.3.0-windowsservercore-ltsc2019

True

False

16

{sitecore-assets:...

sitecore-xm-spe-cm:9.3.0-windowsservercore-ltsc2019

True

False

17

{sitecore-assets:...

sitecore-xp-spe-standalone:9.3.0-windowsservercore-ltsc2019

True

False

17

{sitecore-assets:...

sitecore-xm-sxa-sqldev:9.3.0-windowsservercore-ltsc2019

True

False

18

{sitecore-assets:...

sitecore-xp-sxa-sqldev:9.3.0-windowsservercore-ltsc2019

True

False

18

{sitecore-assets:...

sitecore-xm-sxa-cd:9.3.0-windowsservercore-ltsc2019

True

False

19

{sitecore-assets:...

sitecore-xm-sxa-cm:9.3.0-windowsservercore-ltsc2019

True

False

19

{sitecore-assets:...

sitecore-xp-sxa-cd:9.3.0-windowsservercore-ltsc2019

True

False

19

{sitecore-assets:...

sitecore-xp-sxa-standalone:9.3.0-windowsservercore-ltsc2019

True

False

19

{sitecore-assets:...

sitecore-ps:9.3.0-windowsservercore-ltsc2019

True

False

1000

{sitecore-assets:...

sitecore-redis:3.0.504-windowsservercore-ltsc2019

True

False

1000

{mcr.microsoft.co...

sitecore-xm-solr:9.3.0-nanoserver-1809

True

False

1000

{mcr.microsoft.co...

sitecore-xm-sxa-solr:9.3.0-nanoserver-1809

True

False

1000

{mcr.microsoft.co...

sitecore-xp-solr:9.3.0-nanoserver-1809

True

False

1000

{mcr.microsoft.co...

sitecore-xp-sxa-solr:9.3.0-nanoserver-1809

True

False

1000

{mcr.microsoft.co...

1.3. 参考動画

上記の手順を早送りで紹介している動画を公開しています。