Konfigurieren von Pipelineerweiterungspunkten (veraltet)

Note

Der ALM Accelerator ist veraltet und wird in einer zukünftigen Version entfernt. Verwenden Sie Pipelines in Power Platform , um ALM-Automatisierungsfunktionen zu Power Platform- und Dynamics 365-Diensten zu bringen. Pipelines können mit der Quellcodeintegration verwendet oder so entwickelt werden, dass sie sich auch mit anderen Anbietern integrieren lassen.

Die Pipeline-Vorlagen des ALM Accelerators für 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 Description 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 Bereitstellungseinstellungen für Pre-Hook aktualisieren Fügt Anpassungen hinzu, bevor die Bereitstellungseinstellungen aktualisiert werden. Hooks/export-solution-update-deploymentsettings-pre-hook.yml
Templates/export-Solution.yml Pre-Commit-Hook für die 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
Vorlagen/build-Lösung.yml Pre-Hook zur Lösungserstellung Fügt Anpassungen als anfängliches Schritt in der Build-Lösungspipeline hinzu. Hooks/build-solution-pre-hook.yml
Vorlagen/build-Lösung.yml Manipulieren Sie den Pre-Hook Fügt Anpassungen vor der Bearbeitung von Lösungsdateien hinzu. Hooks/build-solution-manipulate-pre-hook.yml
Vorlagen/build-Lösung.yml Pre-Hook für Lösungs-Paket Fügt Anpassungen hinzu, bevor die Lösung aus dem Quellcode gepackt wird. Hooks/build-solution-pack-pre-hook.yml
Vorlagen/build-Lösung.yml Post-Hook für den Build 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 Konfigurieren des Pre-Hooks der Lösung 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 hinzu oder direkt zur YAML-Datei für den Erweiterungspunkt, den Sie verwenden möchten.

Im folgenden Beispiel wird der Export Solution Pre Hook Erweiterungspunkt 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 sollte folgendermaßen aussehen:

steps:
- script: echo Export Solution Pre Hook
  displayName: 'Export Solution Pre Hook'
  enabled: false

- template: CustomTemplates/output-environment-variables.yml

Behandlung von Zusammenführungskonflikten bei der Aktualisierung angepasster Pipeline-Vorlagen

Note

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 Konfliktlösung bei Zusammenführungen vereinfacht wird, wenn Sie sie zur Anpassung 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.

Nächste Schritte