Creazione di un'istanza del servizio Continuous Delivery utilizzando la console

1. Accedi a IBM Cloud.
2. Dalla console IBM Cloud, vai a Catalogo e seleziona Servizi.
3. Seleziona la categoria Strumenti per gli sviluppatori .
4. Fai clic sul tile Continuous Delivery.
5. Seleziona la regione in cui vuoi creare il servizio Continuous Delivery.
6. Scegli un piano tariffario Lite o Professional. I piani Lite offrono le funzionalità complete di Continuous Delivery a piccoli team gratuitamente, con limiti di utilizzo. Se crei un'istanza del piano Lite, viene automaticamente eliminata dopo 30 giorni dalla creazione. Per ulteriori informazioni sui piani di servizio Continuous Delivery, vedi Utilizzo e limitazioni del piano.
7. Nella sezione Configura la tua risorsa, specifica un nome per l'istanza di Continuous Delivery che stai creando.
8. Seleziona il gruppo di risorse in cui vuoi creare l'istanza del servizio Continuous Delivery. Non puoi modificare il gruppo di risorse selezionato dopo aver creato l'istanza del servizio Continuous Delivery. Per ulteriori informazioni su come organizzare le risorse nel tuo account IBM Cloud, vedi Procedure ottimali per organizzare le risorse in un gruppo di risorse.
9. Specifica le tag che vuoi utilizzare per organizzare e filtrare le risorse nel tuo elenco di risorse. Puoi utilizzare queste tag anche per identificare l'utilizzo del team e l'assegnazione dei costi. Queste tag sono visibili in tutto l'account. Per ulteriori informazioni sull'utilizzo delle tag, vedi Gestione delle tag.
10. Se hai scelto un piano dei prezzi professionale, puoi selezionare l'istanza del servizio IBM® Key Protect for IBM Cloud® o l'istanza del IBM Cloud® Hyper Protect Crypto Servicese la chiave root utilizzata per crittografare le tue informazioni personali. Assicurati che l'istanza Key Protect o l'istanza Hyper Protect Crypto Services e la chiave root esistano e che le risorse della toolchain siano autorizzate ad accedere a Key Protect o Hyper Protect Crypto Services nella sezione Gestisci autorizzazioni. Solo gli endpoint privati sono attualmente supportati per l'istanza del servizio Hyper Protect Crypto Services. Per ulteriori informazioni sui tipi di dati crittografati, vedi Protezione dei tuoi dati personali quando utilizzi il piano Professional.
11. Fai clic su Crea.

Creazione di un'istanza del servizio Continuous Delivery dalla CLI

1. Accedi a IBM Cloud utilizzando la CLIIBM Cloud.

   ibmcloud login
   

   Se l'accesso non riesce, esegui il comando ibmcloud login --sso e prova di nuovo. Il parametro --sso è obbligatorio quando accedi con un ID federato. Se si utilizza questa opzione, andare al link elencato nell'output della CLI per generare un passcode monouso.

2. Selezionare l'account, la regione e il gruppo di risorse in cui si desidera creare un'istanza del servizio " Continuous Delivery ".

   ibmcloud target -c ACCOUNT -r REGION -g RESOURCE_GROUP
   

3. Crea un'istanza di Continuous Delivery all'interno dell'account, della regione e del gruppo di risorse di destinazione.

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

La seguente tabella elenca e descrive ciascuna delle variabili utilizzate nei passi precedenti.

Per ulteriori informazioni sugli ID del piano o su come aggiornare il piano di servizio dopo aver creato un'istanza, vedi Aggiornamento del piano di servizio.

Creazione di una istanza del servizio Continuous Delivery con la API

1. Ottieni un token di connessione IAM. In alternativa, se stai utilizzando un SDK, ottieni una chiave API IAM e imposta le opzioni client utilizzando le variabili di ambiente.

   export RESOURCE_CONTROLLER_APIKEY={iam_api_key}
   

2. Cerca l'ID del gruppo di risorse in cui vuoi creare la tua istanza.

3. Scegli la regione in cui vuoi creare la tua istanza.

4. Cerca l'ID del piano di servizio dell'istanza che vuoi creare.

5. Crea un'istanza di Continuous Delivery all'interno dell'account, della regione e del gruppo di risorse di destinazione.

   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)
   

La seguente tabella elenca e descrive ciascuna delle variabili utilizzate nei passi precedenti.

Per ulteriori informazioni sulla creazione delle istanze del servizio, vedi Creazione di nuove istanze della risorsa utilizzando l'API.

Creazione di una istanza del servizio Continuous Delivery con Terraform

1. Per installare la CLI Terraform e configurare il plug-in del provider IBM Cloud per Terraform, segui l'esercitazione per Introduzione a Terraform su IBM Cloud.

2. Crea un file di configurazione Terraform denominato “ main.tf ”. In questo file, aggiungere la configurazione per creare le istanze di risorsa utilizzando il linguaggio di configurazione HashiCorp. Per ulteriori informazioni sull'utilizzo di questa lingua di configurazione, consultare la documentazione Terraform.

   Il seguente esempio crea un'istanza del servizio Continuous Delivery utilizzando la risorsa ibm_resource_instance, dove name è un nome descrittivo univoco che identifica l'istanza della risorsa.

   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
   }
   

   Per ulteriori informazioni relative a ibm_resource_instance, consultare i dettagli di riferimento dell'argomento in Terraform Registry Documentation.

   Per eseguire il provisioning della tua istanza del servizio per utilizzare la crittografia gestita dal cliente, aggiungi e popola l'attributo dei parametri con il tuo ID istanza del servizio di gestione chiavi e l'ID chiave root.

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

3. Inizializza la CLI Terraform.

   terraform init
   

4. Creare un piano di esecuzione Terraform. Questo piano riepiloga tutte le azioni che devono essere eseguite per creare un'istanza del servizio Continuous Delivery.

   terraform plan
   

5. Applicare il piano di esecuzione di Terraform. Terraform intraprende tutte le azioni necessarie per creare l'istanza del servizio Continuous Delivery.

   terraform apply