Toolchains verwenden

DevOps Insights wird am 31. August 2026 das Ende des Betriebs erreichen und eingestellt werden. Continuous Delivery wird am 12. Februar 2027 in den folgenden Regionen eingestellt: au-syd, 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. Weitere Informationen

Offene Toolchains sind auf IBM Cloud® verfügbar. Mithilfe einer Toolchain können Sie Ihre täglichen Entwicklungs-, Bereitstellungs- und Systemaufgaben produktiv abwickeln. Nach dem Einrichten einer Toolchain können Sie Toolintegrationen hinzufügen, löschen oder konfigurieren sowie den Zugriff auf die Toolchain verwalten. Weitere Informationen zum Arbeiten mit Toolintegrationen finden Sie unter Mit Toolintegrationen arbeiten.

Zugriff auf Toolchains verwalten

Sie können den Service Identity and Access Management (IAM) verwenden, um den Benutzerzugriff auf Toolchains in Ressourcengruppen zu verwalten. Weitere Informationen zum Verwalten der Zugriffssteuerung mit IAM finden Sie unter Benutzerzugriff auf Toolchains in Ressourcengruppen verwalten.

Benutzer mit Zugriff auf Toolchains werden unter Umständen als berechtigte Benutzer des IBM Cloud® Continuous Delivery-Service gezählt. Weitere Informationen zur Zählung von berechtigten Benutzern finden Sie unter Einschränkungen und Nutzung bei der Verwendung der jeweiligen Pläne.

Toolchains organisieren

Sie können Ihren Toolchains Tags hinzufügen, um sie zu organisieren und später leichter zu finden. Bei einem Tag handelt es sich um eine Kennzeichnung, die Sie einer Toolchain zuordnen, damit Sie in Ihrer Toolchain-Liste leicht nach Toolchains filtern können.

  1. Klicken Sie in der Konsole IBM Cloud auf das Hamburger-Symbol im Menü > Plattformautomatisierung > Toolchains.
  2. Suchen Sie auf der Seite 'Toolchains' die Toolchain, der Sie einen Tag hinzufügen möchten, und klicken Sie auf Tags hinzufügen.
  3. Geben Sie einen Namen für den Tag ein, den Sie der Toolchain hinzufügen möchten. Sie können mehrere Tags hinzufügen, die durch Kommas voneinander getrennt sind.
  4. Klicken Sie auf Speichern.

Weitere Informationen zu Tags finden Sie unter Mit Tags arbeiten.

Toolchain-Verbindungen mit Apps, Clustern und Services anzeigen

Sie können die Verbindungen Ihrer Toolchain zu Kubernetes-Clustern und -Diensten einsehen.

  1. Klicken Sie in der Konsole IBM Cloud auf das Hamburger-Symbol im Menü > Plattformautomatisierung > Toolchains.
  2. Klicken Sie auf der Seite 'Toolchains' auf eine Toolchain, um die zugehörige Übersichtsseite zu öffnen. Klicken Sie alternativ auf der Seite mit den App-Details in Ihrer App auf den Toolchainnamen.
  3. Wählen Sie die Registerkarte Verbindungen aus und wählen Sie die App, den Cluster oder den Service aus, die bzw. den Sie anzeigen möchten.

Toolchain löschen

Sie können eine Toolchain löschen. Wenn Sie eine Toolchain löschen, werden auch alle zu dieser Toolchain gehörenden Toolintegrationen gelöscht. Der Löschvorgang kann nicht rückgängig gemacht werden.

Wenn Sie eine Delivery Pipeline Werkzeugintegration löschen, wird auch die zugehörige Delivery Pipeline gelöscht.

Wenn Sie eine GitHub-oder eine Git Repos and Issue Tracking Toolintegration löschen, wird das zugeordnete Repository nicht aus GitHub oder Git Repos and Issue Trackinggelöscht. Sie müssen das Repository manuell entfernen.

Toolchain über die Konsole löschen

  1. Klicken Sie in der Konsole IBM Cloud auf das Hamburger-Symbol im Menü > Plattformautomatisierung > Toolchains.
  2. Klicken Sie auf der Seite 'Toolchains' auf eine Toolchain, um die zugehörige Übersichtsseite zu öffnen. Klicken Sie alternativ auf der Seite mit den App-Details in Ihrer App auf den Toolchainnamen.
  3. Klicken Sie auf das Menü Aktionen und wählen Sie Löschen aus. Beim Löschen einer Toolchain werden auch alle zugehörigen Toolintegrationen entfernt, was unter Umständen bewirkt, dass von diesen Integrationen verwaltete Ressourcen ebenfalls gelöscht werden.
  4. Bestätigen Sie das Löschen, indem Sie den Namen der Toolchain eingeben und auf Löschen klicken.

Toolchain über die Befehlszeilenschnittstelle löschen (Beta)

  1. Melden Sie sich bei IBM Cloud über die IBM Cloud-CLI an.

    ibmcloud login
    

    Wenn die Anmeldung fehlschlägt, führen Sie den Befehl ibmcloud login --sso aus, um es erneut zu versuchen. Der Parameter --sso ist erforderlich, wenn Sie sich mit einer föderierten ID anmelden. Wenn Sie diese Option verwenden, rufen Sie den Link in der CLI-Ausgabe auf, um einen einmaligen Kenncode zu generieren.

  2. Optional. Listen Sie alle Toolchains im Zielkonto, der Zielregion und der Zielressourcengruppe auf, um die Instanz anzugeben, die Sie löschen wollen.

    ibmcloud dev toolchains
    
  3. Löschen Sie eine Toolchain, indem Sie den Befehl ibmcloud dev toolchain-delete ausführen.

    ibmcloud dev toolchain-delete TOOLCHAIN-NAME
    

