Bereitstellen von Kubernetes-Ressourcen in mehreren Clustern mithilfe von IBM Cloud Satellite Config

DevOps Insights wird am 31. August 2026 das Ende seiner Laufzeit erreichen und eingestellt werden. „ Continuous Delivery “ wird am 12. Februar 2027 in den folgenden Regionen eingestellt: au-syd, ca-mon, ca-tor, us-east. Code Risk Analyzer wird zu diesem Zeitpunkt ebenfalls in allen Regionen eingestellt. Wenn diese Funktionen in einer Region nicht aktiv genutzt werden, können sie in dieser Region vorzeitig eingestellt werden, sodass keine neuen Instanzen mehr akzeptiert werden. Mehr erfahren

In diesem Tutorial erfahren Sie, wie Sie mithilfe von IBM Cloud® Continuous Delivery eine offene Toolchain erstellen und Ihre Anwendung (App) mithilfe von IBM Cloud Satellite. Außerdem erfahren Sie, wie Toolchains im Continuous Delivery Dienst implementiert werden und wie Sie eine einfache Web-App mithilfe einer Continuous Delivery reinen Toolchain-Vorlage bereitstellen können.

IBM Cloud Satellite bietet Public-Cloud-Services für jede Umgebung, sodass Kunden mit strengen gesetzlichen Bestimmungen die Flexibilität und Agilität dieser Services für ihr sicheres lokales Rechenzentrum nutzen können. Continuous Delivery verwendet Satellite-Config, um eine App in einer ganzen Gruppe von Clustern in IBM Cloud Satellitebereitzustellen. Mit „ Satellite-Konfiguration“ erstellen Sie eine Konfiguration, um festzulegen, welche Ressourcen von „ Kubernetes “ Sie in einer Clustergruppe aus „ Kubernetes “- oder „ Red Hat® OpenShift® “-Clustern bereitstellen möchten, die an Ihrem „ Satellite “-Standort oder unter „ IBM Cloud “ ausgeführt werden.

Die in diesem Lernprogramm verwendete Toolchain implementiert DevOps-Standardverfahren für Continuous-Delivery-Funktionen. Nachdem Sie sichergestellt haben, dass alle Voraussetzungen für die kontinuierliche Integration erfüllt sind, unterstützt diese Toolchain Sie beim Verwalten Ihrer Bereitstellungen an IBM Cloud Satellite-Positionen. Nachdem Sie Cluster erstellt und diese einer „ Satellite “-Clustergruppe zugeordnet haben, können Sie eine Toolchain erstellen, um Ihren Deployment-Quellcode zu ändern und die Änderung in das Repository „ GitHub “ zu übertragen. Wenn Sie Änderungen in Ihr Repository übertragen, führt die auf Tekton basierende Bereitstellungspipeline automatisch die Bereitstellung des Codes durch.

Tekton ist ein quelloffenes, herstellerneutrales, für „ Kubernetes “ entwickeltes Framework, mit dem Sie Anwendungen erstellen, testen und bereitstellen können. Tekton stellt eine Reihe gemeinsam genutzter Komponenten für die Implementierung von Continuous Delivery-Systemen bereit. Als Open-Source-Projekt wird Tekton von der „ Continuous Delivery Foundation“ verwaltet. Das Ziel ist die Modernisierung von Continuous Delivery durch Bereitstellung von Branchenspezifikationen für Pipelines, Workflows und andere Bausteine. Mit Tekton können Sie bei Cloud-Providern oder lokal Systeme erstellen, testen und implementieren, indem Sie die zugrunde liegenden Implementierungsdetails abstrahieren. Tekton-Pipelines sind in Continuous Delivery integriert.

Die in diesem Tutorial verwendete Vorlage ist mit dem Standard-Tarif für Red Hat OpenShift kompatibel.

Vorbereitende Schritte

