Sitecoreソリューションを構築

ビルドDockerfile

例のルートDockerfileはまさにそのようなDockerfileです。DockerコミュニティではこのタイプのビルドをしばしばDockerfile Dockerfile.buildと呼びます。

custom-imagesフォルダに移動し、そこにあるDockerfileを確認してください。簡単さのために、BASE_IMAGEとBUILD_IMAGE ARGが拡張されています。

1. ファイルは、デフォルトのバックスラッシュではなく、エスケープ文字をバックティック(')に設定するエ スケープ指令 から始まります。

   # escape=`

2. prepステージは、NuGet復元に必要なアーティファクトのみを集めるために使われます。これは.NETビルドでよく行われる最適化です(詳細はベストプラクティスDockerfile参照)。

   FROM mcr.microsoft.com/dotnet/framework/sdk

   .8 AS prep

   COPY *.sln nuget.config Directory.Build.targets Packages.props \nuget\ COPY src\ \temp\ RUN Invoke-Expression 'robocopy C:\temp C:\nuget\src /s /ndl /njh /njs *.csproj *.scproj packages.config'

3. 新しいbuilder段階が、.NET Framework SDKイメージに基づいてコードのコンパイルおよびビルドプロセスを開始し、BUILD_CONFIGURATION ARGが宣言されます(これはdebugまたはrelease、Docker Composeで設定されています):

   FROM mcr.microsoft.com/dotnet/framework/sdk

   .8 AS builder ARG BUILD_CONFIGURATION

4. SHELL命令は、すべての命令に対してデフォルトのシェルをPowerShell(デフォルトcmdから)に切り替わります。これはWindowsのDockerファイルでよく使われる命令です:

   SHELL "powershell", "-Command", "$ErrorActionPreference = 'Stop'; $ProgressPreference = 'SilentlyContinue';"

5. 次にワーキングディレクトリが作成され、以前に収集されたNuGetアーティファクトをコピーし、(最適化された) nuget restoreを実行します。

   WORKDIR C:\build COPY --from=prep .\nuget .\ RUN nuget restore

6. 復元後、残りのソースコードがコピーされ、変換ファイルはC:\out\transformsで収集されます:

   COPY src\ .\src\ RUN Invoke-Expression 'robocopy C:\build\src C:\out\transforms /s /ndl /njh /njs *.xdt'

   例には.dockerignore (Dockerfileの横に配置されています)。これによりCOPYコマンドのサイズが小さくなり、binやobjフォルダなどは除外されます。これはビルドDockerfileのベストプラクティスです。設定変換の詳細については、「設定変換の適用」を参照してください。

7. 次に、msbuildを用いて設定されたBUILD_CONFIGURATIONのビルドが実行されます。この例には、ウェブサイト/プラットフォーム(DockerExamples.Website.csproj)とxConnect(DockerExamples.XConnect.csproj)環境の両方を対象としたプロジェクトが含まれています。シンプルなファイルシステムのパブリッシュが使用され、出力はそれぞれC:\out\websiteとC:\out\xconnectに着地します。

   RUN msbuild .\src\DockerExamples.Website\DockerExamples.Website.csproj /p

   =$env
   _CONFIGURATION /p
   =True /p
   =WebPublish /p
   =FileSystem /p
   =C:\out\website RUN msbuild .\src\DockerExamples.XConnect\DockerExamples.XConnect.csproj /p
   =$env
   _CONFIGURATION /p
   =True /p
   =WebPublish /p
   =FileSystem /p
   =C:\out\xconnect

8. ビルド完了後、最終イメージのビルド出力が収集されます。この段階ではMicrosoft Nano Serverイメージ が使用されます。このイメージはファイルのみを配信し実行されないため、ベースイメージは最適化されたサイズで選択されます。これは他のランタイムイメージよりも はるかに 小さいものです:

   FROM mcr.microsoft.com/windows/nanoserver

9. 出力ファイルはbuilder段階から最終画像に以下の構造でコピーされます。

   • \artifacts\website
   • \artifacts\transforms
   • \artifacts\xconnect

   WORKDIR C:\artifacts COPY --from=builder C:\out\website .\website\ COPY --from=builder C:\out\transforms .\transforms\ COPY --from=builder C:\out\xconnect .\xconnect\

!注この例ではSitecoreのアイテムシリアライズは行われていません。シリアライゼーションフレームワークや戦略によっては、ソリューションビルドのDockerfileに追加の指示が含まれることがあります。詳細は 「アイテムのデプロイ」を参照してください。

解像

ソリューションビルドDockerfileはビルドアーティファクトのみで構成されたイメージを生成します。得られた ソリューションイメージ は決してDockerコンテナ上で実行されることを意図していません。このようなイメージは時に アセットイメージと呼ばれます。

理解してくださいdocker-compose.override.yml

docker-compose up -dなどのDocker Composeコマンドでは、特に指定がない限り、docker-compose.override.ymlファイルはメインのdocker-compose.ymlファイルと自動的に含まれています。Docker Composeに2つ以上のコンポジションファイルが渡されると、それらを統合し、すべてのリソースと設定を一つのマージ定義にまとめます。

この例では、docker-compose.ymlファイルはデフォルトのSitecore Experience Platform - Single(XP0) Docker Composeファイルで、Sitecoreから提供されます。 docker-compose.override.ymlはメインファイルを拡張し、カスタムSitecoreイメージ構築や開発に必要なオーバーライドや拡張子を付けます。

ソリューションサービスの設定

docker-compose.override.ymlファイルはソリューションイメージビルドを定義する場所です。

ファイルを開いて、solutionサービスがどのように構成されているかを確認してください:

solution: image: ${REGISTRY}${COMPOSE_PROJECT_NAME}-solution:${VERSION:-latest} build: context: . args: BASE_IMAGE: ${SOLUTION_BASE_IMAGE} BUILD_IMAGE: ${SOLUTION_BUILD_IMAGE} BUILD_CONFIGURATION: ${BUILD_CONFIGURATION} scale: 0

以下の点に注目してください。

• 変数の数値(例: ${SOLUTION_BASE_IMAGE})はこの例の 環境ファイル (.env)に定義されていますが、ローカル開発マシンのシステム環境変数やビルドサーバー上のシークレットからも取得可能です。
• 画像名には -solution の接尾辞が使われます。デフォルトの変数値を使うと、タグ付けされたバージョンは docker-examples-solution
• build contextは.に設定されていて、同じ場所でビルドDockerfileを使うように指示Docker Compose。
• build argsはビルドDockerfileに見られたものと相関しています。
• scale は0に設定されており、 solution サービスのコンテナが docker-compose up中に起動されないようにしています。