DevOps Insights zu Ihrer Toolchain hinzufügen

DevOps Insights Das Produkt wurde aus dem Angebot genommen und ist nicht mehr verfügbar. Weitere Informationen

Mit IBM Cloud® DevOps Insights können Sie die Buildqualität für Ihre Projekte verbessern. DevOps Insights ist ein Tool, das Daten für Team-Einblicke und Bereitstellungsrisiko bereitstellt. Sie können Komponententests, Codeabdeckung, Funktionstests und statische Sicherheitsscans für die einzelnen Anwendungen in DevOps Insights hochladen und so Einblicke in die jeweiligen Anwendungen erhalten.

Vorbereitende Schritte

Um DevOps Insights verwenden zu können, müssen Sie über eine Toolchain verfügen. Eine Toolchain ist eine Gruppe von Tools, die an eine Ihrer Anwendungen angehängt ist. Stellen Sie sich die Tools als Erweiterungen für die App und die Toolchain als Dienstprogrammband vor. DevOps Insights arbeitet mit den anderen Tools in der Toolchain wie GitHub und Delivery Pipeline, um Daten für Ihre Anwendung zu aggregieren.

Weitere Informationen zu Toolchains finden Sie unter Toolchain über eine App erstellen.

DevOps Insights integrieren

Integration von DevOps Insights mit Hilfe der Konsole

Sie können DevOps Insights zu jeder Toolchain hinzufügen, indem Sie die Komponente aus dem Toolintegrationskatalog auswählen.

  1. Klicken Sie in der Konsole IBM Cloud auf das Hamburger-Symbol im Menü > Plattformautomatisierung > Toolchains.
  2. Wählen Sie Ihre Toolchain aus.
  3. Klicken Sie auf Tool hinzufügen.
  4. Wählen Sie die Kachel DevOps Insights aus.
  5. Klicken Sie auf Integration erstellen.
  6. Klicken Sie auf der Übersichtsseite der Toolchain auf der Karte IBM Cloud-Tools auf DevOps Insights, um Ihr DevOps Insights-Dashboard anzuzeigen.

Integration von DevOps Insights in die API

  1. Beziehen Sie ein IAM-Inhaber-Token. Wenn Sie ein SDK verwenden, können Sie alternativ einen IAM-API-Schlüssel anfordern und die Client-Optionen mithilfe von Umgebungsvariablen festlegen.

    export CD_TOOLCHAIN_AUTH_TYPE=iam && \
    export CD_TOOLCHAIN_APIKEY={iam_api_key} && \
    export CD_TOOLCHAIN_URL={base_url}
    
  2. Bestimmen Sie die Region und die ID der Toolchain, der Sie die DevOps Insights Toolintegration hinzufügen möchten.

  3. Fügen Sie die DevOps Insights-Toolintegration zur Toolchain hinzu.

    curl -X POST \
      {base_url}/toolchains/{toolchain_id}/tools \
      -H 'Authorization: Bearer {token}' \
      -H 'Accept: application/json` \
      -H 'Content-Type: application/json' \
        -d '{
        "tool_type_id": "draservicebroker",
        "name": "{tool_integration_name}"
      }'
    
    const CdToolchainV2 = require('@ibm-cloud/continuous-delivery/cd-toolchain/v2');
    ...
    (async () => {
       const toolchainService = CdToolchainV2.newInstance();
       const draPrototypeModel = {
          toolchainId: {toolchain_id},
          toolTypeId: 'draservicebroker',
          name: {tool_integration_name}
       };
       const draTool = await toolchainService.createTool(draPrototypeModel);
    })();
    
    import (
    	   "github.com/IBM/continuous-delivery-go-sdk/cdtoolchainv2"
    )
    ...
    toolchainClientOptions := &cdtoolchainv2.CdToolchainV2Options{}
    toolchainClient, err := cdtoolchainv2.NewCdToolchainV2UsingExternalConfig(toolchainClientOptions)
    createDraToolOptions := toolchainClient.NewCreateToolOptions({toolchain_id}, "draservicebroker")
    createDraToolOptions.SetName({tool_integration_name})
    draTool, response, err := toolchainClient.CreateTool(createDraToolOptions)
    
    from ibm_continuous_delivery.cd_toolchain_v2 import CdToolchainV2
    ...
    toolchain_service = CdToolchainV2.new_instance()
    dra_tool = toolchain_service.create_tool(
       name = {tool_integration_name},
       toolchain_id = {toolchain_id},
       tool_type_id = "draservicebroker"
    )
    
    import com.ibm.cloud.continuous_delivery.cd_toolchain.v2.CdToolchain;
    import com.ibm.cloud.continuous_delivery.cd_toolchain.v2.model.*;
    ...
    CdToolchain toolchainService = CdToolchain.newInstance();
    CreateToolOptions createDraToolOptions = new CreateToolOptions.Builder()
       .name({tool_integration_name})
       .toolchainId({toolchain_id})
       .toolTypeId("draservicebroker")
       .build();
    Response<ToolchainToolPost> response = toolchainService.createTool(createDraToolOptions).execute();
    ToolchainToolPost draTool = response.getResult();
    