Stellen Sie vor Beginn dieses Lernprogramms sicher, dass die folgenden Ressourcen vorhanden sind:

  • Ein IBM Cloud-Konto. Abhängig von Ihrem IBM Cloud-Kontotyp kann der Zugriff auf bestimmte Ressourcen eingeschränkt sein. Abhängig von den Grenzwerten für Ihren Kontoplan sind bestimmte Funktionen, die für einige der Implementierungsstrategien erforderlich sind, möglicherweise nicht verfügbar. Weitere Informationen zu „ IBM Cloud “-Konten finden Sie unter „ Einrichten Ihres IBM Cloud-Kontos “ und „ Upgrade Ihres Kontos “.

  • Eine Satellite -Clustergruppe mit dem Cluster, der für die Toolchain erforderlich ist. Die Toolchain in diesem Lernprogramm unterstützt eine Clustergruppe Satellite, die nur Red Hat OpenShift-Cluster enthält.

  • Geheime Image-Pull-Schlüssel Stellen Sie sicher, dass Sie die geheimen Schlüssel für Image-Pull-Operationen konfigurieren, die zum Bereitstellen von Anwendungsimages in Ihrem Clusternamensbereich erforderlich sind.

  • Eine Instanz des Continuous Delivery-Service.

  • Optional. Geheime Schlüssel, die in einem Vault für die Verwaltung geheimer Schlüssel gespeichert und zentral von einem einzigen Standort aus verwaltet werden. Weitere Informationen zur Auswahl aus den verschiedenen Angeboten für Verwaltung geheimer Schlüssel und Datenschutz finden Sie unter Geheime IBM Cloud-Schlüssel verwalten. Wenn Sie noch nicht über eine Instanz des gewünschten Vault-Providers für die Verwaltung geheimer Schlüssel verfügen, erstellen Sie eine solche Instanz.

  • Optional. Ein Namensbereich, der über die Befehlszeile der Container-Registry erstellt wird. Geben Sie zum Erstellen eines Namensbereichs den folgenden Befehl in der Befehlszeile ein:

    ibmcloud cr namespace-add <my namespace>
    

    Alternativ können Sie einen Namensbereich auf der Seite Container Registry erstellen. Weitere Informationen zum Erstellen eines Namensbereichs an diesem Standort finden Sie unter IBM Cloud Container Registry-Service.

Toolchain erstellen

In diesem Schritt erstellen Sie die Toolchain Ihre Anwendung in mehreren Clustern bereitstellen. Der Kubernetes-Zielcluster wird während der Toolchain-Konfiguration mithilfe Ihres IBM Cloud-API-Schlüssels und Ihres Kubernetes-Clusternamens konfiguriert. Sie können diese Einstellungen später ändern, indem Sie die Delivery Pipeline-Konfiguration aktualisieren. Jeder Code, der im Zielzweig des Git-Repositorys zusammengeführt wird, wird automatisch erstellt, validiert und im Kubernetes-Cluster bereitgestellt.

Klicken Sie auf Anwendung in mehreren Clustern bereitstellen, um eine Toolchain zu erstellen.

Toolchain erstellen

Alternativ können Sie in der IBM Cloud Konsole auf das Menü-Symbol (Hamburger-Symbol ) > Plattformautomatisierung > Toolchains klicken. Klicken Sie auf der Seite Toolchains auf Toolchain erstellen. Klicken Sie auf der Seite Erstellen einer Toolchain auf Bereitstellen Ihrer Anwendung in mehreren Clustern.

Sehen Sie sich die Begrüßungsseite an

Bevor Sie mit dem Einrichten Ihrer Toolchain beginnen, prüfen Sie die Voraussetzungen, um herauszufinden, welche Elemente Sie zuerst bereitstellen und konfigurieren müssen. Im Abschnitt "Beschreibung" können Sie auf eine Übersicht der Toolchain zugreifen.

caption-side=bottom"
WillkommensseiteWillkommensseite

Nachdem Sie alle diese Informationen überprüft haben, klicken Sie auf Starten.

Den Toolchain-Namen und die Region konfigurieren

  1. Überprüfen Sie die Standardinformationen für die Toolchain-Einstellungen. Der Name der Toolchain macht sie in IBM Cloud identifizierbar. Stellen Sie sicher, dass der Name der Toolchain innerhalb Ihrer Toolchains für dieselbe Region und Ressourcengruppe in IBM Cloud eindeutig ist.

    Die Region der Toolchain kann sich von der Region des Clusters und der Registry unterscheiden.

    Name der Werkzeugkette und
    der Werkzeugkette und

  2. Klicken Sie auf Weiter, um mit dem nächsten Schritt zum Konfigurieren Ihrer Toolchain fortzufahren. Um die Toolchain mithilfe der aktuellen Einstellungen zu erstellen, klicken Sie auf Toolchain erstellen.

Quellenrepository für die Implementierung konfigurieren

Das Bereitstellungsquellenrepository enthält den gesamten Bereitstellungsquellcode, der zum Bereitstellen der App erforderlich ist.

  1. Im Schritt "Quellenrepository" werden die Standardoptionen für das Implementierungsquellenrepository angezeigt. Um alle verfügbaren Optionen für den zugrunde liegenden Quellenprovider anzuzeigen, klicken Sie auf Zur erweiterten Konfiguration wechseln. Standardmäßig verwendet die Toolchain das Beispiel, das die Beispielbereitstellung als auf IBM gehostetes Repository „ Git Repos and Issue Tracking “ klont.

    caption-side=bottom"
    Bereitstellungsquelle

  2. Geben Sie den Namen des Repositorys an, das Sie als Bereitstellungsquelle verwenden möchten. Die Region des Repositorys bleibt die gleiche wie die Region der Toolchain.

    Die Toolchain-Vorlage stellt eine IBM Cloud Satellite-Beispielanwendung 'Config'bereit. Um ein vorhandenes Bereitstellungs-Quell-Repository für die Toolchain zu verknüpfen, klicken Sie auf "Zur erweiterten Konfiguration wechseln" und geben Sie URL für das Repository an. Die Toolchain unterstützt nur Links zu vorhandenen Git Repos and Issue Tracking-Repositorys.