In der folgenden Tabelle werden alle Variablen aufgelistet und beschrieben, die in den vorherigen Schritten verwendet wurden.

Variablen zum Löschen der Toolchain aus der CLI
Variable Beschreibung
TOOLCHAIN_NAME Der Name der Toolchain, die Sie löschen möchten.

Löschen einer Toolchain über die API

  1. Rufen Sie ein IAM-Trägertoken ab.. Wenn Sie ein SDK verwenden, können Sie alternativ einen IAM-API-Schlüssel anfordern und die Clientoptionen mithilfe von Umgebungsvariablen definieren.

    export CD_TOOLCHAIN_AUTH_TYPE=iam && \
    export CD_TOOLCHAIN_APIKEY={iam_api_key} && \
    export CD_TOOLCHAIN_URL={base_url}
    
  2. Löschen Sie die Toolchain, die Sie entfernen möchten.

    curl -X DELETE \
      "{base_url}/toolchains/{toolchain_id}" \
      -H 'Authorization: Bearer {token}'
    
    const CdToolchainV2 = require('@ibm-cloud/continuous-delivery/cd-toolchain/v2');
    const toolchainService = CdToolchainV2.newInstance();
    ...
    (async() => {
       const response = await toolchainService.deleteToolchain({
          toolchainId: {toolchain_id}
       });
    })();
    
    import (
    	   "github.com/IBM/continuous-delivery-go-sdk/cdtoolchainv2"
    )
    ...
    toolchainClientOptions := &cdtoolchainv2.CdToolchainV2Options{}
    toolchainClient, err := cdtoolchainv2.NewCdToolchainV2UsingExternalConfig(toolchainClientOptions)
    deleteToolchainOptions := toolchainClient.NewDeleteToolchainOptions({toolchain_id})
    response, err := toolchainClient.DeleteToolchain(deleteToolchainOptions)
    
    from ibm_continuous_delivery.cd_toolchain_v2 import CdToolchainV2
    ...
    toolchain_service = CdToolchainV2.new_instance()
    response = toolchain_service.delete_toolchain(
       toolchain_id = toolchain_id
    )
    
    import com.ibm.cloud.continuous_delivery.cd_toolchain.v2.CdToolchain;
    import com.ibm.cloud.continuous_delivery.cd_toolchain.v2.model.*;
    ...
    CdToolchain toolchainService = CdToolchain.newInstance();
    DeleteToolchainOptions deleteToolchainOptions = new DeleteToolchainOptions.Builder()
       .toolchainId({toolchain_id})
       .build();
    Response<Void> response = toolchainService.deleteToolchain(deleteToolchainOptions).execute();
    

In der folgenden Tabelle werden alle Variablen aufgelistet und beschrieben, die in den vorherigen Schritten verwendet wurden.

Variablen zum Löschen der Toolchain mit der API
Variable Beschreibung
{base_url} Der Toolchain-API-Endpunkt URL, zum Beispiel https://api.us-south.devops.cloud.ibm.com/toolchain/v2. Weitere Informationen zu diesem Endpunkt URL, einschließlich einer Liste von Werten, finden Sie unter Endpunkt URL.
{iam_api_key} Ihr IAM-API-Schlüssel.
{token} Ein gültiges IAM-Bearer-Token.
{toolchain_id} Die ID der Toolchain, die Sie löschen möchten.

Toolchain mit Terraform löschen

  1. Suchen Sie die Terraform-Datei (z. B. main.tf), die den Block resource für die vorhandene Toolchain enthält. Weitere Informationen zur Verwendung von Terraform mit Toolchains finden Sie unter Toolchain mit Terraform erstellen.

    Die resource im folgenden Beispiel beschreibt eine vorhandene Toolchain.

    data "ibm_resource_group" "group" {
      name = "default"
    }
    resource "ibm_cd_toolchain" "cd_toolchain" {
      name              = "my toolchain"
      resource_group_id = data.ibm_resource_group.group.id
    }
    
  2. Entfernen Sie den Block resource aus Ihrer Terraform-Datei.

  3. Terraform-Befehlszeilenschnittstelle initialisieren.

    terraform init
    
  4. Erstellen Sie einen Terraform-Ausführungsplan. Dieser Plan fasst alle Aktionen zusammen, die zum Löschen der Toolchain ausgeführt werden müssen.

    terraform plan
    
  5. Wenden Sie den Terraform-Ausführungsplan an. Terraform führt alle erforderlichen Aktionen zum Löschen der Toolchain aus.

    terraform apply
    

Verwaltung alternativer Toolchains in verschiedenen Regionen

Sie können Ihre Toolchain mit der Terraform Configuration Language definieren und dann Ihre Toolchain-Definition in zwei Regionen anwenden und pflegen: eine primäre Region mit aktiven Pipelines und eine alternative Region mit inaktiven Pipelines. Wenn Sie " Git Repos and Issue Tracking verwenden, können Sie auch " spiegeln Sie Ihre ' Git aus der Primärregion in die Alternativregion übertragen. Die Pflege von primären und alternativen Toolchains und Git ermöglicht ein schnelleres Failover und Redundanz. Außerdem gewährleistet dies einen reibungslosen Betrieb, falls in der primären Region Probleme auftreten sollten. Wenn Sie Ihre Toolchain in Terraform kodieren, können Sie Ihre Toolchain aktualisieren und die Änderungen auf beide Regionen anwenden.

Weitere Informationen zur Verwendung von Terraform finden Sie unter Einrichten von Terraform für Continuous Delivery.