Sitecoreソリューションの構築

Dockerfileは、アプリケーションをコンテナ化するための最初のステップとして記述します。Dockerfileには、DockerがDockerイメージをアセンブルして実行するために使用する命令が含まれています。Dockerfileコマンドは、イメージを構築する方法のステップバイステップのレシピです。

以下は、単純な (Sitecore以外の) ASP.NET MVCアプリのDockerfileの例です。

FROM mcr.microsoft.com/dotnet/framework/sdk:4.8 AS build
WORKDIR /app

COPY *.sln .
COPY aspnetmvcapp/*.csproj ./aspnetmvcapp/
RUN nuget restore

COPY aspnetmvcapp/. ./aspnetmvcapp/
WORKDIR /app/aspnetmvcapp
RUN msbuild /p:Configuration=Release

FROM mcr.microsoft.com/dotnet/framework/aspnet:4.8 AS runtime
WORKDIR /inetpub/wwwroot
COPY --from=build /app/aspnetmvcapp/. ./

この例では、マルチステージ ビルドを使用します: 最初にコードがmcr.microsoft.com/dotnet/framework/sdkイメージ ( buildステージ) でビルドされ、次に出力がmcr.microsoft.com/dotnet/framework/aspnetイメージ ( runtimeステージ) にコピーされます。

その後、DockerfileはDockerビルド コマンド によって使用され、このコマンドはイメージをビルドして作成します。

オプションの .dockerignoreを使用すると、ビルド コンテキストからファイルとフォルダーを除外し、COPYコマンドとADDコマンドでサイズを縮小したり、機密データをスキップしたりできます。

この例では、コードのコンパイルとビルドがDockerfileの命令の一部であることを示しています。.NETでは、これにはNuGetの復元と、それに続くMSBuildの呼び出しが含まれる場合があります。このようにDockerfileでアプリケーションを直接ビルドすると、従来のビルドに比べて次のような利点があります。

一般的なSitecore実装では、通常、1つのVisual Studioソリューションで複数のロール (WebサイトやXConnectアセンブリなど) のビルド アーティファクトが作成され、一部のアーティファクトを複数のロール (CM/CDなど) にデプロイする必要があります。コンテナの場合、これは、同じビルド出力をmultiple base Sitecore runtime imagesの上に階層化する必要があることを意味します。代わりに、各Sitecoreイメージのビルド手順を複製することもできますが、これは非常に非効率的です。

必要なのは、ソリューションのビルドのみに焦点を当てたDockerfileと、出力を構造化されたビルド成果物として結果のイメージに格納することです。

イメージを生成するには、Docker buildコマンドを使用してDockerfileを送信する必要があります。 buildコマンドを直接使用することもできますが、ほとんどの場合、DockerComposeで構成されます。

custom-imagesフォルダには、次のファイルが含まれています。

これらはすべてDocker Composeファイルの種類です。

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

ソリューション イメージをビルドするには、次のようにします。

まず、トラブルシューティングガイドをご覧ください。

ソリューション イメージ (または任意のasset image) に固有の一般的なトラブルシューティングの問題の1つは、コンテナとして実行されないため、結果のファイル システムを探索する方法が明確でない可能性があることです。これを行うには、対話型シェルでイメージを実行します。

たとえば、対話型コマンド プロンプト (Nano ServerにはPowerShellがありません) を開くには、前に示したソリューション イメージの例を表示します。

docker run -it --rm docker-examples-solution:latest

「 exit 」と入力して一時コンテナーを削除し、前のPowerShellセッションに戻ります。