Standardmäßig wird die Repo-Vorlage für die Bereitstellungsquelle in Ihre „ Git Repos and Issue Tracking “-Organisation geklont. Klicken Sie zum Ändern der Organisation auf Zur erweiterten Konfiguration wechseln und geben Sie den Eigner des Repositorys an.

Den Namen Delivery Pipeline konfigurieren

Der Service Continuous Delivery verwendet Tekton-fähige Delivery Pipelines.

Ein Delivery Pipeline automatisiert die kontinuierliche Implementierung eines Projekts. In der Pipeline eines Projekts rufen Abfolgen von Phasen Eingaben ab und führen Aufgaben aus, wie beispielsweise Builds, Tests und Bereitstellungen. Tekton-Ressourcen werden in YAML-Dateien definiert, die in einem Code-Repository verwaltet werden.

Die Toolchain erstellt eine Delivery Pipeline-Instanz, um Ihre App kontinuierlich in mehreren Cluster innerhalb einer Clustergruppe IBM Cloud Satellite bereitzustellen. Sie müssen einen Namen für Delivery Pipeline angeben, der nach der Erstellung in Ihrer Toolchain angezeigt wird.

Delivery Pipeline Name
Delivery Pipeline Name

Geheime Schlüssel sicher speichern

Für mehrere Tools innerhalb dieser Toolchain sind geheime Schlüssel erforderlich, z. B. ein IBM Cloud-API-Schlüssel. Sie müssen alle geheimen Schlüssel sicher in einem Vault für geheime Schlüssel speichern und sie entsprechend den Anforderungen der Toolchain referenzieren.

Mit IBM Cloud können Sie aus verschiedenen Angeboten für das Management geheimer Schlüssel und den Datenschutz auswählen, mit denen Sie Ihre sensiblen Daten schützen und Ihren geheimen Schlüssel zentralisieren können. Im Schritt "Geheime Schlüssel" können Sie angeben, welche Vaultintegrationen für geheime Schlüssel in Ihrer Toolchain hinzugefügt oder entfernt werden sollen. Weitere Informationen zum Hinzufügen und Entfernen von Vaultintegrationen, einschließlich der Voraussetzungen und mithilfe von Hinweisen, finden Sie unter Geheime IBM Cloud-Schlüssel verwalten.

Durch Verwendung von Hinweisen in einer Vorlage wird eine Toolchain automatisch mit vorkonfigurierten geheimen Schlüsseln gefüllt. Sie brauchen keine geheimen Schlüssel manuell aus Vaultintegrationen auszuwählen, die der Toolchain zugeordnet sind.

In diesem Lernprogramm wird IBM Secrets Manager als Vault für geheime Schlüssel verwendet.

caption-side=bottom"
Geheime

IBM Secrets Manager speichert sicher und wendet geheime Schlüssel wie API-Schlüssel, Imagesignatur, oder HashiCorp-Berechtigungsnachweise, die Teil Ihrer Toolchain sind, an.

Secrets Manager Details
Secrets Manager Details

Weitere Informationen zur Verwaltung Ihrer Geheimnisse in IBM Key Protect oder HashiCorp, finden Sie unter Geheimnisse.

Satellite-Konfigurationseinstellungen aktualisieren

Das Konfigurationstool IBM Cloud Satellite stellt Bereitstellungskonfigurationen für angegebene Clustergruppen bereit. Der Verzeichnispfad des Quellenrepositoros gibt an, welche Dateien in der bereitgestellten Clustergruppe implementiert werden sollen.

Konfigurieren Sie den Ziel- Red Hat OpenShift-Cluster für die Bereitstellung der App auf

