ALM Accelerator for Power Platform フック拡張機能の構成
ALM Accelerator for Power Platform パイプライン テンプレートには、パイプラインのカスタマイズに使用できるいくつかの拡張ポイントがあります。 これらの拡張ポイントまたはフックを使用すると、アップグレード シナリオでのマージの競合によるノイズを最小限に抑えながら、パイプラインをカスタマイズできます。
ALM Accelerator for Power Platform 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 |
ALM Accelerator for Power Platform YAML テンプレートの拡張ポイントを使用する
拡張ポイントを使用して ALM アクセラレータ パイプライン機能を拡張するには、拡張機能を 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 アクセラレータ パイプライン テンプレートをアップグレードする際のマージ競合の処理
Note
ALM アクセラレータ パイプライン テンプレートの新しいリリースにアップグレードするときにマージの競合を解決するために、Azure DevOps の プル要求マージ競合拡張機能を使用することをお勧めします。
何らかの方法で ALM アクセラレータ パイプライン テンプレートをカスタマイズすると、ALM アクセラレータ パイプライン テンプレートを新しいリリースにアップグレードするときにマージ競合が発生します。
拡張ポイントは、パイプラインのカスタマイズに拡張ポイントを使用する場合に、このようなマージの競合を簡単に処理できるように実装されています。
ALM アクセラレータ パイプライン テンプレートの新しいリリースにアップグレードするときは、Hooks フォルダ内のファイルへの独自の変更を保持し、フォルダへの追加を受け入れます。