構成変換の適用

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は1つのVisual Studio Websiteプロジェクトのルートです。

Helix ソリューションの例

Docker Examplesソリューションは、1つのWebsiteプロジェクトを含む簡単な例です。 Sitecore Helixのプラクティスに従う実際のソリューションでは、ネストされたフォルダー構造と レイヤーの優先度 ( Project, Feature, 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