テンプレートを使用して展開パイプラインをカスタマイズする
ALM アクセラレータには、既定の環境と分岐戦略 に基づいて環境に展開するための、既成のパイプラインが含まれています。 "持ち込みテンプレート" (BYOT) アプローチを使用して、ALM アクセラレータ パイプラインを簡単にカスタマイズできます。 BYOT を使用すると、ブランチ戦略に基づいて展開をトリガーするものを制御できます。 BYOT を使用すると、既定の検証、テスト、運用環境以外の環境用のパイプラインを作成することもできます。
この記事 パイプライン テンプレートをカスタマイズして新しい受け入れ環境を含める で説明するシナリオは、BYOT アプローチを使用して実装できる可能性のある数多くのシナリオのうちの 1 つにすぎません。
BYOT を使用して展開パイプラインをカスタマイズする
ALM Accelerator for Power Platform をインストールすると、CoE スターター キット GitHub リポジトリのパイプライン テンプレートが Azure DevOps Git リポジトリにコピーされます。 パイプライン テンプレートの独自のコピーを使用すると、リポジトリ内の変更の影響を受けたり、ソリューションのアップグレード パスに影響を与えたりすることなく、テンプレートを変更できます。
次のテーブルでは、Azure DevOps Git リポジトリにコピーされる 3 つの展開パイプライン テンプレートについて説明しています。
| パイプライ ンテンプレート | Description | GitHub の場所 |
|---|---|---|
| build-deploy-validation-SampleSolution.yml | 検証環境の展開パイプライン | リンク |
| build-deploy-test-SampleSolution.yml | テスト環境の展開パイプライン | リンク |
| build-deploy-prod-SampleSolution.yml | 運用環境の展開パイプライン | リンク |
ALM アクセラレータが展開パイプラインを生成するときに、カスタマイズされたテンプレートを使用するように指示します。 これらを使用して、既定の検証、テスト、運用環境以外の環境にソリューションを展開したり、追加するその他のカスタム機能を展開したりできます。
パイプライン テンプレート内のプレースホルダー
パイプライン テンプレートには、テンプレートの場所のプレースホルダーと、展開パイプラインに使用するグローバル変数グループが含まれています。 これらの値を変更する必要はありません。 これらは、ALM アクセラレータが展開パイプラインを作成するときに更新されます。 パイプライン テンプレートの名前を、展開先の環境名と一致するように変更するだけです。 この記事で説明するシナリオでは、新しいテンプレートの名前は新しい受け入れ環境に展開しているため build-deploy-acceptance-SampleSolution.yml です。
次のテーブルでは、パイプライン テンプレートのパラメーターを説明しています。
| プレースホルダー | Description | 例 |
|---|---|---|
| RepositoryContainingTheBuildTemplates | パイプライン テンプレートを含む Azure DevOps Git リポジトリの名前 | coe-alm-アクセラレータ テンプレート |
| BranchContainingTheBuildTemplates | パイプライン テンプレートを含む Azure DevOps Git リポジトリのブランチ | main |
| SampleSolutionName | 自分のソリューション名 | マイニューソリューション |
| alm アクセラレータ変数グループ | ビルド テンプレートが展開パイプラインに使用する Azure DevOps プロジェクトのグローバル変数グループ。 | alm-アクセラレータ変数グループ |
新しい受け入れ環境に合わせてパイプライン テンプレートをカスタマイズする
このシナリオでは、パイプライン テンプレートを使用して、受け入れ環境にソリューションを展開します。 受け入れは、パイプライン テンプレートが提供される 3 つの既定環境の 1 つではありません。 作成する必要があります。
既定のテンプレートの 1 つをコピーします。たとえば、build-deploy-test-SampleSolution.yml を作成し、展開先の環境に基づいた新しい名前でテンプレート リポジトリにコミットします。 この例では、build-deploy-acceptance-SampleSolution.yml という名前を付けます。
導入プロファイルを更新して受け入れ環境を含める
ALM アクセラレータでは、展開プロファイルには、ソリューションの展開パイプラインを作成するために必要な情報が含まれています。 ソリューションの展開プロファイルは、ALM Accelerator ソリューション テーブルに格納されます。 ソリューションをプロファイルに関連付けてエクスポートすると、ALM アクセラレータ エクスポート パイプラインは、展開プロファイル内の情報に基づいてソリューションの展開パイプラインを生成します。 展開プロファイルはいつでも更新できます。
前提条件
ソリューションのプロファイルを作成する ALM Acceleratorアプリで。
新しい展開のステップを追加し、パイプライン テンプレート名を更新する
ALM アクセラレータ アプリを開きます。
展開プロファイル タブを選択し、更新するソリューションのプロファイルを開きます。
展開手順 で、新しい展開手順 を選択します。
新しい展開ステップに 受け入れ と名前を付けます。
ステップ番号 に 2 を設定します。
展開手順用に 展開環境 を作成し、受け入れ という名前を付けます。
URL を受け入れ環境の URL、たとえば
https://myacceptanceenvironment.crm.dynamics.com/に設定します。テンプレート パスの構築 を、作成したパイプライン テンプレートへのパス、たとえば Pipelines/build-deploy-acceptance-SampleSolution.yml に設定します。
展開可能 を 許可、 承認タイプ を プル リクエスト に設定し、ターゲット ブランチ から ソリューション ブランチを使用する を設定します。
これらの設定は、テスト環境の既定値と同じです。 この手順の既定値は、テスト展開手順を参照すると見つけることができます。
新しい展開のステップとパイプライン テンプレートの検証
新しい展開手順とパイプライン テンプレートを検証するには、ソリューションを再度エクスポートします。 ALM アクセラレータは、新しい展開手順とパイプライン テンプレートに基づいて、ソリューションの展開パイプラインを作成します。
新しい展開パイプラインを検証するには、ビルドを実行し、受け入れ環境に展開します。
これで、ソリューションに 4 つの展開パイプラインが作成されました。3 つは既定環境用、1 つは受け入れ環境用です。