初めてSitecoreインスタンスを起動してください

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

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

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

• docker-compose.yml および .env : Docker Compose ファイルの種類。これらはバニラSitecoreインスタンスを起動するために必要な主要なファイルです。 Sitecoreコンテナサポートパッケージに含まれています。
• mssql-datasolr-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

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

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)を使って接続できます:

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

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

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/