Docker Examplesリポジトリをクローンする

まずDocker Exampleリポジトリ をマシン上のC:\sitecore\docker-examples\ などの場所にクローンします(以下の手順はこのフォルダを使用していることを前提としています)。このトピックでは、リポジトリ内のgetting-startフォルダを使用します。

PowerShellプロンプトを開き、getting-startフォルダに移動します。そこには以下のファイルが含まれています:

• docker-compose.yml および .env : Docker Compose ファイルの種類。これらはバニラSitecoreインスタンスを起動するために必要な主要なファイルです。 Sitecoreコンテナデプロイメントパッケージに含まれています。
• mssql-data、 solr-data、 traefik - Sitecoreインスタンス内のDockerコンテナで利用されるサポートフォルダー。 Sitecoreコンテナデプロイメントパッケージに含まれています。
• init.ps1 および clean.ps1 - 例示ヘルパースクリプト。 Sitecoreコンテナデプロイメントパッケージには含まれていません。

これらの各点については、以下のセクションでより詳しく説明します。

Docker Composeファイル

• docker-compose.yml

  このComposeファイルはdocker composeコマンドで使用される主要な設定ファイルです。異なるコンテナ( サービスと呼ばれる)とその構成に関する情報が含まれています。

  Sitecoreの場合、サービスは一般的にトポロジーを構成する個々のSitecoreロール(mssql、solr、id、cmなど)を表します。

• .env

  これは環境ファイルです。ここでの値は、Composeファイルで参照される環境変数(例: SITECORE_DOCKER_REGISTRY)のデフォルト値を提供します。またはComposeの設定(例: COMPOSE_PROJECT_NAME)に使います。

環境変数は、設定設定をコンテナに渡す推奨される方法です。 docker-compose.ymlファイルでSitecoreコンテナでどのように使われているかを見ることができます。例えばmssqlサービスは、SQL Server SAパスワード(SA_PASSWORD)を設定する環境変数を設定します。

mssql: isolation: ${ISOLATION} image: ${SITECORE_DOCKER_REGISTRY}sitecore-xp0-mssql:${SITECORE_VERSION} environment: SA_PASSWORD: ${SQL_SA_PASSWORD} SITECORE_ADMIN_PASSWORD: ${SITECORE_ADMIN_PASSWORD} ACCEPT_EULA: "Y" SQL_SERVER: mssql ports:

• "14330
  "

値は変数置換(${SQL_SA_PASSWORD})を用いて .envファイルから取得されます。

!注SQL Server SAのパスワードはSQL Serverのパスワードポリシー 要件を満たす必要があります。そうでなければ、SQL Serverコンテナが正しく動作しない可能性があります。

調理

リポジトリにはすべての準備ステップを自動的に実行するスクリプト、すなわちinit.ps1スクリプトが含まれています。

このスクリプトを実行するには:

1. PowerShell管理者プロンプトを開きます。

2. 次のコマンドを実行し、-LicenseXmlPathをSitecoreライセンスファイルの場所に置き換えてください:

   .\init.ps1 -LicenseXmlPath C:\License\license.xml

スクリプトを使わない場合は、以下のセクションの手順に従ってください。

TLS/HTTPS証明書の設定

SitecoreはTraefikをDocker Composeのデフォルトのリバースプロキシまたはエッジルーターとして使用しています。 getting-started\traefikフォルダには以下のものが含まれています:

• 認定資格

  生成した証明書を入れる空のフォルダです。

• config/dynamic/certs_config.yaml

  Traefikコンテナで使用されるTraefikの設定ファイル。

このtraefikフォルダ全体はTraefikコンテナ用に提供されており、docker-compose.ymlファイル内にDockerボリュームがあります。

traefik: ... volumes:

• source: \\.\pipe\docker_engine target: \\.\pipe\docker_engine type: npipe
• ./traefik:C:/etc/traefik ...

traefikサービスは、相関の*./traefikフォルダをC:/etc/traefik*の実行中のコンテナにマッピングします。

このパスはTraefikサービス構成で使用され、--providers.file.directoryはC:/etc/traefik/config/dynamic ( certs_config.yamlファイルがある場所)として指定されます。詳細はTraefikのドキュメント をご覧ください。

certs_config.yamlファイルはまた、certsフォルダ内の証明書を参照するためにもボリュームを使用します:

tls: certificates:

• certFile: C:\etc\traefik\certs\xp0cm.localhost.crt keyFile: C:\etc\traefik\certs\xp0cm.localhost.key
• certFile: C:\etc\traefik\certs\xp0id.localhost.crt keyFile: C:\etc\traefik\certs\xp0id.localhost.key

Windows Hostsファイルのエントリを追加

Windows hostsファイルにxp0cm.localhostとxp0id.localhostホスト名を追加し、ループバックIPアドレス127.0.0.1を指すことができます。

127.0.0.1 xp0cm.localhost 127.0.0.1 xp0id.localhost

あるいは、SitecoreDockerToolsのAdd-HostsEntryコマンドレットを使うこともできます:

Add-HostsEntry "xp0cm.localhost" Add-HostsEntry "xp0id.localhost"

Sitecoreを起動

Sitecoreを始めるには:

• Composeファイルと同じフォルダ内で以下のコマンドを実行してください:

  docker compose up -d

このコマンドは以下の通りです:

• Sitecoreコンテナレジストリから必要なすべてのイメージをダウンロードします。
• デフォルトのネットワークを作成します。
• 構成された各サービスごとにコンテナを作成します。
• コンテナは設定されたエントリーポイントからスタートします。

