Lernprogramm: Bereitstellen auf virtuellen Linux-Computern mit Jenkins und Azure DevOps Services

Die kontinuierliche Integration (Continuous Integration, CI) und die kontinuierliche Bereitstellung (Continuous Deployment, CD) bilden eine Pipeline, über die Sie Ihren Code erstellen, freigeben und bereitstellen können. Azure DevOps Services bietet einen vollständigen Satz von CI/CD-Automatisierungstools für die Bereitstellung in Azure. Jenkins ist ein beliebtes CI/CD-Server-basiertes Tool von Drittanbietern, das auch CI/CD-Automatisierung bereitstellt. Sie können Azure DevOps Services und Jenkins zusammen verwenden, um anzupassen, wie Sie Ihre Cloud-App oder Ihren Dienst bereitstellen.

In diesem Lernprogramm verwenden Sie Jenkins, um eine Node.js Web-App zu erstellen. Anschließend verwenden Sie Azure DevOps, um es bereitzustellen.

zu einer Bereitstellungsgruppe , die virtuelle Linux-Computer (VMs) enthält. Hier erfahren Sie, wie Sie:

Voraussetzungen

• Azure-Abonnement: Wenn Sie nicht über ein Azure-Abonnement verfügen, erstellen Sie ein kostenloses Azure-Konto , bevor Sie beginnen.

• Jenkins-Server: Wenn Sie keinen Jenkins-Server installiert haben, erstellen Sie einen Jenkins-Server in Azure.

  Hinweis

  Weitere Informationen finden Sie unter Herstellen einer Verbindung mit Azure DevOps Services.

• Sie benötigen einen virtuellen Linux-Computer für ein Bereitstellungsziel. Weitere Informationen finden Sie unter Erstellen und Verwalten von Linux-VMs mit der Azure CLI.

• Öffnen Sie den eingehenden Port 80 für Ihren virtuellen Computer. Weitere Informationen finden Sie unter Erstellen von Netzwerksicherheitsgruppen mithilfe des Azure-Portals.

Abrufen der Beispiel-App

Sie benötigen eine App zum Bereitstellen, die in einem Git-Repository gespeichert ist. Für dieses Lernprogramm empfehlen wir, diese Beispiel-App zu verwenden, die auf GitHub verfügbar ist. Dieses Lernprogramm enthält ein Beispielskript, das zum Installieren von Node.js und einer Anwendung verwendet wird. Wenn Sie mit Ihrem eigenen Repository arbeiten möchten, sollten Sie ein ähnliches Beispiel konfigurieren.

Erstellen Sie einen Fork dieser App und notieren Sie sich die Adresse (URL) für die Verwendung in späteren Schritten dieses Tutorials. Weitere Informationen finden Sie unter Fork a repo.

Konfigurieren von Jenkins-Plug-Ins

Zunächst müssen Sie zwei Jenkins-Plug-Ins konfigurieren: NodeJS und VS Team Services Continuous Deployment.

1. Öffnen Sie Ihr Jenkins-Konto, und wählen Sie "Jenkins verwalten" aus.
2. Wählen Sie auf der Seite "Jenkins verwalten" die Option "Plug-Ins verwalten" aus.
3. Filtern Sie die Liste, um das NodeJS-Plug-In zu suchen, und wählen Sie die Option "Installieren ohne Neustart" aus.
4. Filtern Sie die Liste, um das Plug-In für die kontinuierliche Bereitstellung von VS Team Services zu finden, und wählen Sie die Option "Installieren ohne Neustart " aus.
5. Wechseln Sie zurück zum Jenkins-Dashboard, und wählen Sie "Jenkins verwalten" aus.
6. Wählen Sie "Globale Toolkonfiguration" aus. Suchen Sie NodeJS , und wählen Sie NodeJS-Installationen aus.
7. Wählen Sie die Option "Automatisch installieren" aus, und geben Sie dann einen Namenwert ein.
8. Wählen Sie Speichern aus.

Konfigurieren Sie ein Jenkins-Freestyle-Projekt für Node.js

1. Wählen Sie "Neues Element" aus. Geben Sie einen Elementnamen ein.
2. Wählen Sie das Projekt "Freestyle" aus. Wählen Sie OK aus.
3. Wählen Sie auf der Registerkarte "Quellcodeverwaltung " Git aus, und geben Sie die Details des Repositorys und der Verzweigung ein, die Ihren App-Code enthalten.
   