In der folgenden Tabelle sind alle Variablen aufgeführt und beschrieben, die in den vorangegangenen Schritten verwendet werden.

Variablen für das Hinzufügen des DevOps Insights Tools zur Integration 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.
{tool_integration_name} Ein Name für Ihre Werkzeugintegration.
{toolchain_id} Die ID der Werkzeugkette, zu der die Werkzeugintegration hinzugefügt werden soll.
{token} Ein gültiges IAM-Bearer-Token.

Weitere Informationen zur Integration des Tools DevOps Insights finden Sie unter Hinzufügen von DevOps Insights.

Integration von DevOps Insights mit Terraform

  1. Um das Terraform CLI zu installieren und das IBM Cloud Provider-Plugin für Terraform zu konfigurieren, folgen Sie dem Lernprogramm für Erste Schritte mit Terraform auf IBM Cloud.

  2. Suchen Sie die Terraform-Datei (z. B. main.tf), die den Ressourcenblock für die Toolchain enthält, zu der Sie die Toolintegration DevOps Insights hinzufügen möchten. Fügen Sie in dieser Datei die Konfiguration zur Erstellung der Werkzeugintegration hinzu.

    Das folgende Beispiel erstellt die Toolchain, falls sie nicht existiert, und fügt dann die DevOps Insights Toolintegration mit Hilfe der ibm_cd_toolchain_tool_devopsinsights Ressource hinzu.

    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
    }
    resource "ibm_cd_toolchain_tool_devopsinsights" "cd_toolchain_tool_insights" {
      toolchain_id = ibm_cd_toolchain.cd_toolchain.id
    }
    

    Weitere Informationen über ibm_cd_toolchain_tool_devopsinsights finden Sie in der Terraform-Registry-Dokumentation unter Argumente.

  3. Terraform-Befehlszeilenschnittstelle initialisieren.

    terraform init
    
  4. Erstellen Sie einen Terraform-Ausführungsplan. Dieser Plan fasst alle Aktionen zusammen, die ausgeführt werden müssen, um die Integration des Werkzeugs DevOps Insights in die Werkzeugkette aufzunehmen.

    terraform plan
    
  5. Wenden Sie den Terraform-Ausführungsplan an. Terraform führt alle erforderlichen Aktionen aus, um die DevOps Insights Tool-Integration zur Toolchain hinzuzufügen.

    terraform apply
    

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

Nächste Schritte

Nach dem Hinzufügen von DevOps Insights können Sie Qualitätsdaten von anderen Quellen hinzufügen. Zu diesen Quellen gehören IBM® Continuous Delivery Pipeline for IBM Cloud® in der Toolchain, Jenkins, Travis CI oder andere Pipelines. Weitere Informationen finden Sie unter Daten von mehreren Quellen in einzelner Toolchain aggregieren.