Teil 3: Eine CD-Toolchain einrichten

Mit diesem Tutorial können Sie die Toolchain-Vorlage für die kontinuierliche Bereitstellung (CD) verwenden. Die Vorlage ist mit den Einstellungen vorkonfiguriert. Sie können Ihre Konfiguration validieren und bereitstellen, um das Tutorial abzuschließen.

Vorbereitende Schritte

Vervollständigen Sie die Einrichtung der Voraussetzungen.
Vervollständigen Sie die Einrichtung einer CI-Toolchain.
Sehen Sie sich das folgende Video an:

Siehe die DevSecOps-Praktiken zur Bereitstellung einer sicheren CD-Anwendung.

Setup der CD-Toolchain starten

Der Continuous Delivery-Dienst bietet Vorlagen, die Sie durch die Einrichtung der CD-Toolchain führen. Folgen Sie den Schritten, um auf die Vorlage für die CD-Toolchain zuzugreifen.

Klicken Sie in der IBM Cloud-Konsole auf das Menüsymbol > Plattformautomatisierung > Toolchains.
Klicken Sie auf der Seite 'Toolchains' auf die Option Toolchain erstellen.
Klicken Sie auf die Kachel CD - Deployment a secure app with DevSecOps practices, um die Vorlage anzuzeigen.

Toolchain-Einstellungen einrichten

Die Seite Willkommen fasst den Zweck der Toolchain zusammen und enthält Verweise auf die Dokumentation und zugehörige Materialien.

Klicken Sie auf Starten.
Geben Sie einen eindeutigen Namen für die Toolchain ein. Beachten Sie, dass die Toolchain-Region von der Cluster- und der Container Registry-Region abweichen kann.
Wählen Sie eine Region und Wählen Sie eine Ressourcengruppe sind aufgeführt. Hinweis Sie können die Regionen bearbeiten.
Optional können Sie die zugehörige Continuous Integration (CI) Toolchain aus dem Dropdown-Menü auswählen. Dies kopiert einen Teil der CI-Konfiguration, um die Einrichtung der CD-Toolchain zu erleichtern. Hinweis Damit werden möglicherweise einige der bereits eingegebenen Werte überschrieben.
Klicken Sie auf Weiter.

Der nächste Schritt kann erst aufgerufen werden, wenn die Konfiguration für den aktuellen Schritt ordnungsgemäß abgeschlossen ist. Sie können jederzeit auf Zurück klicken, um die vorherigen Schritte im Installationsassistenten anzuzeigen. Das Toolchain-Installationsprogramm behält alle Konfigurationseinstellungen aus den aufeinander folgenden Schritten bei.

Einige Schritte beinhalten eine Schaltfläche für die erweiterte Konfiguration. Diese Schritte zeigen Ihnen standardmäßig die Mindestkonfiguration auf. Fortgeschrittene Benutzer, die eine detailliertere Steuerung benötigen, können jedoch auf die Umschaltfläche Zur erweiterten Konfiguration wechseln klicken, um die Optionen für die zugrunde liegende Integration anzuzeigen.

Toolintegrationen einrichten

Wenn Sie in diesem Schritt bereits eine Verknüpfung zu einer bestehenden CI-Toolchain hergestellt haben, sind der Name der Toolchain, die Region, die Repositorys und andere Felder bereits ausgefüllt. Überprüfen Sie die Repository-URLs und fahren Sie dann mit den nächsten Schritten fort.

Bestand

Wählen Sie das Repository URL des Inventar-Repositorys aus, das in Ihrer CI-Toolchain konfiguriert ist.
Klicken Sie auf Weiter.

Probleme

Wählen Sie das Repository URL aus, um die Probleme aufzuzeichnen, während die CD-Pipeline läuft. Hinweis: Sie verwenden ein bestehendes Issues-Repository, das während der CI-Toolchain erstellt wurde.
Klicken Sie auf Weiter.

Pipeline-Konfiguration

Das Repository für die Pipeline-Konfiguration enthält YAML-Dateien und Skripte, die für die Bereitstellung, das Testen und andere benutzerdefinierte Aufgaben benötigt werden.

Übernehmen Sie die Standardeinstellungen für Quellanbieter.

