############################# Docker イメージのビルド ############################# ここでは Sitecore Experience Platform 9.3.0 を Docker に展開するための手順を紹介しています。 作業環境として便利な Git for Windows、GitHub Desktop および Visual Studio Code を事前にインストールしてください。 ****************** Docker 環境の構築 ****************** Windows 上で Docker を利用するための環境を設定していきます。まず Windows の環境において、Containers と Hyper-V の機能を有効にしてください。 .. image:: images/docker01.png :align: center :width: 400px :alt: Hyper-V を有効化 .. image:: images/docker02.png :align: center :width: 400px :alt: Containers を有効化 環境を仮想マシン上に展開する場合は、以下のように仮想マシン上で Hyper-V を利用できるように設定してください。 * `入れ子になった仮想化による仮想マシンでの Hyper-V の実行 `_ 続いて、Docker for Windows をインストールします。インストールは以下のサイトからダウンロードをして実行してください。 * `Docker for Windows `_ ダウンロードしたファイルを実行すると、Docker のインストールが始まります。初期設定に関して、今回は Windows Container を利用することになるため、チェックしてください（インストール後変更は可能です）。 .. image:: images/docker03.png :align: center :width: 400px :alt: インストールの開始 ファイルのコピーなどが進みます。 .. image:: images/docker04.png :align: center :width: 400px :alt: ファイルのコピー インストールが終了すると画面が切り替わります。はじめてインストールするときには、ユーザーの権限を有効にするために一度ログオフが求められます。 .. image:: images/docker05.png :align: center :width: 400px :alt: インストール完了 Windows のコンテナが有効になっているか確認をします。Switch to Linux .. と記載されている場合は、Windows が有効になっている形です。 .. image:: images/docker06.png :align: center :alt: Containers の設定を確認 PowerShell を起動して、`docker -v` のコマンドを実行します。 .. image:: images/docker07.png :align: center :width: 400px :alt: docker version これで Docker の準備ができました。 *********************** Docker Images の準備 *********************** ここから先は、 https://dev.sitecore.net からモジュールのダウンロードが出来る権限、およびライセンスファイルが必要となります。 Docker の環境が整った次のステップとして、Github に公開されている Docker images リポジトリを活用します。 * `Sitecore/docker-images `_ 今回は Github Desktop を利用して、 `c:\\projects\\docker-images` のディレクトリにリポジトリのクローンを展開します。 .. image:: images/docker08.png :align: center :width: 400px :alt: クローンの作成 すでに手元にパッケージがある場合、 packages というフォルダを作成してファイルをコピーしてください。ダウンロードの時間を省略することができます。 .. image:: images/docker09.png :align: center :width: 400px :alt: パッケージ一覧 ファイルとして、以下のファイル一覧が揃っていることを確認してください。 .. code-block:: 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 を事前にインストールしておく必要があります。インストールをしていない場合のエラー画面は以下のようになります。 .. image:: images/sps-Prerequisites01.png :align: center :width: 400px :alt: インストールをしていない場合のエラー画面 モジュールのインストールには、 `Web Platform Installer `_ をインストールして、 `Web Deploy 3.6 for Hosting Servers` をインストールします。インストールは以下のサイトからダウンロードをして実行してください。 .. image:: images/sps-Prerequisites02.png :align: center :width: 400px :alt: Web Platform Installer インストールが完了したあと、以下のようにスクリプトを実行します。 .. code-block:: .\Download-PS-Prerequisites.ps1 -SitecoreUsername "YOUR dev.sitecore.net USERNAME" -SitecorePassword "YOUR dev.sitecore.net PASSWORD" .. image:: images/ps01.png :align: center :width: 400px :alt: Publishing Service のモジュール作成 サイトからモジュールをダウンロード、またモジュールを作成するために Sitecore Azure Toolkit をダウンロードして、展開、zip ファイル化まで実行します。 .. code-block:: 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 イメージを作成します。このコマンドに、ユーザー名、パスワードを渡して実行をします。 .. code-block:: .\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... ========================================================================= ========= ======= ====== ======================= *********************** 参考動画 *********************** 上記の手順を早送りで紹介している動画を公開しています。 .. raw:: html