!注 -d (切り離したモード)は、Dockerにバックグラウンドでコンテナを起動し、そのまま実行させておくよう指示します。これを省略すると、コンテナログが出力にストリーミングされ、プロンプトに戻るにはCtrl``+Cと入力する必要があります。これを行うとコンテナも停止し、削除されます。

このガイドで使われる他の一般的なコマンドの簡単な参照については、Sitecore Dockerチートシートをご覧ください。

ランニングコンテナを見る

作成したコンテナを見るには:

• docker psコマンドを実行してください:

  docker ps

この場合は、状態がUpで示されたすべての稼働中のコンテナのリストが表示されます。また、コンテナID、使用されている画像、コンテナが露出しているポートも確認できます。

CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES 75684e9146f2 traefik

一部のステータスが(health: starting)になっていることに気づくかもしれません。これは、設定されたヘルスチェックに合わせるためにまだウォームアップ中であることを意味します(docker-compose.ymlファイルのhealthcheck参照)。docker psコマンドを再度実行すると、最終的にはすべてが(healthy)に変わるのが見えます。

アクセスSitecoreコンテナ

リバースプロキシがサービスを提供するコンテナには、設定されたホスト名(例 :https://xp0cm.localhost)を使ってHTTPSプロトコルでアクセスします。

他の公開コンテナは特定のポートを使用するよう事前に設定されています(docker-compose.ymlファイルのportsを参照)。WindowsのDocker Desktopのデフォルト設定では、これらのポートにはlocalhostでアクセスできます。

つまり、Sitecore Experience Platform - Single(XP0) コンテナに以下のようにアクセスできます:

• Sitecore Content Management(cm): https://xp0cm.localhost
• Sitecore アイデンティティサーバー(id): https://xp0id.localhost
• Sitecore xConnect サーバー(xconnect): http://localhost:8081
• アパッチ・ソル(solr): http://localhost:8984
• Microsoft SQL Server (mssql): localhost,14330
• トラエフィク: http://localhost:8079

SQL Serverへの接続について

ポートを使ってSQL Serverに接続すると、構文が少し異なります。前述のようにコロン(:))ではなく、カンマ(,)を使う必要があります。認証SQL Serverは*、SA*アカウントと.envファイルで指定したSQL_SA_PASSWORD値(init.ps1ファイルではデフォルトでPassword12345)を使って接続できます:

スキーマのポピュレートとインデックスの更新

Sitecoreコンテナ環境には、起動時に動作し、必要なコアをSolrコンテナに生成し(もし存在していなければ)、そして終了するsolr-initコンテナが含まれています。これが期待される動作です。

ただし、このコンテナはSolr管理スキーマや再構築インデックスを埋めることはできません。手動またはカスタムスクリプトで行う必要があります。これをしないと、コンテナログでSolr関連のエラーを確認できます。

管理スキーマとインデックスの更新を埋めるために:

1. Sitecoreにログインして admin。
2. コントロールパネルを開き、すべての検索インデックスの管理スキーマを入力してください。
3. コントロールパネルにいる間に検索インデックスを再構築してください。

自分の事例を検証してください

あなたの例を検証するために:

1. https://xp0cm.localhostでSitecoreデフォルトのウェブサイトをご覧ください。

2. https://xp0cm.localhost/sitecoreを閲覧して、Sitecoreにログインできるか確認してください。ユーザー名はadmin、パスワードは.envファイル(init.ps1ファイルではデフォルトでPassword12345)で設定したSITECORE_ADMIN_PASSWORDの値を使います。

3. 以下のコマンドでログを確認し、すべてのコンテナからのログを確認してください:

   docker compose logs -f --tail 20

   -f(または--follow)オプションはDockerに出力をストリーミングするよう指示し、--tailオプションは各コンテナの最後の20行に初期ログ出力を制限します。ログはコンテナの前置き辞で付けられているのがわかります。

4. 終わったらCtrl+Cと入力してプロンプトに戻ってください。

Sitecoreを止めろ

Sitecoreインスタンスを停止するには:

• 次のコマンドを実行します:

  docker compose stop

  これで容器は止まりますが、取り外されるわけではありません。その後、容器をdocker compose startで再開できます。

• 容器を止めて取り出す方法:

  docker compose down

  これによりコンテナは停止しますが、同時にコンテナや作成されたネットワークも削除されます。

• 容器を停止・削除し、画像も削除するには:

  --rmi <all/local>を加えます。

開発ワークフローはこれらのコマンドの組み合わせを含みます。コマンドはトポロジーによりますが比較的速いです。

永続的なストレージのクリーンアップ

現在、mssql-dataとsolr-dataフォルダにファイルがあります。 traefikフォルダと同様に、これらはComposeファイル内の ボリューム としてマウントされたフォルダです。これらはdocker-compose.ymlファイル内で設定されています:

mssql: ... volumes:

• type: bind source: .\mssql-data target: c:\data solr: ... volumes:
• type: bind source: .\solr-data target: c:\data

フォルダはmssqlサービスのデータベースファイルとsolrサービスのインデックスファイルの永続保存として使われます。つまり、docker compose downコマンドを行ってもデータベースとインデックスデータはそのまま残ります。

ただし、Sitecoreの管理者パスワードを変更する場合など、新たにやり直したい場合や、古いデータのためにクリアが必要な場合もあります。

これらのフォルダ内のファイルは手動で削除することもできますし、clean.ps1スクリプトを使うこともできます。

ファイルを削除するには:

1. getting-startフォルダでPowerShell管理者プロンプトを開きます。

2. 次のコマンドを実行します:

   .\clean.ps1

さらなる参考文献

• https://docs.docker.com/compose
• https://docs.docker.com/docker-for-windows/networking/