Wenn Sie kein Konfigurationsrepository haben, aktivieren Sie die Umschaltfläche Erweiterte Konfiguration und wählen Sie den Typ Repository klonen aus. Die Toolchain klont die Beispielkonfiguration in Ihrer Git Organisation. Weitere Informationen über Git Repos finden Sie unter Konfigurieren Ihres Git Repos and Issue Tracking. Weitere Informationen über anpassbare Skripte finden Sie unter Benutzerdefinierte Skripte.
Geben Sie einen eindeutigen Neuen Repository-Namen ein.
Klicken Sie auf Weiter.

Geheime Schlüssel

Dieses Tutorial verwendet IBM Cloud® Secrets Manager als Tresor für Geheimnisse. Die Felder Region, Ressourcengruppe und Dienstleistungsname werden automatisch auf der Grundlage der verfügbaren Auswahlmöglichkeiten ausgefüllt. Klicken Sie auf die Dropdown-Anzeigen, um die anderen Auswahlmöglichkeiten zu sehen.
Geben Sie Ihren Secrets Manager Instanznamen ein.
Wählen Sie den Autorisierungstyp aus der Dropdown-Liste aus.
Klicken Sie auf Weiter.

Nachweisspeicher

Wählen Sie eine Vorhandene Asservatenkammer verwenden.
Wählen Sie das Repository URL aus, das bei der Konfiguration der CI-Toolchain (Continuous Integration) erstellt wurde. Weitere Informationen zur Speicherung von Beweisen finden Sie unter Beweise.
Schalten Sie den IBM Cloud Object Storage Schieberegler um, um alle Beweise im IBM Cloud Object Storage Schaufel zu speichern.
Klicken Sie auf Weiter.

Cloud-Bucket Object Storage

Überprüfen und akzeptieren Sie die automatisch ausgefüllten IBM Cloud Object Storage Details. Weitere Informationen zur Konfiguration eines Buckets, der als Schließfach für Compliance-Nachweise fungieren kann, finden Sie unter Konfiguration von Object Storage zur Speicherung von Nachweisen.
Geben Sie Ihren Service-API-Schlüssel an, um in eine IBM Cloud Object Storage-Instanz zu schreiben.
Klicken Sie auf Weiter.

Signieren von Artefakten

Geben Sie optional Code Signing Certificate ein, um die Gültigkeit der Signaturen für Artefakte zu überprüfen. Zum Beispiel Docker Artefakte, die von der CI-Pipeline erstellt und signiert werden, bevor sie in der Produktion eingesetzt werden.
Klicken Sie auf Weiter.

Implementierungsziel

Übernehmen Sie die Option Einzelner Cluster (Push-basierte Bereitstellung), um Ihre Anwendung auf Zielen wie virtuellen Serverinstanzen bereitzustellen, oder passen Sie den Bereitstellungsprozess mit der Option Benutzerdefiniert an.
Klicken Sie auf Fortfahren, um die Clusterseite anzuzeigen.
Geben Sie den IBM Cloud API-Schlüssel ein, um bei verschiedenen Aufgaben mit dem CLI-Tool zu interagieren. Hinweis Ein vorhandener Schlüssel kann durch Anklicken des Schlüsselsymbols aus einem Geheimnistresor importiert werden.
Überprüfen Sie Ihre Cluster-Region, Ressourcengruppe, Cluster-Name, und Cluster-Namensraum Felder, in denen Ihr Zielcluster erstellt wird.
Klicken Sie auf Weiter.

Änderungsanforderungsmanagement

Übernehmen Sie die eingegebenen Werte für die Verwaltung von Änderungsanträgen. Weitere Informationen finden Sie unter Änderungsmanagement automatisieren.
Geben Sie einen eindeutigen Neuen Repository-Namen ein.
Legen Sie den Zweck der Zielumgebung als Production fest.
Legen Sie das Ziel Umwelt Detail fest.
Klicken Sie auf Weiter.

Optionale Tools

Slack

Konfigurieren Sie den Slack, um Benachrichtigungen über Ihre Pull-Anfragen oder CI-Pipeline-Ereignisse zu erhalten. Sie können das Slack-Tool auch nach der Erstellung der Toolchain hinzufügen.

Geben Sie Ihren Slack-Webhook ein. Weitere Informationen finden Sie unter Slack webhook.
Geben Sie Ihren Slack-Kanal ein, um eine Nachricht zu veröffentlichen.
Geben Sie den Namen des Slack-Teams ein. Wenn die Team- URL beispielsweise lautet https://team.slack.com, lautet der Teamname team.
Wählen Sie Automatisierte Slack-Benachrichtigungen für die Ereignisse, über die Sie benachrichtigt werden möchten.
Klicken Sie auf Weiter.