Wenn der API-Schlüssel den erforderlichen Zugriff hat, werden die folgenden Felder automatisch mithilfe des API-Schlüssels geladen, der entweder erstellt, aus einer Vault abgerufen, oder manuell angegeben wird. Wenn der API-Schlüssel gültig ist, werden Werte für den Verzweigungsnamen und die Clustergruppe automatisch eingetragen. Sie können jedes dieser Felder entsprechend Ihrer Konfiguration aktualisieren.

  • IBM Cloud-API-Schlüssel: Der API-Schlüssel, der für die Interaktion mit dem ibmcloud-CLI-Tool in mehreren Tasks verwendet wird. Verwenden Sie eine der folgenden Methoden, um den API-Schlüssel anzugeben, den Sie verwenden möchten:

    • Klicken Sie auf das Schlüsselsymbol, um einen vorhandenen API-Schlüssel aus einem geheimen Vault Ihrer Wahl zu importieren.
    • Kopieren Sie einen vorhandenen API-Schlüssel und fügen Sie ihn ein.
    • Klicken Sie auf Neu, um einen API-Schlüssel zu erstellen.
    • Generieren Sie eine neue api-key, wenn kein API-Schlüssel vorhanden ist.

    Sie können den generierten API-Schlüssel sofort in einer vorhandenen Vault für geheime Schlüssel Ihrer Wahl speichern.

  • Clusternamensbereich: Geben Sie einen Namen für den Clusternamensbereich an, in dem Sie die App bereitstellen wollen.

  • Verzweigung: Geben Sie die Verzweigung Git für Ihr Quellenrepository an.

  • Pfad: Geben Sie den Verzeichnispfad Ihres Quellenrepositoros an.

  • Clustergruppe: Wählen Sie die Clustergruppe IBM Cloud Satellite aus, in der Ihre App bereitgestellt werden soll.

  • Konfigurationsname: Geben Sie den Namen für die Satellite-Konfiguration an. Dieser Name wird zum Erstellen von Satellite-Konfigurationsversionen verwendet, die zum Erstellen von Satellite-Subskriptionen verwendet werden.

Satellite

IBM Cloud Details Satellite
IBM Cloud Konfigurationsdetails

Klicken Sie auf Weiter.

Das Toolchain-Setup abschließen

Klicken Sie auf der Seite 'Zusammenfassung' auf Toolchain erstellen. Zum Einrichten Ihrer Toolchain werden mehrere verschiedene Schritte automatisch ausgeführt.

Sie können nach der Erstellung der Pipeline weitere Toolchain-Integrationen konfigurieren.

Zusammenfassung der
ToolchainZusammenfassung der Toolchain

Neue Toolchain erkunden

Nach dem Erstellen Ihrer Toolchain werden alle Toolintegrationen angezeigt, die Sie während der Konfiguration angegeben haben.

caption-side=bottom"
Beispiel

Delivery Pipeline kennenlernen

Sie können die „ Delivery Pipeline “ erkunden, um den Ablauf der Toolchain und die verschiedenen Vorgänge zu verstehen, die innerhalb der Pipeline ausgeführt werden. Die Pipeline stellt Build-Artefakte in der Bereitstellungsumgebung bereit. Die Pipeline überprüft zudem die erfolgreiche Bereitstellung der App, indem sie den Zustandscheck durchführt.

Sie können die Lieferpipeline auf eine der folgenden Arten starten:

  • Lösen Sie die Auslieferungspipeline manuell aus.
  • Übertragen Sie ein Commit mit einer Push-Operation an das Implementierungsquellenrepository.

Pipeline mithilfe eines manuellen Auslösers ausführen

  1. Klicken Sie auf der Übersichtsseite der Toolchain auf Delivery Pipeline, die Sie ausführen wollen.

  2. Klicken Sie auf das Symbol Pipeline ausführen und wählen Sie dann den Auslöser manual-run aus.

    Auslöser für die
    für die

  3. Überprüfen Sie die Auslösereigenschaften, um sicherzustellen, dass sie Ihrer Konfiguration entsprechen.

  4. Klicken Sie auf Run.

    caption-side=bottom"
    Erfolgreicher

Überprüfen Sie, ob die Beispielapp ausgeführt wird.

Führen Sie nach der Einrichtung Ihrer Toolchain und dem erfolgreichen Abschluss von Delivery Pipeline die folgenden Schritte aus, um Ihre App zu überprüfen:

  • Klicken Sie auf der Homepage Cluster auf den Red Hat OpenShift-Cluster, den Sie zum Bereitstellen Ihrer App verwendet haben.
  • Klicken Sie auf OpenShift-Webkonsole.
  • Filtern Sie im Abschnitt Workloads > Pod nach dem Projekt oder dem Clusternamensbereich und überprüfen Sie, ob die Pods ausgeführt werden.
  • Filtern Sie im Abschnitt „Netzwerk > Routen“ nach dem Projekt oder dem Cluster-Namespace und suchen Sie die App- URL.
  • Vergewissern Sie sich, dass die App ausgeführt wird.

Sie brauchen Hilfe?

IBM Cloud der KI-Assistent von IBM, der von watsonx unterstützt wird, soll Ihnen dabei helfen, sich mit der Arbeit in IBM Cloud vertraut zu machen und mithilfe des Katalogs verfügbarer Produkte und Dienstleistungen Lösungen zu entwickeln. Siehe "Hilfe vom KI-Assistenten erhalten ".

Weitere Unterstützungsoptionen finden Sie unter Hilfe und Unterstützung für Continuous Delivery.