1. Sitecore for Visual Studio

ビルド時のアイテムの自動同期

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

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

ソリューションにビルド プロジェクトを作成して、ビルド時の項目のシリアル化と項目のプッシュを自動化できます。詳細については、ビルド構成に関するMicrosoftのドキュメント を参照してください。

メモ

ビルド プロジェクトのプロパティは、デバッグ ビルド構成とリリース ビルド構成で個別に編集できます。

開発者コレクションのNuGetフィードを設定する

Sitecore for Visual Studioのビルド プロジェクトは、開発者コレクションのNuGetパッケージのコンポーネントに依存します。ビルド時にパッケージを自動的にダウンロードするには、開発者コレクション フィードをパッケージ ソースに追加する必要があります。

開発者コレクションのフィードURLは https://nuget.sitecore.com/resources/v3/index.json

開発者コレクション フィードは、Visual StudioのNuGet.configファイルまたはパッケージ ソースに追加できます。

次に、開発者コレクション フィードを含むNuGet.configファイルの例を示します。

<configuration>
  <!--
  Used to specify the default Sources for list, install and update.
  -->
  <packageSources>
    <clear />
    <add key="Nuget" value="https://api.nuget.org/v3/index.json" />
    <add key="SitecorePreview" value="http://sitecore-nuget-preview:8010/index.json" />
    <add key="SVSComponents" value="https://nuget.sitecore.com/resources/v3/index.json"/>
  </packageSources>

  <activePackageSource>
    <!-- this tells that all of them are active -->
    <add key="All" value="(Aggregate source)" />
  </activePackageSource>
</configuration>

開発者コレクション フィードをVisual Studioに追加するには:

  1. Visual Studioで管理者特権で、Tools、NuGet Package Manager、Package Manager Settingsの順にクリックします。

  2. Optionsウィンドウで、NuGet Package Manager/Package Sourcesをクリックします。

  3. Add package sourceThe Add package source icon をクリックして、新しいパッケージ ソースを追加します。

    Illustration showing the Options window and how to add a package source.

  4. NameフィールドにSVSComponentsと入力します。

  5. Sourceフィールドにhttps://nuget.sitecore.com/resources/v3/index.jsonと入力します。

  6. UpdateをクリックしてからOKをクリックします。

ビルド プロジェクトを作成する

ビルドプロジェクトを作成するには:

  1. ソリューション エクスプローラーで、ソリューションを右クリックし、Add、New Projectの順にクリックします。

  2. Add a new projectウィンドウで、「Sitecore for Visual Studio Project」を検索して選択し、「Next」をクリックします。

    Illustration showing how to add a build project to a solution.

  3. Configure your new projectウィンドウで、ビルドプロジェクトの名前と場所を入力し、Createをクリックします。

    これで、ソリューションにビルド プロジェクトが作成されました。

    Illustration showing your build project in your solution.
    手記

    NuGetパッケージが復元され、ビルド プロジェクトがソリューション エクスプローラーに表示されるまでに数秒かかる場合があります。

    ほとんどの場合、必要なビルド プロジェクトは1つだけですが、より高度なシナリオでは、さらにビルド プロジェクトを作成し、ビルド時に異なる操作を実行するように構成できます。

ビルド プロジェクトの編集

ビルドプロジェクトを編集するには:

  1. ソリューション エクスプローラーで、ビルド プロジェクトを右クリックし、Propertiesをクリックします。ビルドプロジェクトウィンドウには3つのタブがあります。

    • General - プロパティタブに関する情報。

    • Serialized Item Packages - Sitecoreインスタンス アイテムのローカル パッケージへのシリアル化。

    • Serialized Items Push - シリアル化されたアイテムをファイル システムからSitecoreインスタンスにプッシュする。

  2. 関連するフィールドを編集します。

  3. ビルド プロジェクトを保存します。

項目をローカル パッケージにシリアル化する

アイテムをローカルパッケージにシリアル化するには:

  1. ソリューション エクスプローラーで、ビルド プロジェクトを右クリックし、Propertiesをクリックします。

  2. Serialized Items Packageタブで、Build Serialized Items Packageチェック ボックスをオンにします。

  3. Package Nameフィールドに、パッケージ名を入力します。

  4. Package Modulesセクションで、含めるモジュールと除外するモジュールを選択します。

    Illustration showing how to configure what items to serialize and package at build time.

  5. ビルド プロジェクトを保存します。

手記

項目のシリアル化を有効にすることは、ビルド時にsitecore package createコマンドを実行することと同じです。

アイテムをSitecoreインスタンスにプッシュする

アイテムをSitecoreインスタンスにプッシュするには:

  1. ソリューション エクスプローラーで、ビルド プロジェクトを右クリックし、Propertiesをクリックします。

  2. Serialized Items Pushタブで、Push Serialized items to environment during buildチェック ボックスをオンにします。

  3. プッシュ操作のみをシミュレートするには、Do What-if Pushチェック ボックスをオンにします。つまり、シリアル化されたアイテムはSitecoreインスタンスにプッシュされません。

  4. 項目をプッシュする前に、ファイル・システム内のシリアライズされた項目の整合性の検証をスキップするには、「 Skip file system validation 」チェック・ボックスを選択します。

  5. Push Modulesセクションで、含めるモジュールと除外するモジュールを選択します。

    Illustration showing how to configure what items to push to your Sitecore instance at build time.

  6. ビルド プロジェクトを保存します。

手記

プッシュ操作の有効化は、ビルド時にsitecore ser pushコマンドを実行することと同じです。

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