Optional können Sie das Senden von Benachrichtigungen mit der slack-notifications-Umgebungseigenschaft in Ihrer CD-Pipeline durch Verwendung von 0 = off, and 1 = on umschalten.

CD-Toolchain erstellen

Die einzelnen Toolchain-Integrationen können nach der Erstellung der Pipeline konfiguriert werden.

Klicken Sie auf der Seite Zusammenfassung auf Toolchain erstellen und warten Sie, bis die Toolchain erstellt wurde.

CD-Toolchain durchsuchen

Nachdem die CD-Toolchain erstellt wurde, klicken Sie auf die Kachel cd-pipeline, um die Promotion-Pipeline zu öffnen und auszuführen.

Promotion-Pipeline ausführen

Stellen Sie sicher, dass die CI-Pipeline erfolgreich ausgeführt wurde, bevor Sie die Promotion-Pipeline starten.

Klicken Sie auf cd-pipeline.
Klicken Sie auf Ausführen für die Manuelle Promotion Trigger Pipeline.
Klicken Sie auf Ausführen, um die Pipeline zu starten.
Klicken Sie auf Manuelle Förderung auslösen > #1promotion-pipelinerun Pipeline. Warten Sie den Abschluss des Promotions-Pipeline-Laufs ab und prüfen Sie das Ausführungsprotokoll.

Die Promotion-Pipeline erstellt einen Pull-Request mit dem Inhalt des Inventars aus der Inventar-Quellumgebung (z. B. master branch) an den Zielzweig der Inventar-Zielumgebung (z. B. staging oder ) production.
Nachdem die Promotion-Pipeline erfolgreich abgeschlossen wurde, enthält das promote Aufgabenprotokoll einen Link zum Pull-Request im Inventar-Repository. Der Name der Pull-Anfrage hat das Format promote <inventory source environment> to <inventory target environment>, zum Beispiel promote master to prod
Öffnen Sie den Pull-Request in Ihrem Browser über den im Protokoll angegebenen Link. Füllen Sie die Angaben in den folgenden Abschnitten aus:
- Priorität: (obligatorisch) festgelegt als Critical, High, Moderate, Low oder Planning.
- Zugewiesener für Änderungsanforderung: (Pflichtfeld) des Email-ID Zuweisungsempfängers.
- Zusätzliche Beschreibung: Beschreibung der Änderungen in der Anwendung.
- Zweck/Ziel: Zweck der an der Anwendung vorgenommenen Änderungen.
- Erläuterung der Auswirkungen: Auswirkungen der Änderung auf das Verhalten der Anwendung oder die Umgebung.
- Ausstiegsplan: Schritte für den Ausstieg bei einem Ausfall der Bereitstellung.
Füllen Sie die Felder im Pull Request aus und speichern Sie sie.
Fügen Sie das Label EMERGENCY zu Ihrem Pull-Request hinzu, wenn eine Konformitätsprüfung in CI fehlgeschlagen ist und Sie mit der Bereitstellung fortfahren
Führen Sie die Pull-Anforderung aus Git Repos and Issue Trackingzusammen.

Die Details der Pull-Anforderung werden während der CD-Pipeline verwendet, die zum Erstellen und Aktualisieren des Repositorys für Änderungsanforderungen ausgeführt wird.

CD-Pipeline ausführen

Sie können eine CD-Pipeline auf manuelle oder automatische Weise auslösen. Sie können die CD-Pipeline jederzeit manuell auslösen, aber wenn sich seit der letzten erfolgreichen Bereitstellung keine Änderungen ergeben haben, wird die CD-Pipeline vorzeitig abgebrochen, da es nichts zu verteilen gibt. Sie können force-redeploy-Variable hinzufügen und verwenden, um die CD ohne Codeänderungen erneut auszuführen. Sehen Sie sich die erfolgreiche Bildschirmaufnahme der DevSecOps CD-Pipeline an.

Sie können die Beispielanwendung finden, die im Produktionsnamensraum ausgeführt wird. Die App- URL findet sich im Protokoll des run stage Teilschritts des prod deployment Schritts des CD-Pipeline-Laufs. Verwenden Sie diese URL, um zu überprüfen, ob die App läuft.

Nächste Schritte

Sie haben erfolgreich eine DevSecOps CD-Toolchain erstellt und die cd-pipeline zum manuellen Auslösen in der Produktionsumgebung ausgeführt.

Fahren Sie nun mit Einrichten einer CC-Toolchain fort.