Definieren Der klassischen Pipeline
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019 | TFS 2018
Hinweis
In Microsoft Team Foundation Server (TFS) 2018 und früheren Versionen werden Build- und Release-Pipelines als Definitionen bezeichnet, Ausführungen werden als Builds bezeichnet, Dienstverbindungen werden als Dienstendpunkte bezeichnet, Stages werden als Umgebungen bezeichnet und Aufträge werden als Phasen bezeichnet.
Azure Pipelines bieten eine sehr konfigurierbare und überschaubare Pipeline für Versionen in mehreren Phasen wie Entwicklung, Staging, QA und Produktion. es bietet auch die Möglichkeit, Gates und Genehmigungen in jeder bestimmten Phase umzusetzen.
In diesem Tutorial lernen Sie Folgendes:
- Fortlaufende Bereitstellungsauslöser
- Hinzufügen von Phasen
- Hinzufügen von Vorabbereitstellungsgenehmigungen
- Erstellen von Versionen und Überwachung von Bereitstellungen
Voraussetzungen
Sie benötigen Folgendes:
Eine Releasepipeline, die mindestens eine Phase enthält. Wenn Sie noch keines haben, können Sie sie erstellen, indem Sie eine der folgenden Schnellstarts und Lernprogramme durchlaufen:
Zwei separate Ziele, an denen Sie die App bereitstellen. Diese können virtuelle Computer, Webserver, lokale physische Bereitstellungsgruppen oder andere Arten von Bereitstellungszielen sein. In diesem Beispiel verwenden wir Azure App Service Websiteinstanzen. Wenn Sie sich entscheiden, dasselbe zu tun, müssen Sie Namen auswählen, die eindeutig sind, aber es empfiehlt sich, "QA" im Namen einer und "Produktion" im Namen der anderen einzuschließen, damit Sie sie einfach identifizieren können. Verwenden Sie die Azure-Portal, um eine neue Web-App zu erstellen.
Fortlaufende Bereitstellung (CD)-Trigger
Durch aktivieren des fortlaufenden Bereitstellungsauslösers wird die Pipeline aufgefordert, jedes Mal, wenn ein neuer Build verfügbar ist, automatisch eine neue Version zu erstellen.
Öffnen Sie in Azure Pipelines die Registerkarte "Versionen ". Wählen Sie ihre Releasepipeline aus, und wählen Sie "Bearbeiten" aus.
Wählen Sie das Symbol " Fortlaufende Bereitstellungsauslöser " im Abschnitt "Artefakte" aus, um den Triggerbereich zu öffnen. Stellen Sie sicher, dass dies aktiviert ist, damit eine neue Version erstellt wird, nachdem jeder neue erfolgreiche Build abgeschlossen wurde.
Wählen Sie das Symbol " Vorbereitstellungsbedingungen " im Abschnitt "Phasen " aus, um den Bereich "Bedingungen" zu öffnen. Stellen Sie sicher, dass der Trigger für die Bereitstellung in dieser Phase auf "After release" festgelegt ist. Dies bedeutet, dass eine Bereitstellung automatisch initiiert wird, wenn eine neue Version aus dieser Releasepipeline erstellt wird.
Sie können auch Release-Trigger, Phasenauslöser oder Bereitstellungen planen.
Hinzufügen von Phasen
In diesem Abschnitt fügen wir zwei neue Phasen zu unserer Releasepipeline hinzu: QA und Produktion (Zwei Azure-App Services-Websites in diesem Beispiel). Dies ist ein typisches Szenario, in dem Sie zunächst auf einem Test- oder Stagingserver bereitstellen würden, und dann auf einen Live- oder Produktionsserver. Jede Phase stellt ein Bereitstellungsziel dar.
Wählen Sie die Registerkarte "Pipeline " in Ihrer Releasepipeline aus, und wählen Sie die vorhandene Phase aus. Ändern Sie den Namen Ihrer Phase in "Produktion".
Wählen Sie die Dropdownliste + Hinzufügen aus, und wählen Sie die Klonphase aus (die Klonoption ist nur verfügbar, wenn eine vorhandene Stufe ausgewählt ist).
Normalerweise möchten Sie die gleichen Bereitstellungsmethoden mit einem Test und einer Produktionsstufe verwenden, damit Sie sicherstellen können, dass Ihre bereitgestellten Apps auf dieselbe Weise verhalten. Das Klonen einer vorhandenen Phase ist eine gute Möglichkeit, sicherzustellen, dass Sie die gleichen Einstellungen für beide haben. Anschließend müssen Sie die Bereitstellungsziele ändern.
Ihre geklonte Phase verfügt über den Namen "Kopie der Produktion". Wählen Sie ihn aus, und ändern Sie den Namen in QA.
Um die Phasen in der Pipeline neu zu organisieren, wählen Sie das Symbol " Vorbereitstellungsbedingungen " in Ihrer QA-Phase aus, und legen Sie den Trigger auf "After release" fest. Das Pipelinediagramm zeigt dann die beiden Phasen parallel an.
Wählen Sie das Symbol "Vorbereitstellungsbedingungen" in Ihrer Produktionsstufe aus, und legen Sie den Trigger auf"Nach Der Phase" fest, und wählen Sie dann in der Dropdownliste "Phasen" DIE QA aus. Das Pipelinediagramm gibt nun an, dass die beiden Phasen in der richtigen Reihenfolge ausgeführt werden.
Hinweis
Sie können Ihre Bereitstellung einrichten, um zu beginnen, wenn eine Bereitstellung in der vorherigen Phase teilweise erfolgreich ist. Dies bedeutet, dass die Bereitstellung auch dann fortgesetzt wird, wenn eine bestimmte nicht kritische Aufgabe fehlgeschlagen ist. Dies wird in der Regel in einer Freihand- und Verknüpfungsbereitstellung verwendet, die parallel zu verschiedenen Phasen bereitgestellt wird.
Wählen Sie die Dropdownliste "Aufgaben " aus, und wählen Sie die QA-Phase aus.
Je nachdem, welche Aufgaben Sie verwenden, ändern Sie die Einstellungen so, dass diese Phase für Ihr "QA"-Ziel bereitgestellt wird. In unserem Beispiel wird die Bereitstellung Azure App Service Aufgabe wie unten dargestellt verwendet.
Hinzufügen von Vorabbereitstellungsgenehmigungen
Die Veröffentlichungspipeline, die wir zuvor geändert haben, hat die Bereitstellung für QA und Produktion geändert. Wenn die Bereitstellung für QA fehlschlägt, löst die Bereitstellung für die Produktion nicht aus. Es wird empfohlen, immer zu überprüfen, ob Ihre App in QA- oder Testphase ordnungsgemäß funktioniert, bevor Sie die Produktion bereitstellen. Das Hinzufügen von Genehmigungen stellt sicher, dass alle Kriterien erfüllt sind, bevor sie in der nächsten Phase bereitgestellt werden. Führen Sie die folgenden Schritte aus, um Ihrer Pipeline Genehmigungen hinzuzufügen:
Wählen Sie die Registerkarte "Pipeline" aus, Symbol "Vorbereitstellungsbedingungen" und dann "Vorabbereitstellungs-Genehmigungen".
Geben Sie im Textfeld "Genehmigende Personen" den Benutzer ein, der für die Genehmigung der Bereitstellung verantwortlich ist. Außerdem empfiehlt es sich, das Kontrollkästchen " Der Benutzer, der eine Version anfordert" oder "Bereitstellung" zu deaktivieren, sollte es nicht genehmigen .
Sie können so viele Genehmigende hinzufügen, wie Sie benötigen, sowohl einzelne Benutzer als auch Organisationsgruppen. Es ist auch möglich, Nachbereitstellungsgenehmigungen einzurichten, indem Sie das Symbol "Benutzer" auf der rechten Seite der Stufe im Pipelinediagramm auswählen. Weitere Informationen finden Sie unter "Versionen von Gates und Genehmigungen".
Wählen Sie Speichern.
Erstellen eines Release
Nachdem das Releasepipeline-Setup abgeschlossen ist, ist es zeit, die Bereitstellung zu starten. Dazu erstellen wir manuell eine neue Version. In der Regel wird automatisch eine Version erstellt, wenn ein neues Buildartefakt verfügbar ist. In diesem Szenario erstellen wir es jedoch manuell.
Wählen Sie die Dropdownliste "Release " aus, und wählen Sie "Version erstellen" aus.
Geben Sie eine Beschreibung für Ihre Version ein, überprüfen Sie, ob die richtigen Artefakte ausgewählt sind, und wählen Sie dann "Erstellen" aus.
Ein Banner wird angezeigt, das angibt, dass eine neue Version erstellt wurde. Wählen Sie den Link "Release" aus, um weitere Details anzuzeigen.
Auf der Releasezusammenfassungsseite wird der Status der Bereitstellung in jeder Phase angezeigt.
In anderen Ansichten (etwa in der Liste mit den Releases) wird auch ein Symbol angezeigt, das darauf hinweist, dass die Genehmigung aussteht. Das Symbol zeigt ein Popup, das den Namen der Stufe enthält und weitere Details enthält, wenn Sie darauf verweisen. So kann ein Administrator ganz einfach erkennen, bei welchen Releases eine Genehmigung aussteht, und sich über den Gesamtstatus aller Releases informieren.
Wählen Sie das symbol pending_approval aus, um den Genehmigungsfensterbereich zu öffnen. Geben Sie einen kurzen Kommentar ein, und wählen Sie "Genehmigen" aus.
Hinweis
Sie können die Bereitstellung zu einem späteren Zeitpunkt planen, z. B. während nicht spitzen Stunden. Sie können die Genehmigung auch einem anderen Benutzer zuweisen. Versionsadministratoren können auf alle Genehmigungsentscheidungen zugreifen und außer Kraft setzen.
Überwachen und Nachverfolgen von Bereitstellungen
Bereitstellungsprotokolle helfen Ihnen beim Überwachen und Debuggen der Veröffentlichung Ihrer Anwendung. Führen Sie die folgenden Schritte aus, um die Protokolle unserer Bereitstellung zu überprüfen:
Zeigen Sie in der Versionszusammenfassung auf eine Phase, und wählen Sie "Protokolle" aus.
Während der Bereitstellung können Sie weiterhin auf die Protokollseite zugreifen, um die Liveprotokolle jeder Aufgabe anzuzeigen.
Wählen Sie einen beliebigen Vorgang aus, um die Protokolle für diesen bestimmten Vorgang anzuzeigen. Dies erleichtert das Nachverfolgen und Debuggen von Bereitstellungsproblemen. Sie können auch einzelne Aufgabenprotokolle oder eine ZIP-Datei aller Protokolldateien herunterladen.
Wenn Sie zusätzliche Informationen zum Debuggen Ihrer Bereitstellung benötigen, können Sie die Version im Debugmodus ausführen.