Continuous Delivery-Serviceinstanz über die Konsole erstellen

1. Melden Sie sich bei IBM Cloud an.
2. Klicken Sie in der IBM Cloud-Konsole auf Katalog und wählen Sie Services aus.
3. Wählen Sie die Kategorie Entwicklertools aus.
4. Klicken Sie auf die Kachel Continuous Delivery.
5. Wählen Sie die Region aus, in der Sie den Continuous Delivery-Service erstellen möchten.
6. Wählen Sie einen Lite- oder Professional-Tarif. Lite-Pläne bieten kostenfrei den vollen Funktionsumfang von Continuous Delivery für kleine Teams, wobei Nutzungsbeschränkungen gelten. Wenn Sie eine Instanz im Rahmen eines Lite-Plans erstellen, wird diese nach einem Zeitraum von 30 nach der Erstellung automatisch gelöscht. Weitere Informationen zu Continuous Delivery-Serviceplänen finden Sie in Einschränkungen und Nutzung bei der Verwendung der jeweiligen Pläne.
7. Geben Sie im Abschnitt Ressource konfigurieren einen Namen für die Continuous Delivery-Instanz an, die erstellt wird.
8. Wählen Sie die Ressourcengruppe aus, in der die Continuous Delivery-Serviceinstanz erstellt werden soll. Sie können die ausgewählte Ressourcengruppe nach dem Erstellen der Continuous Delivery-Serviceinstanz nicht ändern. Weitere Informationen zum Organisieren von Ressourcen in Ihrem IBM Cloud-Konto finden Sie in Bewährte Verfahren für das Organisieren von Ressourcen in einer Ressourcengruppe.
9. Geben Sie die Tags an, die Sie zum Organisieren und Filtern der Ressourcen in Ihrer Ressourcenliste verwenden möchten. Darüber hinaus können Sie diese Tags dazu verwenden, die Teamnutzungg oder die Kostenzuordnung zu ermitteln. Diese Tags sind im gesamten Konto sichtbar. Weitere Informationen zur Verwendung von Tags finden Sie in Mit Tags arbeiten.
10. Wenn Sie sich für einen Professional-Tarif entschieden haben, können Sie die Instanz des IBM® Key Protect for IBM Cloud®-Dienstes oder die Instanz des IBM Cloud®- Hyper Protect Crypto Services s sowie den Root-Schlüssel auswählen, der zur Verschlüsselung Ihrer persönlichen Daten verwendet wird. Stellen Sie sicher, dass die Instanz Key Protect oder die Instanz Hyper Protect Crypto Services sowie der Root-Schlüssel vorhanden sind und dass die Toolchain-Ressourcen im Abschnitt Berechtigungen verwalten für den Zugriff auf Key Protect oder Hyper Protect Crypto Services autorisiert sind. Für die Serviceinstanz von Hyper Protect Crypto Services werden derzeit nur private Endpunkte unterstützt. Weitere Informationen dazu, welche Datentypen verschlüsselt werden, finden Sie unter Schutz Ihrer personenbezogenen Daten bei Verwendung des Professional-Plans.
11. Klicken Sie auf Erstellen.

Erstellen einer Continuous Delivery-Service-Instanz über die CLI

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. Wählen Sie das Konto, die Region und die Ressourcengruppe aus, in der Sie eine Continuous Delivery-Serviceinstanz erstellen möchten.

   ibmcloud target -c ACCOUNT -r REGION -g RESOURCE_GROUP
   

3. Erstellen Sie eine Instanz von Continuous Delivery innerhalb des Zielkontos, der Zielregion und der Zielressourcengruppe.

   ibmcloud resource service-instance-create INSTANCE_NAME continuous-delivery PLAN REGION -p ENCRYPTION
   

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

Weitere Informationen zu Plan-IDs oder zur Aktualisierung Ihres Serviceplans nach der Erstellung einer Instanz finden Sie unter Serviceplan aktualisieren.

Erstellen einer Continuous Delivery-Service-Instanz über die API

1. Rufen Sie ein IAM-Trägertoken ab.. Wenn Sie ein SDK verwenden, rufen Sie einen IAM-API-Schlüssel ab und legen Sie die Clientoptionen mithilfe von Umgebungsvariablen fest.

   export RESOURCE_CONTROLLER_APIKEY={iam_api_key}
   

2. Suchen Sie die ID der Ressourcengruppe, in der Sie Ihre Instanz erstellen wollen.

3. Wählen Sie die Region aus, in der Sie Ihre Instanz erstellen wollen.

4. Suchen Sie die ID des Serviceplans der Instanz, die Sie erstellen wollen.

