パイプライン拡張ポイントを構成する
パイプライン テンプレートには、 ALM Accelerator for Power Platform いくつかの拡張ポイント、つまり フックがあります。 これらを使用すると、パイプライン テンプレートを新しいリリースにアップグレードするときに、マージ競合によるノイズを最小限に抑えながらパイプラインをカスタマイズできます。
ALM Accelerator YAMLテンプレートの拡張ポイント
次の表に、サポートされている拡張ポイントを示します。
| パイプライン YAML ファイル名 | 拡張ポイント | プロパティ | 拡張 YAML ファイル |
|---|---|---|---|
| Templates/export-Solution.yml | ソリューションのエクスポート プレフック | エクスポート ソリューション パイプラインの初期 手順 としてカスタマイズを追加します。 | Hooks/export-solution-pre-hook.yml |
| Templates/export-Solution.yml | ソリューションのアンパック プレフック | ソリューションの解凍プロセスの前にカスタマイズを追加します。 | Hooks/export-solution-unpack-pre-hook.yml |
| Templates/export-Solution.yml | 操作プレフック | ソリューション ファイルを操作する前にカスタマイズを追加します。 | Hooks/export-solution-manipulate-pre-hook.yml |
| Templates/export-Solution.yml | 展開設定の更新プレフック | 展開設定を更新する前にカスタマイズを追加します。 | Hooks/export-solution-update-deploymentsettings-pre-hook.yml |
| Templates/export-Solution.yml | ソリューション コミット プレフック | ソリューションのソース コードがGitにコミットされる前にカスタマイズを追加します。 | Hooks/export-solution-commit-pre-hook.yml |
| Templates/export-Solution.yml | ソリューションのエクスポート ポストフック | エクスポート ソリューション パイプラインの最後の 手順 としてカスタマイズを追加します。 | Hooks/export-solution-post-hook.yml |
| Templates/build-Solution.yml | ソリューションの構築プレフック | ビルド ソリューション パイプラインの初期 手順 としてカスタマイズを追加します。 | Hooks/build-solution-pre-hook.yml |
| Templates/build-Solution.yml | 操作プレフック | ソリューション ファイルを操作する前にカスタマイズを追加します。 | Hooks/build-solution-manipulate-pre-hook.yml |
| Templates/build-Solution.yml | ソリューション パック プレフック | ソリューションがソース コードからパックされる前にカスタマイズを追加します。 | Hooks/build-solution-pack-pre-hook.yml |
| Templates/build-Solution.yml | ソリューションの構築ポストフック | ビルド ソリューション パイプラインの最後の 手順 としてカスタマイズを追加します。 | Hooks/build-solution-post-hook.yml |
| Templates/deploy-Solution.yml | ソリューションの展開プレフック | デプロイ ソリューション パイプラインの初期 手順 としてカスタマイズを追加します。 | Hooks/deploy-solution-pre-hook.yml |
| Templates/deploy-Solution.yml | ソリューションのインポート プレフック | ソリューションをインポートする前にカスタマイズを追加します。 | Hooks/deploy-solution-import-pre-hook.yml |
| Templates/deploy-Solution.yml | ソリューションの構成プレフック | 展開されたソリューションを構成する前にカスタマイズを追加します。 | Hooks/deploy-solution-configure-pre-hook.yml |
| Templates/deploy-Solution.yml | ソリューションの展開ポストフック | ビルド ソリューション パイプラインの最後の 手順 としてカスタマイズを追加します。 | Hooks/deploy-solution-post-hook.yml |
YAMLテンプレートで拡張ポイントを使用する
拡張ポイントを使用してALM Acceleratorパイプラインの機能を拡張するには、 Hooks/CustomTemplates フォルダー内のカスタムYAMLテンプレートに拡張機能を追加するか、使用する拡張機能 ポイントする のYAMLファイルに直接拡張機能を追加します。
次の例では、 エクスポート ソリューション事前フック 拡張機能 ポイントする を使用して、 export-solution.yml パイプライン内のテンプレート Hooks\CustomTemplates\output-environment-variables.yml をカスタマイズします。
export-solution-pre-hook.yml ファイルに次のコードを追加します。
- template: CustomTemplates/output-environment-variables.yml
export-solution-pre-hook.yml は次のようになります。
steps:
- script: echo Export Solution Pre Hook
displayName: 'Export Solution Pre Hook'
enabled: false
- template: CustomTemplates/output-environment-variables.yml
カスタマイズされたパイプライン テンプレートをアップグレードするときにマージ競合を処理する
注意
ALM Acceleratorパイプライン テンプレートの新しいリリースにアップグレードするときにマージ競合を解決するために、 Pull Request Merge Conflict拡張機能 を Azure DevOps使用することをお勧めします。
ALM Acceleratorパイプライン テンプレートをカスタマイズすると、テンプレートを新しいリリースにアップグレードするときにマージの競合が発生します。
拡張ポイントは、パイプラインをカスタマイズするために使用した場合にマージ競合の処理が簡単になるような方法で実装されています。 ファイルの変更バージョンを Hooks フォルダーに保存します。 ALM Acceleratorパイプライン テンプレートの新しいリリースにアップグレードする場合は、フォルダーへの追加をすべて受け入れます。