設定変換の適用

custom-images フォルダーに移動して、フォルダー内の Dockerfile を確認します。

変換ファイル (.xdt 拡張子) は builder ステージ内で収集され、C:\out\transforms にドロップされていることがわかります。ここでは、robocopy を (/s フラグと一緒に) 使用することが、フォルダー構造を保持するために重要です。

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

これは msbuild の前に行われるため、ビルド出力から除外されていない余分な .xdt ファイルを拾う必要がないことに注意してください。これらのファイルは、builder ステージから最終イメージへと \artifacts\transforms の構造でコピーされます。

COPY --from=builder C:\out\transforms .\transforms\

ランタイム イメージに変換を適用するには:

Invoke-XdtTransform.ps1 スクリプトは、 -Path と -XdtPath のパラメーターに 2 つのフォルダーを受け入れます。フォルダーを使用する場合、次の点に注意します。

ここでは、-Pathは、C:\inetpub\wwwroot の現在の WORKDIR であり、-XdtPath は、Visual Studio の単一の Website プロジェクトのルートです。

Helix ソリューションの例

Docker Examples ソリューションは、単一の Website プロジェクトを用いた簡単な例です。Sitecore Helix のプラクティスに従った実際のソリューションでは、ネストされたフォルダー構造とレイヤーの優先順位 (プロジェクト、機能、Foundation など) を反映するように、変換コマンドを調整する必要があります。

RUN Get-ChildItem C:\transforms\solution\Foundation\*\website | ForEach-Object { & C:\tools\scripts\Invoke-XdtTransform.ps1 -Path .\ -XdtPath $_.FullName }; `
    Get-ChildItem C:\transforms\solution\Feature\*\website | ForEach-Object { & C:\tools\scripts\Invoke-XdtTransform.ps1 -Path .\ -XdtPath $_.FullName }; `
    Get-ChildItem C:\transforms\solution\Project\*\website | ForEach-Object { & C:\tools\scripts\Invoke-XdtTransform.ps1 -Path .\ -XdtPath $_.FullName };

変換ファイルは、他のすべてのファイルと一緒にメインのビルド出力に保持できます。このアプローチの欠点は、同じ設定ファイルに対して複数の変換をサポートしないことですが、ソリューション ビルドの Dockerfile とイメージが存在せず、代わりに従来のビルドに依存している場合は、これが唯一のオプションになることがあります。

次に例を示します。

RUN $xdts = [System.Collections.ArrayList]@(); `
    $xdts.AddRange(@(Get-ChildItem -Path .\*.xdt)); `
    $xdts.AddRange(@(Get-ChildItem -Path .\App_Config\*.xdt -Recurse)); `
    $xdts | ForEach-Object { & C:\tools\scripts\Invoke-XdtTransform.ps1 -Path $_.FullName.Replace('.xdt', '') -XdtPath $_.FullName }; `
    $xdts | ForEach-Object { Remove-Item -Path $_.FullName };

Invoke-XdtTransform.ps1 スクリプトは、パラメーターとして一致する設定ファイルと変換ファイルも受け入れます。

この例では、Web ルートと App_Config フォルダー内の .xdt ファイルを探して、Invoke-XdtTransform.ps1 スクリプトを通じて渡し、.xdt ファイルを削除しています。

cm サービスの docker\build フォルダーに移動します。このロール用に、transforms フォルダーが追加されていることがわかります。

build
    cm
        transforms
            Web.config.xdt
        Dockerfile

Web.config.xdt 変換が 1 つだけありますが、この変換には、cm ロールに必要なその他の変換を含めることができます。ソリューション変換の場合と同様に、ターゲットのフォルダー構造に合わせて変換ファイルを構成します。

次に、これらの変換をロールの Sitecore ランタイム Dockerfile に適用します。

cm サービスの Sitecore ランタイム Dockerfile では、transforms フォルダーの内容が Docker ビルド コンテキストからコピーされて、\transforms\role\ に配置されていることがわかります。

COPY .\transforms\ \transforms\role\

次に、ソリューションの変換後に、同じ Invoke-XdtTransform.ps1 スクリプトを使って変換を適用します。

RUN C:\tools\scripts\Invoke-XdtTransform.ps1 -Path .\ -XdtPath C:\transforms\role