4. Wählen Sie auf der Registerkarte " Buildtriggers " "Umfrage-SCM " aus, und geben Sie den Zeitplan H/03 * * * * ein, um das Git-Repository für Änderungen alle drei Minuten abzufragen.
5. Wählen Sie auf der Registerkarte "Buildumgebung" die Option "Node- und npm-bin/Ordner-Pfad bereitstellen" und dann den NodeJS-Installationswert aus. Lassen Sie die npmrc-Datei so eingestellt, dass die Systemstandardeinstellung verwendet wird.
6. Wählen Sie auf der Registerkarte " Build " die Option "Shell ausführen " aus, und geben Sie den Befehl npm install ein, um sicherzustellen, dass alle Abhängigkeiten aktualisiert werden.

Konfigurieren der Integration von Jenkins für Azure DevOps Services

1. Erstellen Sie einen PAT in Ihrer Azure DevOps Services-Organisation, wenn Sie noch keines haben. Jenkins erfordert diese Informationen für den Zugriff auf Ihre Azure DevOps Services-Organisation. Achten Sie darauf, die Tokeninformationen für anstehende Schritte in diesem Abschnitt zu speichern.

   Informationen zum Generieren eines Tokens finden Sie unter "Wie erstelle ich ein persönliches Zugriffstoken für Azure DevOps Services?".

2. Wählen Sie auf der Registerkarte "Aktionen nach dem Build" die Option "Aktion nach dem Erstellen hinzufügen" aus. Wählen Sie " Artefakte archiviert" aus.