5. Erstellen Sie eine Instanz von Continuous Delivery innerhalb des Zielkontos, der Zielregion und der Zielressourcengruppe.

   curl -X POST \
     https://resource-controller.cloud.ibm.com/v2/resource_instances \
     -H 'Authorization: Bearer {token}' \
     -H 'Content-Type: application/json' \
       -d '{
       "name": "{instance_name}",
       "target": "{region}",
       "resource_group": "{resource_group_id}",
       "resource_plan_id": "{plan_id}"
       "parameters": "{parameters}"
     }'
   

   import com.ibm.cloud.platform_services.resource_controller.v2.ResourceController;
   import com.ibm.cloud.platform_services.resource_controller.v2.model.*;
   ...
   ResourceController resourceControllerService = ResourceController.newInstance();
   CreateResourceInstanceOptions createCdInstanceOptions = new CreateResourceInstanceOptions.Builder()
      .name({instance_name})
      .target({region})
      .resourceGroup({resource_group_id})
      .resourcePlanId({plan_id})
      .build();
   Response<ResourceInstance> response = resourceControllerService.createResourceInstance(createCdInstanceOptions).execute();
   ResourceInstance cdInstance = response.getResult();
   

   const ResourceControllerV2 = require('@ibm-cloud/platform-services/resource-controller/v2');
   const resourceControllerService = ResourceControllerV2.newInstance({});
   ...
   (async () => {
      const params = {
         name: {instance_name},
         target: {region},
         resourceGroup: {resource_group_id},
         resourcePlanId: {plan_id},
      };
      const res = await resourceControllerService.createResourceInstance(params);
      const cdInstanceGuid = res.result.guid;
   })();
   

   from ibm_platform_services import ResourceControllerV2
   ...
   resource_controller_service = ResourceControllerV2.new_instance()
   cd_instance = resource_controller_service.create_resource_instance(
      name={instance_name},
      target={region},
      resource_group={resource_group_id},
      resource_plan_id={plan_id}
   ).get_result()
   

   import {
      "github.com/IBM/platform-services-go-sdk/resourcecontrollerv2"
   }
   ...
   resourceControllerServiceOptions := &resourcecontrollerv2.ResourceControllerV2Options{}
   resourceControllerService, err := resourcecontrollerv2.NewResourceControllerV2UsingExternalConfig(resourceControllerServiceOptions)
   createCdInstanceOptions := resourceControllerService.NewCreateResourceInstanceOptions(
      {instance_name},
      {region},
      {resource_group_id},
      {plan_id},
   )
   cdInstance, response, err := resourceControllerService.CreateResourceInstance(createCdInstanceOptions)
   

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

Weitere Informationen zum Erstellen von Serviceinstanzen finden Sie unter Neue Ressourceninstanzen mithilfe der API erstellen.

Erstellen einer Continuous Delivery-Service-Instanz 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. Erstellen Sie eine Terraform-Konfigurationsdatei mit dem Namen main.tf. Fügen Sie in dieser Datei die Konfiguration hinzu, um Ressourceninstanzen mithilfe der HashiCorp-Konfigurationssprache zu erstellen. Weitere Informationen zur Verwendung dieser Konfigurationssprache finden Sie in der Terraform-Dokumentation.

   Im folgenden Beispiel wird eine Instanz des Continuous Delivery-Dienstes mithilfe der Ressource ibm_resource_instance erstellt, wobei ein eindeutiger, beschreibender Name name ist, der die Ressourceninstanz identifiziert.

   data "ibm_resource_group" "group" {
     name = "default"
   }
   resource "ibm_resource_instance" "cd_service_instance" {
     name              = "my CD service instance"
     service           = "continuous-delivery"
     plan              = "lite"
     location          = "us-south"
     resource_group_id = data.ibm_resource_group.group.id
   }
   

   Weitere Informationen zu ibm_resource_instance finden Sie in den Argumentreferenzdetails in der Dokumentation zur Terraform-Registry.

   Um Ihre Serviceinstanz für die Verwendung der kundenverwalteten Verschlüsselung bereitzustellen, fügen Sie das Parameterattribut hinzu und füllen Sie es mit Ihrer Schlüsselmanagementserviceinstanz-ID und Rootschlüssel-ID.

     parameters = {
       kms_instance = <kms_instance_id>
       kms_key = <kms_key>
     }
   

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 eine Continuous Delivery-Serviceinstanz zu erstellen.

   terraform plan
   

5. Wenden Sie den Terraform-Ausführungsplan an. Terraform führt alle erforderlichen Aktionen aus, um die Continuous Delivery-Serviceinstanz zu erstellen.

   terraform apply