Zugehörige Inhalte

• Einführung in Continuous Delivery
• Einführung in Cluster
• Einführung in Toolchains

Den Toolchain-Namen und die Region konfigurieren

Ü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.

Die Bereitstellungsstrategie auswählen

Die Toolchain erstellt eine Continuous-Deployment-Pipeline, um das Docker-Image der Anwendung in der Clustergruppe bereitzustellen, die in Satellite definiert ist.

1. Klicken Sie auf Mehrere Cluster über Satellite, um Ihre App mithilfe von Satellite bereitzustellen.

   

2. Klicken Sie auf Weiter.

Repository für den Anwendungsquellcode konfigurieren

Im Anwendungsschritt werden die empfohlenen Optionen für das Quellcode-Repository der Anwendung standardmäßig angezeigt. Um alle verfügbaren Optionen für die zugrunde liegende Git-Integration anzuzeigen, klicken Sie auf Erweiterte Optionen. Standardmäßig verwendet die Toolchain das Standardbeispiel, das die Beispiel-App als von IBM gehostetes Git Repos and Issue Tracking-Repository klont.

Sie können den Namen des App-Repositorys ändern. Die Region des Repositorys bleibt die gleiche wie die Region der Toolchain.

Die Toolchain-Vorlage stellt eine Anwendung 'Hello Containers'-App bereit. Wenn Sie ein vorhandenes Anwendungsrepository für die Toolchain verlinken wollen, wählen Sie Eigene App verwenden aus und geben Sie die URL für das Repository an. Die Toolchain unterstützt nur Links zu vorhandenen Git Repos and Issue Tracking-Repositorys.

Standardmäßig wird die Vorlage des Anwendungsrepositorys in Ihrer Git Repos and Issue Tracking-Organisation geklont. Zum Ändern der Organisation aktivieren Sie Erweiterte Optionen und geben den Eigner des Repositorys an.

Das Bestandsrepository konfigurieren

Das Bestandsrepository zeichnet die Details der Artefakte auf, die von den Toolchains für die kontinuierliche Integration erstellt werden. Sie können entweder ein neues Inventar-Repo erstellen, das ein Klon der Inventar-Repo-Vorlage ist, oder ein bestehendes Inventar-Repo verwenden, das Sie zwischen verschiedenen Toolchains gemeinsam nutzen.

Standardmäßig wird die Bestandsrepository-Vorlage in Ihrer Git Repos and Issue Tracking-Organisation geklont. Um die Organisation zu ändern, wählen Sie Erweiterte Optionen aus und geben den Eigner des Repositorys an.

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.

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

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

Pipelines erkunden

Sie können die Pipelines erkunden, um sich einen Einblick in den Toolchainablauf und die verschiedenen, innerhalb der jeweiligen Pipelines ausgeführten Operationen zu verschaffen. Die soeben erstellte Toolchain enthält drei Pipelines:

• Pipeline für Pull-Anforderungen: Wird ausgeführt, wenn ein Entwickler Änderungen aus seinem Entwicklungszweig mit dem Masterzweig oder einem anderen Zweig im Repository zusammenführt. Über die Pipeline für Pull-Anforderungen werden die Komponententests und statischen Scans für den Anwendungsquellcode ausgeführt.
• Pipeline für kontinuierliche Integration: Wird ausgeführt, wenn Sie eine Änderung mit der Masterverzweigung des Anwendungsquellcodes zusammenführen. Die Pipeline für kontinuierliche Integration führt den Komponententest, die Codeabdeckung und statische Scans für den Anwendungsquellcode, die CIS-Prüfung und die Stücklistenprüfung aus. Die Continuous Delivery-Pipeline generiert auch die binären Build-Artefakte und lädt sie in die IBM Cloud® Kubernetes Service, wie in der Toolchain konfiguriert, hoch. Die Pipeline für kontinuierliche Integration generiert die Metadaten der Build-Artefakte und speichert sie im Bestandsrepository.
• Pipeline für kontinuierliche Bereitstellung: Implementiert Build-Artefakte in der Implementierungsumgebung. Die Pipeline überprüft die erfolgreiche Bereitstellung der App durch Ausführen der Statusprüfung. Sie müssen diese Pipeline manuell auslösen, nachdem die Pipeline für kontinuierliche Integration erfolgreich abgeschlossen wurde. Abhängig von der ausgewählten Bereitstellungsstrategie werden weitere Auslöser zur Continuous-Delivery-Pipeline hinzugefügt.

Ausführen der Pull-Anforderung und der Pipelines für die kontinuierliche Integration

Erstellen Sie zum Starten der Pipeline für Pull-Anforderungen eine Zusammenführungsanforderung in Ihrem App-Repository:

1. Klicken Sie auf der Übersichtsseite der Toolchain auf der Karte Repositorys auf das compliance-app-<timestamp>-App-Repository.
2. Erstellen Sie im Master-Repository einen Zweig.
3. Aktualisieren Sie Code in der Beispielknoten-App oder der Readme-Datei und speichern Sie diese Änderungen.
4. Übergeben Sie die Zusammenführungsanforderung.
5. Klicken Sie auf der Übersichtsseite der Toolchain auf der Karte Repositorys auf das Repositorypr-pipeline, um die Pipeline für Pull-Anforderungen zu starten. Die entsprechende Zusammenführungsanforderung in Ihrem App-Repository verbleibt im Wartestatus, bis alle Phasen der Pipeline für Pull-Anforderungen erfolgreich abgeschlossen wurden.
6. Nachdem die Pipeline für Pull-Anforderungen erfolgreich ausgeführt wurde, können Sie sie auswählen, um die abgeschlossenen Schritte zu untersuchen.

Um die Pipeline für kontinuierliche Integration zu starten, führen Sie die Zusammenführungsanforderung für kontinuierliche Integration in Ihrem App-Repository zusammen:

1. Wechseln Sie zur Zusammenführungsanforderung.
2. Führen Sie die Anforderung zusammen, sodass Ihre Änderungen in den Masterzweig Ihres App-Repositorys kopiert werden. Die Pipeline für kontinuierliche Integration wird automatisch ausgelöst.
3. Klicken Sie auf der Übersichtsseite für die Toolchain für die kontinuierliche Integration auf der Karte Repositorys auf das ci-pipeline-Repository, um die Pipeline für die kontinuierliche Integration zu starten.
4. Nach erfolgreicher Ausführung der Pipeline für die kontinuierliche Integration können Sie auf die Pipelineausführung klicken, um die abgeschlossenen Schritte zu untersuchen.

Continuous Delivery-Pipeline kennenlernen

Die Pull-Anforderung und die Pipelines für kontinuierliche Integration sind in allen Bereitstellungsstrategien einheitlich. Das Design und die Implementierung der Continuous Delivery-Pipeline basieren auf der Bereitstellungsstrategie, die Sie zuvor in diesem Lernprogramm ausgewählt haben.

Sie können eine Continuous Delivery-Pipeline auf eine der folgenden Arten starten:

• Lösen Sie die Continuous-Delivery-Pipeline manuell aus.
• Lösen Sie die Continuous-Delivery-Pipeline automatisch nach jeder Merge-Aktion im Bestandsrepository aus. Nach der Zusammenführung müssen Sie die Ausführung der Continuous Delivery-Pipeline manuell auslösen.

Ein Git Repos and Issue Tracking-Auslöser ist so konfiguriert, dass er eine automatische Continuous Delivery-Pipeline auslöst, er ist jedoch standardmäßig deaktiviert. Sie können diesen Auslöser nach dem ersten Hochstufen einer Änderung aktivieren.