3. Für Dateien zum Archivieren, geben Sie **/* ein, um alle Dateien einzuschließen.

4. Um eine weitere Aktion zu erstellen, wählen Sie die Aktion "Nach dem Erstellen hinzufügen" aus.

5. Wählen Sie "Trigger release" in TFS/Team Services aus. Geben Sie den URI für Ihre Azure DevOps Services-Organisation ein, z. B. https://{your-organization-name}.visualstudio.com.

6. Geben Sie den Projektnamen ein.

7. Wählen Sie einen Namen für die Releasepipeline aus. (Sie erstellen diese Releasepipeline später in Azure DevOps Services.)

8. Wählen Sie Anmeldeinformationen aus, um eine Verbindung mit Ihrer Azure DevOps Services- oder Azure DevOps Server-Umgebung herzustellen:

   • Lassen Sie "Benutzername " leer, wenn Sie Azure DevOps Services verwenden.
   • Geben Sie einen Benutzernamen und ein Kennwort ein, wenn Sie eine lokale Version von Azure DevOps Server verwenden.
     

9. Speichern Sie das Projekt Jenkins.

Erstellen eines Jenkins-Dienstendpunkts

Ein Dienstendpunkt ermöglicht Azure DevOps Services, eine Verbindung mit Jenkins herzustellen.

1. Öffnen Sie die Seite "Dienste " in Azure DevOps Services, öffnen Sie die Liste " Neuer Dienstendpunkt ", und wählen Sie "Jenkins" aus.
2. Geben Sie einen Namen für die Verbindung ein.
3. Geben Sie die URL Ihres Jenkins-Servers ein, und wählen Sie die Option "Nicht vertrauenswürdige SSL-Zertifikate akzeptieren " aus. Eine Beispiel-URL ist http://{YourJenkinsURL}.westcentralus.cloudapp.azure.com.
4. Geben Sie den Benutzernamen und das Kennwort für Ihr Jenkins-Konto ein.
5. Wählen Sie "Verbindung überprüfen" aus, um zu überprüfen, ob die Informationen korrekt sind.
6. Wählen Sie "OK" aus, um den Dienstendpunkt zu erstellen.

Erstellen einer Bereitstellungsgruppe für virtuelle Azure-Computer

Sie benötigen eine Bereitstellungsgruppe , um den Azure DevOps Services-Agent zu registrieren, damit die Releasepipeline auf Ihrem virtuellen Computer bereitgestellt werden kann. Bereitstellungsgruppen erleichtern das Definieren logischer Gruppen von Zielcomputern für die Bereitstellung und die Installation des erforderlichen Agents auf jedem Computer.

1. Öffnen Sie die Registerkarte "Versionen " des Build & Release-Hubs , öffnen Sie Bereitstellungsgruppen, und wählen Sie +Neu.
2. Geben Sie einen Namen für die Bereitstellungsgruppe und eine optionale Beschreibung ein. Wählen Sie dann Erstellen aus.
3. Wählen Sie das Betriebssystem für den virtuellen Bereitstellungszielcomputer aus. Wählen Sie beispielsweise Ubuntu 16.04+ aus.
4. Klicken Sie auf Verwenden Sie für die Authentifizierung ein persönliches Zugriffstoken im Skript.
5. Wählen Sie den Link " Systemvoraussetzungen" aus. Installieren Sie die erforderlichen Komponenten für Ihr Betriebssystem.
6. Wählen Sie "Skript in Zwischenablage kopieren" aus, um das Skript zu kopieren.
7. Melden Sie sich bei Ihrem virtuellen Bereitstellungszielcomputer an, und führen Sie das Skript aus. Führen Sie das Skript nicht mit sudo-Berechtigungen aus.
8. Nach der Installation werden Sie zur Eingabe von Tags für Bereitstellungsgruppen aufgefordert. Übernehmen Sie die Standardeinstellungen.
9. Überprüfen Sie in Azure DevOps Services unter Bereitstellungsgruppen die Ziele für Ihren neu registrierten virtuellen Computer in Ziele.

Erstellen einer Release-Pipeline für Azure Pipelines

Eine Releasepipeline gibt den Prozess an, den Azure Pipelines zum Bereitstellen der App verwendet. In diesem Beispiel führen Sie ein Shellskript aus.

So erstellen Sie die Releasepipeline in Azure-Pipelines:

1. Öffnen Sie die Registerkarte "Versionen " des Build & Release-Hubs , und wählen Sie " Releasepipeline erstellen" aus.
2. Wählen Sie die leere Vorlage aus, indem Sie mit einem leeren Verfahren beginnen.
3. Wählen Sie im Abschnitt " Artefakte " + "Artefakt hinzufügen" und dann "Jenkins " für den Quelltyp aus. Wählen Sie Ihre Jenkins-Dienstendpunktverbindung aus. Wählen Sie dann den Jenkins-Quellauftrag und dann "Hinzufügen" aus.
4. Wählen Sie das Auslassungszeichen neben "Umgebung 1" aus. Wählen Sie " Bereitstellungsgruppenphase hinzufügen" aus.
5. Wählen Sie Ihre Bereitstellungsgruppe aus.
6. Wählen Sie diese Option + aus, um eine Aufgabe zur Bereitstellungsgruppenphase hinzuzufügen.
7. Wählen Sie die Shellskriptaufgabe und dann "Hinzufügen" aus. Die Shellskriptaufgabe stellt die Konfiguration für ein Skript bereit, das auf jedem Server ausgeführt werden soll, um Node.js zu installieren und die App zu starten.
8. Geben Sie für Skriptpfad, $(System.DefaultWorkingDirectory)/Fabrikam-Node/deployscript.sh ein.
9. Wählen Sie "Erweitert" aus, und aktivieren Sie dann " Arbeitsverzeichnis angeben".
10. Für Arbeitsverzeichnis geben Sie $(System.DefaultWorkingDirectory)/Fabrikam-Node ein.
11. Bearbeiten Sie den Namen der Release-Pipeline zu dem Namen, den Sie auf der Registerkarte "Aktionen nach dem Build" des Builds in Jenkins angegeben haben. Jenkins erfordert, dass dieser Name eine neue Version auslösen kann, wenn die Quellartefakte aktualisiert werden.
12. Wählen Sie "Speichern" und dann "OK " aus, um die Releasepipeline zu speichern.

Ausführen von manuellen und durch CI ausgelösten Bereitstellungen

1. Wählen Sie +Release aus, und wählen Sie "Release erstellen" aus.
2. Wählen Sie den Build aus, den Sie in der hervorgehobenen Dropdownliste abgeschlossen haben, und wählen Sie Queue.
3. Wählen Sie den Freigabelink in der Popupnachricht aus. Beispiel: " Release Release-1 wurde erstellt."
4. Öffnen Sie die Registerkarte Protokolle, um die Ausgabe der Release-Konsole anzuzeigen.
5. Öffnen Sie in Ihrem Browser die URL eines der Server, die Sie Ihrer Bereitstellungsgruppe hinzugefügt haben. Geben Sie z. B. http://{your-server-ip-address} ein.
6. Gehen Sie zum Git-Quell-Repository und ändern Sie den Inhalt der h1-Überschrift in der Datei app/views/index.jade mit geändertem Text.
7. Committen Sie Ihre Änderung.
8. Nach ein paar Minuten wird auf der Releases-Seite von Azure DevOps eine neue Version erstellt. Öffnen Sie das Release, um den Fortschritt der Bereitstellung zu sehen. Glückwunsch!

Problembehandlung beim Jenkins-Plug-In

Wenn Fehler mit den Jenkins-Plug-Ins auftreten, geben Sie ein Problem in der JIRA von Jenkins für die jeweilige Komponente ein.

Nächste Schritte

In diesem Lernprogramm automatisieren Sie die Bereitstellung einer App auf Azure mithilfe von Jenkins für build und Azure DevOps Services für die Veröffentlichung. Sie haben gelernt, wie Sie:

Weitere Informationen zur Verwendung von Azure-Pipelines für build- und release-Schritte finden Sie hier.

Wenn Sie erfahren möchten, wie Sie eine YAML-basierte CI/CD-Pipeline für die Bereitstellung auf VMs erstellen, wechseln Sie zum nächsten Lernprogramm.