1. Sitecore Azure Toolkitでのパッケージング

SCCPL変換の構造

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

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

Sitecore貨物ペイロード(SCCPL)パッケージは、以下の構造を持つZIPパッケージの拡張です。

指揮

概要

CopyToWebsite/*

ターゲットインストール内のWebsiteフォルダにファイルをコピーします。これを使って新しいファイルのデプロイや、リソースファイル、DLL、設定ファイルなどの既存ファイルを上書きできます。

CopyToRoot/*

Web Deployment Package(WDP)のルートにファイルをコピーします。通常、.dacpacや.sqlファイルを注入してデータベースの変更を行います。

Xdts/*

XMLファイルのXDT変換はウェブサイトのルートにあります。XDT変換を使って、WDPが展開する設定ファイルを調整し、新しい設定ファイルを追加せずに調整してください。ファイル名の規則は以下の通りです:{original file name}.xdt。

> [!注]
> SCCPL変換はXMLファイルの変換にXDT構文を使用し、Sitecore構成パッチ構文ではなく使用します。

IOActions/*.ioxml

WDPパッケージ内のファイルに対して行われるアクションを記述するXMLファイルです。以下のIOアクションセクションの例を参照してください。

SCCPLパッケージの構造

以下の例はSCCPLパッケージの構造を示しています。

パッケージ

概要

CopyToWebsite\App_Config\Include\Component.config

新しいコンポーネントの設定ファイル、Sitecoreへの統合。

CopyToWebsite\bin\Component.dll

コンポーネントのDLLファイルです。

CopyToWebsite/sitecore/shell/client/Applications/Component/page.cshtml

リソースファイル - MVCページビュー。

Xdts\App_Config\ConnectionStrings.config.xdt

XDT変換

。

IOActions\Component.ioxml

設定ファイルの有効化/無効化。

基本的なSCCPLパッケージ

SCCPLパッケージを使うことで、Sitecoreソリューションを自分のニーズに合わせて微調整できます。これを行うには2つの異なるアプローチがあります:

  • 現在のSCCPLを調整してください。

    !注このオプションを選ぶと、更新時にブランチとマージが必要です。

  • 現在のSCCPLを基にCargoフォルダ(CargoフォルダにはSCCPLが含まれています)を基に新しいSCCPLを作成します。そして、関連するSKUファイルを追加します($SKU.packaging.config.jsonではSCCPLの処理方法を学べます)。

    以下の表は基本的なSitecore SCCPLパッケージの概要です:

    パッケージ

    概要

    Sitecore.Cloud.Search.Azure.sccpl

    Azure Cognitive Searchプロバイダーを使ってweb.configファイルを変換します。また、cloud.searchの接続文字列にConnectionStrings.configファイルを追加するパッチでもあります。

    Sitecore.Cloud.ApplicationInsights.sccpl

    Application Insightsの設定ファイルを*/baseおよびApp_Config/Sitecore/Azure/*フォルダに、アセンブリファイルを*/bin*フォルダにコピーします。 ConnectionStrings.configファイルは変換されてappinsights.instrumentationkey接続を追加し、Application Insightsの設定でweb.configファイルを更新します。

    Sitecore.Cloud.DisableAnalytics.sccpl

    XM WDPに対して現在のSCCPLを適用します。これにより、 ConnectionStrings.configファイルのAnalyticsおよびXConnectの接続文字列が無効になり、Sitecore.Xdb.configファイルのXdb.Enabled設定もオフになります。

    Sitecore.Cloud.DisableExm.sccpl

    XM WDPに対して現在のSCCPLを適用します。これによりConnectionStrings.configファイルのEXM接続文字列が無効化され、Sitecore.EmailExperience.Core.configファイルのEXM.Enabled設定がオフになります。

    Sitecore.Cloud.Common.sccpl

    すべてのWDPに共通するSCCPLです。このパッケージの主な動作は以下の通りです:

    • データフォルダをD:\home\site\wwwroot\App_Data
    • Sitecoreライセンスのプレースホルダー作成
    • Sitecore.Diagnostics.configファイルの無効化
    • customErrors モード設定の値を「Off」に変更する(customErrors mode="Off")

    Sitecore.Cloud.HttpsRedirection.sccpl

    すべてのWDPに共通するSCCPLです。このパッケージはweb.configファイルを変換してhttpsリダイレクトを適用します。

    Sitecore.Cloud.IPSecurity.sccpl

    CM、Processing、DDSの役割へのアクセスを制限するためにIPフィルタリングの例を付けてweb.configファイルを更新します。

    Sitecore.Cloud.Redis_CD.sccpl

    CD WDPのSCCPLをXMおよびXPトポロジーに適用し、Redisキャッシュの設定と接続文字列を有効にします。

    Sitecore.Cloud.RoleSpecific_CD.sccpl

    CD WDPのSCCPLをXMおよびXPトポロジーに適用します。

    このパッケージの主な行動には以下が含まれます:

    • web.configファイルでWDPロールをContentDelivery に設定しています。
    • connectionstrings.configファイル内のCDロールの正しい接続文字列リストを設定すること。

    Sitecore.Cloud.RoleSpecific_CM.sccpl

    CM WDPのSCCPLをXMおよびXPトポロジーに適用します。

    このパッケージの主な行動には以下が含まれます:

    •  web.configファイルでWDPロールをContentManagement に設定します。
    • connectionstrings.configファイル内のCM役割の正しい接続文字列リストを設定する方法

    Sitecore.Cloud.RoleSpecific_DDS.sccpl

    DDSの役割に対するSCCPLをXPトポロジーに適用します。

    このパッケージの主な動作は以下の通りです:

    • WDP ロールを web.config ファイルで ContentManagement、DedicatedDispatch に設定します。

    Sitecore.Cloud.RoleSpecific_PRC.sccpl

    DDSロールの正しい接続文字列リストを設定し、XPおよびxDBトポロジーにPRC WDPを適用します。

    このパッケージの主な行動には以下が含まれます:

    • web.configファイルでWDPロールをProcessingに設定します。
    • connectionstrings.configファイル内のPRCロールの正しい接続文字列リストを設定すること。

    Sitecore.Cloud.RoleSpecific_REP.sccpl

    CM WDPのSCCPLをXPおよびxDBトポロジーに適用します。

    このパッケージの主な行動には以下が含まれます:

    • web.configファイルでWDPロールをReportingに設定します。
    • connectionstrings.configファイル内のREPロールの正しい接続文字列リストを設定すること。

    Sitecore.Cloud.RoleSpecific_XDBSingle.sccpl

    Sitecore Single WDPのSCCPLをxDB Single Toologyに適用します。

    このパッケージの主な行動には以下が含まれます:

    • WDPロールを処理、報告に設定web.config file。
    • connectionstrings.configファイル内のシングル(PRC+REP)役割の正しい接続文字列リストを設定すること。

    Sitecore.Cloud.RoleSpecific_XMSingle.sccpl

    Sitecore Single WDPのSCCPLをXMシングルトポロジーに適用します。

    このパッケージの主な行動には以下が含まれます:

    • web.configファイルで WDP ロールをContentManagementに設定ContentDelivery。
    • connectionstrings.configファイル内のSingle(CM+CD)役割の正しい接続文字列リストを設定すること。

    Sitecore.Cloud.RoleSpecific_XPSingle.sccpl

    Sitecore Single WDPのSCCPLをXP Single Toologyに適用します。

    このパッケージの主な動作は以下の通りです:

    • connectionstrings.configファイル内のSingle(CM+CD+PRC+REP)役割の正しい接続文字列リストを設定すること。

    Sitecore.Cloud.Security.sccpl

    データベースアカウント作成スクリプトをウェブサイトのrootにコピーし、セキュリティルールで web.config fileを変換します。

    Sitecore.Cloud.Security_CD.sccpl

    CDロールのセキュリティルールでweb.configファイルを変換します。

    Sitecore.Cloud.SetCompatibilityLevel.sccpl

    SQLサーバーの互換性レベルのスクリプトをウェブサイトのルートにコピーします。

    Sitecore.Cloud.Thundercracker.sccpl

    このパッケージの主な行動には以下が含まれます:

    • UploadWatcherフォルダ機能の削除(Azureには適用できないため)。
    • Media.CacheFolderフォルダの場所を変更すること。
    • PageStateStore とViewStateStore 設定を変更してDBに書き込みます。

IOActions

IOActionsはパス属性とアクション属性を持つ.ioxmlファイルで記述されます。有効化、無効化、削除のアクション値、そして以下の構造です。

…

属性

概要

経路

変更したいファイルのパスを、Websiteフォルダに対して相対的に設定します。

値は単一のファイルへの正確なパスで、期待される拡張子も含めてなければなりません。ワイルドカードはサポートされていません。

作戦

ファイルレベルで実行される操作(有効化、無効化、削除)です。

輸入輸出アクション

概要

有効化

設定ファイルを*.config.disabledまたは*.config.exampleから にリネームして有効化*.config。

無効化

設定ファイルを*.configから*.config.disabledにリネームして無効にしてください。

DELETE

パッケージからファイルを削除してください。

この記事を改善するための提案がある場合は、 お知らせください!