Sitecore TDSプロジェクト構成

この例は、Build OutputとWebDeploy Packagesという2つのSitecore TDS機能を利用しています。これらはTDSプロジェクトのプロパティページで設定されています:

• ビルド出力パス - ビルド ページにあり、 Release ビルド設定を設定します。すべてのプロジェクトで共有されるパスTDS指定します。例では、これは ..\..\TdsGeneratedPackages\Release\に設定されています。
• ビルドWebDeployパッケージ - WebDeployパッケージページにあり、Releaseビルド設定を選択してください。Package Nameを指定します。コードおよびアイテムパッケージオプションは「アイテムのみパッケージ」を選択します。

以下は、TDSプロジェクトを適切に設定していることを前提にしています。

ソリューションビルドで設定

Sitecore TDS Dockerまたはクラウドビルドの環境変数のライセンスが必要です:

• ソリューションビルドDockerfileでは、コードコンパイルとビルドステージの最初にこれらの項目をARG宣言してください(例ではbuilder ):

  ARG TDS_Owner ARG TDS_Key

  Dockerfile内の位置はスコープARG重要です。もし前のビルド段階でこれらを宣言すると、builder段階で使われた値は空になります。また、ARGは画像作成にのみ使われるため、ENVではなく使われていることにも注意してください。

  これらの値は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} TDS_Owner: ${TDS_OWNER} TDS_Key: ${TDS_KEY} scale: 0

  TDS_OWNERとTDS_KEYの値は環境ファイル(.env)に保存できますが、通常はローカル開発マシンではシステム環境変数として、ビルドサーバーではセキュリティ上のシークレットとして指定します。

• ソリューションビルドDockerfileでは、msbuild命令を簡略化し、代わりにTDSプロジェクトで設定したビルド出力に頼ることができます。

  RUN msbuild /p

  =Release

  ビルド出力はTDSプロジェクトで指定された位置( Build Output Path)に着地します。 builderのWORKDIRに対してです。例では、これはビルド出力が次のことを意味します。

  • \build\TdsGeneratedPackages\Release (ファイル)
  • \build\TdsGeneratedPackages\WebDeploy_Release (WDPアイテムパッケージ)

  builder段階から最終画像にコピーし、次の構造で作成します。

  • \artifacts\website
  • \artifacts\packages
  • \artifacts\transforms

• 最終指示は以下のように調整できます:

  WORKDIR C:\artifacts COPY --from=builder \build\TdsGeneratedPackages\Release .\website\ COPY --from=builder \build\TdsGeneratedPackages\WebDeploy_Release .\packages\ COPY --from=builder C:\out\transforms .\transforms\

Sitecore CMのランタイムイメージに追加

solutionイメージにアイテムをパッケージ化・含めたら、Sitecoreランタイムイメージを構築する際にそれらをContent Management (CM)イメージに追加できます。

CMサービスのDockerfileの最後に、アイテムパッケージをデプロイするための指示を追加してください。TDSにはこの処理方法として2つのオプションがあります:

• オプション1

  これによりSitecore TDSサイト起動時にアイテムパッケージをインストールできます。 TDSの組み込み機能を使用しています。ただし、このイメージを使ってコンテナを作成するたびにこの現象が発生することに注意してください:

  COPY --from=solution \artifacts\packages\ \temp\ RUN Get-ChildItem -Path 'C:\\temp\\*.wdp.zip' | % { Expand-Archive -Path $_.FullName -DestinationPath 'C:\\temp' -Force; }; ` Move-Item -Path 'C:\\temp\\Content\\Website\\Bin\*' -Destination .\bin -Force; ` Move-Item -Path 'C:\\temp\\Content\\Website\\temp\*' -Destination .\temp -Force; ` Remove-Item -Path 'C:\\temp' -Recurse -Force; `

  Ensure TDS has permissions to delete items after install

  Version: 10.1
  日本語翻訳に関する免責事項

  このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

  cmd /C icacls .\temp\WebDeployItems /grant 'IIS AppPool\DefaultAppPool:(OI)(CI)M';

• オプション2

  tooling画像のDeploy-TdsWdpPackages.ps1スクリプトを使いましょう。パッケージと一緒にコピーしてください:

  COPY --from=tooling \tools\scripts\Deploy-TdsWdpPackages.ps1 \install\Deploy-TdsWdpPackages.ps1 COPY --from=solution \artifacts\packages\ \install\packages\

  その後、以下のスクリプトでコンテナ上でオンデマンドでDeploy-TdsWdpPackages.ps1を呼び出すことができます:

  docker exec powershell -command "C:\install\Deploy-TdsWdpPackages.ps1"

解決策のアーティファクトにシリアル化されたアイテムを追加してください

Unicornを使う場合、通常はシリアル化されたアイテムをSitecoreソリューションソース内に配置し、Unicorn構成で定義された構造で整理します。これはおそらくSitecore Helix手法に従うこともあります。これらのシリアライズされたアイテムはソリューションビルド中にコピーできますが、ディレクトリ構造を保持することが重要です。Robocopyはこれを実現する簡単な選択肢の一つです: