Pipeline-Erweiterungspunkte konfigurieren
Die Pipeline-Vorlagen darin ALM Accelerator for Power Platform haben mehrere Erweiterungspunkte oder Hooks. Sie können sie zum Anpassen der Pipelines verwenden und gleichzeitig den Lärm durch Zusammenführungskonflikte minimieren, wenn Sie die Pipeline-Vorlagen auf eine neue Version aktualisieren.
Erweiterungspunkte in ALM Accelerator YAML-Vorlagen
In der folgenden Tabelle sind die unterstützten Erweiterungspunkte aufgeführt.
| Pipeline-YAML-Dateiname | Erweiterungspunkt | Eigenschaft | Erweiterungs-YAML-Datei |
|---|---|---|---|
| Templates/export-Solution.yml | Pre Hook der Lösung exportieren | Fügt Anpassungen als anfängliches Schritt in der Exportlösungspipeline hinzu. | Hooks/export-solution-pre-hook.yml |
| Templates/export-Solution.yml | Pre Hook zum Entpacken der Lösung | Fügt vor dem Entpacken der Lösung Anpassungen hinzu. | Hooks/export-solution-unpack-pre-hook.yml |
| Templates/export-Solution.yml | Manipulieren Sie den Pre-Hook | Fügt Anpassungen vor der Bearbeitung von Lösungsdateien hinzu. | Hooks/export-solution-manipulate-pre-hook.yml |
| Templates/export-Solution.yml | Aktualisieren der Bereitstellunseinstellungen für den Pre-Hook | Fügt Anpassungen hinzu, bevor die Bereitstellungseinstellungen aktualisiert werden. | Hooks/export-solution-update-deploymentsettings-pre-hook.yml |
| Templates/export-Solution.yml | Pre Hook zum Committen der Lösung | Fügt Anpassungen hinzu, bevor der Quellcode der Lösung in Git festgeschrieben wird. | Hooks/export-solution-commit-pre-hook.yml |
| Templates/export-Solution.yml | Post Hook der Lösung exportieren | Fügt Anpassungen als letztes Schritt in der Exportlösungspipeline hinzu. | Hooks/export-solution-post-hook.yml |
| Templates/build-Solution.yml | Pre Hook zum für Erstellen der Lösung | Fügt Anpassungen als anfängliches Schritt in der Build-Lösungspipeline hinzu. | Hooks/build-solution-pre-hook.yml |
| Templates/build-Solution.yml | Manipulieren Sie den Pre-Hook | Fügt Anpassungen vor der Bearbeitung von Lösungsdateien hinzu. | Hooks/build-solution-manipulate-pre-hook.yml |
| Templates/build-Solution.yml | Pre Hook zum Packen der Lösung | Fügt Anpassungen hinzu, bevor die Lösung aus dem Quellcode gepackt wird. | Hooks/build-solution-pack-pre-hook.yml |
| Templates/build-Solution.yml | Post Hook zum für Erstellen der Lösung | Fügt Anpassungen als letztes Schritt in der Build-Lösungspipeline hinzu. | Hooks/build-solution-post-hook.yml |
| Templates/deploy-Solution.yml | Pre Hook zum Bereitstellen der Lösung | Fügt Anpassungen als anfängliches Schritt in der Bereitstellungslösungspipeline hinzu. | Hooks/deploy-solution-pre-hook.yml |
| Templates/deploy-Solution.yml | Pre Hook der Lösung importieren | Fügt Anpassungen hinzu, bevor die Lösung importiert wird. | Hooks/deploy-solution-import-pre-hook.yml |
| Templates/deploy-Solution.yml | Pre Hook der Lösung konfigurieren | Fügt Anpassungen vor der Konfiguration der bereitgestellten Lösung hinzu. | Hooks/deploy-solution-configure-pre-hook.yml |
| Templates/deploy-Solution.yml | Post Hook zum Bereitstellen der Lösung | Fügt Anpassungen als letztes Schritt in der Build-Lösungspipeline hinzu. | Hooks/deploy-solution-post-hook.yml |
Verwenden von Erweiterungspunkten in den YAML-Vorlagen
Um die Funktionalität der ALM Accelerator-Pipelines mithilfe der Erweiterungspunkte zu erweitern, fügen Sie Ihre Erweiterung entweder einer benutzerdefinierten YAML-Vorlage im Ordner Hooks/CustomTemplates oder direkt der YAML-Datei für die Erweiterung zeigen hinzu, die Sie verwenden möchten.
Im folgenden Beispiel wird die Export Solution Pre Hook Erweiterung zeigen verwendet, um die Vorlage Hooks\CustomTemplates\output-environment-variables.yml in der Export-solution.yml Pipeline anzupassen.
Fügen Sie der Datei Export-solution-pre-hook.yml den folgenden Code hinzu:
- template: CustomTemplates/output-environment-variables.yml
Die Export-solution-pre-hook.yml Datei sollte folgendermaßen aussehen:
steps:
- script: echo Export Solution Pre Hook
displayName: 'Export Solution Pre Hook'
enabled: false
- template: CustomTemplates/output-environment-variables.yml
Behandeln von Zusammenführungskonflikten beim Upgrade angepasster Pipeline-Vorlagen
Anmerkung
Um Ihnen beim Beheben von Zusammenführungskonflikten beim Upgrade auf eine neue Version der ALM Accelerator-Pipeline-Vorlagen zu helfen, empfehlen wir die Pull Request Merge Conflict-Erweiterung für Azure DevOps.
Wenn Sie Anpassungen an den ALM Accelerator-Pipeline-Vorlagen vornehmen, treten beim Upgrade der Vorlagen auf eine neue Version Zusammenführungskonflikte auf.
Die Erweiterungspunkte sind so implementiert, dass die Handhabung von Zusammenführungskonflikten vereinfacht werden sollte, wenn Sie diese zum Anpassen der Pipelines verwendet haben. Bewahren Sie Ihre geänderte Version einer Datei im Ordner Hooks auf. Wenn Sie auf eine neue Version der ALM Accelerator-Pipeline-Vorlagen aktualisieren, akzeptieren Sie alle Ergänzungen zum Ordner.