DevEx Containers Documentation

DevEx Containers Documentation

  • Docs
  • Help

›はじめに

はじめに

  • 概要
  • 環境を整える
  • 最初のSitecoreインスタンスの実行

Sitecore イメージの作成

  • ソリューションのビルド
  • カスタムSitecoreイメージを構築する
  • コンフィグ変換の適用
  • Sitecoreモジュールの追加
  • カスタム xConnect モデルを含む
  • アイテム展開

ローカル開発とデバッグ

  • 実行中のコンテナへのファイル展開
  • 実行中のコンテナとのアイテム同期
  • コンテナで実行しているコードをデバッグする

参考情報

  • Dockerfileのベストプラクティスとシナリオ
  • Sitecore Dockerチートシート
  • Sitecore モジュールリファレンス
  • Sitecore イメージリファレンス
  • トラブルシューティング

環境を整える

本ドキュメントは、Docker Desktopを使用する Windows 10 が動作する開発環境に適用されます。

注意: このページの原文は https://containers.doc.sitecore.com/docs/environment-setup です

Docker Engine - Enterpriseを使用する Windows Server が動作するその他の環境(ビルドエージェントなど)については、Dockerのドキュメント を参照してください。注意 Docker Composeは 別インストール です。

前提条件

Windows 10でDockerを実行するには、以下のものが必要です。

Windows 10 Professional または Enterprise バージョン 1809 (2019 LTSC) 以降。プロセス分離を有効にするには、バージョン 1909 を推奨します。 Hyper-Vが有効になっていること。

Docker Desktopのインストーラは必要に応じてHyper-Vも有効にしますが、インストール時にマシンの再起動が必要になります。

VirtualBoxユーザーの方への注意点。Hyper-V を有効にすると、VirtualBox は動作しなくなります。ただし、既存のVirtualBox VMイメージはすべて保持されます。

ハードウェアガイドライン

ハードウェアはまず、Hyper-V自体を実行するための要件を満たす必要があります。互換性の確認方法を含む詳細については、Windows 10 Hyper-V システム要件を参照してください。要約すると、Hyper-Vには以下の要件が必要です。

  • Second-level address translation (SLAT)とハードウェア支援仮想化を備えた64ビットプロセッサ。
  • 少なくとも4GBのRAM(Sitecoreのガイドラインについては下記を参照)。
  • BIOSで仮想化サポートがオンになっていること

上記のHyper-Vの要件に加えて、Sitecore開発に推奨されるハードウェアは以下の通りです。

  • 16GBのRAM(最低)、32GBのRAM(推奨)。これは、インスタンスの数やどのトポロジを実行する予定か(コンテナを同時に実行する数など)によって異なります。例えば、XM1 や XP0 インスタンスの場合は 16GB で十分かもしれませんが、フル XP1 インスタンスを実行すると問題が発生する可能性が高いでしょう。
  • クアッドコア以上のCPU。
  • Sitecore コンテナイメージ用に約 25GB のディスク空き容量。Dockerコンテナをダウンロードして実行する際に最適なパフォーマンスを得るためには、SSDストレージを強く推奨します。

インストール

前提条件を満たせば、インストール自体は非常に簡単です。

Dockerデスクトップのインストール

  1. Docker Desktop for Windowsをダウンロードし、インストーラーを実行します。
  2. インストール時に、LinuxコンテナではなくWindowsコンテナを使用することを選択します。また、インストール後にWindowsコンテナに切り替えることもできます(下記参照)。

または、以下のコマンドでChocolateyを使ってインストールします。

choco install docker-desktop

詳細は Dockerのドキュメント を参照してください。

Dockerデスクトップを起動する

Docker Desktopはインストールしても自動的に起動しません。まだ起動していない場合は、Docker Desktopを起動します。

Docker Desktopを起動する

WindowsシステムトレイのDockerアイテム(クジラのアイコン)が安定していれば、Docker Desktopが起動して準備が整います。

注意 Docker Desktopはログイン時に自動的に起動するように設定されているので、通常は手動で起動する必要はありません。

Windowsコンテナに切り替える

今回はWindowsベースのコンテナを使ってSitecoreの開発を行います。インストール時にWindowsコンテナを選択しなかった場合は、今すぐWindowsコンテナを選択する必要があります。

WindowsのシステムトレイにあるDockerの項目(クジラのアイコン)を使って切り替えることができます(下図)。

Dockerメニュー

検証

コマンドプロンプトからdocker versionを実行して、インストールの基本的な詳細を確認します。DockerクライアントとDockerサーバーのOSが "windows "と表示されているはずです。

PS C:\WINDOWS\system32> docker version
Client: Docker Engine - Community
 Version:           19.03.8
 API version:       1.40
 Go version:        go1.12.17
 Git commit:        afacb8b
 Built:             Wed Mar 11 01:23:10 2020
 OS/Arch:           windows/amd64
 Experimental:      false

Server: Docker Engine - Community
 Engine:
  Version:          19.03.8
  API version:      1.40 (minimum version 1.24)
  Go version:       go1.12.17
  Git commit:       afacb8b
  Built:            Wed Mar 11 01:37:20 2020
  OS/Arch:          windows/amd64
  Experimental:     false

次のステップ

環境が正しく設定されたので、最初のコンテナベースの Sitecore インスタンスを実行する方法を説明します。

  • 最初のSitecoreインスタンスを実行する

関連情報

  • Docker for Windows FAQ
  • マイクロソフト オンプレミスシナリオでのWindowsコンテナとDockerのサポートポリシー
← 概要最初のSitecoreインスタンスの実行 →
  • 前提条件
    • ハードウェアガイドライン
  • インストール
    • Dockerデスクトップのインストール
    • Dockerデスクトップを起動する
    • Windowsコンテナに切り替える
  • 検証
  • 次のステップ
  • 関連情報
ドキュメント
はじめにカスタムの Sitecore イメージの作成ローカルの開発とデバッグベストプラクティス
リンク
Docker サンプルリポジトリ
Copyright © 2020 Sitecore Japan