注
ALM アクセラレータは非推奨となり、新機能は追加されません。 問題のレビューや対処は行われません。
潜在的なセキュリティの問題を特定した場合は、Microsoft Security Response Centerに報告してください。
Power Platform のパイプラインを使用して、ALM 自動化機能を Power Platform および Dynamics 365 サービスに提供します。 パイプラインは、source コード統合または extended と共に使用して、Azure DevOps、GitHub、およびその他のプロバイダーと統合できます。
ALM Accelerator for Power Platform のパイプライン テンプレートには、いくつかの拡張ポイント、つまり フックがあります。 これらを使用すると、パイプライン テンプレートを新しいリリースにアップグレードするときに、マージ競合によるノイズを最小限に抑えながらパイプラインをカスタマイズできます。
ALM Accelerator YAMLテンプレートの拡張ポイント
次の表に、サポートされている拡張ポイントを示します。
| パイプライン YAML ファイル名 | 拡張ポイント | Description | 拡張 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 | ソリューションの構成Pre Hook | 展開されたソリューションを構成する前にカスタマイズを追加します。 | Hooks/deploy-solution-configure-pre-hook.yml |
| Templates/deploy-Solution.yml | ソリューションの展開後処理 | ビルド ソリューション パイプラインの最後の 手順 としてカスタマイズを追加します。 | Hooks/deploy-solution-post-hook.yml |
YAMLテンプレートで拡張ポイントを使用する
拡張ポイントを使用して ALM Accelerator パイプラインの機能を拡張するには、Hooks/CustomTemplates フォルダー内のカスタム YAML テンプレートに拡張機能を追加するか、使用したい拡張ポイントの YAML ファイルに直接拡張機能を追加します。
次の例では、エクスポート ソリューション事前フック拡張ポイントを使用して、Hooks\CustomTemplates\output-environment-variables.ymlテンプレートをexport-solution.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 アクセラレータ パイプライン テンプレートの新しいリリースにアップグレードするときのマージ競合を解決するには、Azure DevOpsの Pull Request Merge Conflict extension をお勧めします。
ALM Acceleratorパイプライン テンプレートをカスタマイズすると、テンプレートを新しいリリースにアップグレードするときにマージの競合が発生します。
拡張ポイントは、パイプラインをカスタマイズするために使用した場合にマージ競合を簡単に処理できるように実装されています。 ファイルの変更バージョンを Hooks フォルダーに保存します。 ALM Acceleratorパイプライン テンプレートの新しいリリースにアップグレードする場合は、フォルダーへの追加をすべて受け入れます。