Creación de una instancia de servicio de Continuous Delivery utilizando la consola

1. Inicie sesión en IBM Cloud.
2. En la consola de IBM Cloud, pulse Catálogo y seleccione Servicios.
3. Seleccione la categoría Herramientas del desarrollador.
4. Pulse el mosaico Continuous Delivery.
5. Seleccione la región donde desea crear el servicio Continuous Delivery.
6. Elige un plan de precios Lite o Professional. Los planes Lite ofrecen las funciones completas de Continuous Delivery a equipos pequeños de forma gratuita, sin limitación de uso. Si crea una instancia de plan Lite, se suprimirá automáticamente tras treinta (30) días después de haberla creado. Para obtener más información sobre los planes de servicio de Continuous Delivery, consulte Limitaciones y uso del plan.
7. En la sección Configurar su recurso, especifique un nombre para la instancia de Continuous Delivery que está creando.
8. Seleccione el grupo de recursos donde desea crear la instancia de servicio de Continuous Delivery. No puede cambiar el grupo de recursos seleccionado tras haber creado la instancia de servicio de Continuous Delivery. Para obtener más información sobre cómo organizar los recursos en la cuenta de IBM Cloud, consulte Prácticas recomendadas para la organización de recursos en un grupo de recursos.
9. Especifique las etiquetas que desea utilizar para organizar y filtrar los recursos en su lista de recursos. También puede utilizar estas etiquetas para identificar el uso del equipo o la asignación de costes. Estas etiquetas son visibles en toda la cuenta. Para obtener más información sobre cómo utilizar las etiquetas, consulte Cómo trabajar con etiquetas.
10. Si ha elegido un plan de precios Professional, puede seleccionar la instancia del servicio IBM® Key Protect for IBM Cloud® o la instancia del servicio IBM Cloud® Hyper Protect Crypto Services, así como la clave raíz que se utiliza para cifrar su información personal. Asegúrese de que la instancia de Key Protect o la de Hyper Protect Crypto Services y la clave raíz existan, y de que los recursos de la cadena de herramientas estén autorizados para acceder a Key Protect o Hyper Protect Crypto Services en la sección Gestionar autorizaciones. Actualmente solo se da soporte a puntos finales privados para la instancia de servicio Hyper Protect Crypto Services. Para obtener más información sobre qué tipos de datos están cifrados, consulte Protección de los datos personales cuando utilice el plan Profesional.
11. Pulse Crear.

Creación de una instancia del servicio Continuous Delivery desde la CLI

1. Inicie sesión en IBM Cloud utilizando la CLI deIBM Cloud.

   ibmcloud login
   

   Si el inicio de sesión falla, ejecute el mandato ibmcloud login --sso para volver a intentarlo. Se requiere el parámetro --sso para iniciar sesión con un ID federado. Si utiliza esta opción, vaya al enlace que aparece en la salida de la CLI para generar un código de acceso de un solo uso.

2. Seleccione la cuenta, la región y el grupo de recursos en los que desea crear una instancia de servicio de Continuous Delivery.

   ibmcloud target -c ACCOUNT -r REGION -g RESOURCE_GROUP
   

3. Cree una instancia de Continuous Delivery dentro de la cuenta, región y grupo de recursos de destino.

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

La tabla siguiente lista y describe cada una de las variables que se utilizan en los pasos anteriores.

Para obtener más información sobre los ID de plan o sobre cómo actualizar el plan de servicio después de crear una instancia, consulte Actualización del plan de servicio.

Creación de una instancia del servicio Continuous Delivery mediante la API

1. Obtener una señal portadora de IAM. De forma alternativa, si utiliza un SDK, obtenga una clave de API de IAM y establezca las opciones de cliente utilizando variables de entorno.

   export RESOURCE_CONTROLLER_APIKEY={iam_api_key}
   

2. Busque el ID del grupo de recursos en el que desea crear la instancia.

3. Elija la región en la que desea crear la instancia.

4. Busque el ID del plan de servicio de la instancia que desea crear.

5. Cree una instancia de Continuous Delivery dentro de la cuenta, región y grupo de recursos de destino.

   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 tabla siguiente lista y describe cada una de las variables que se utilizan en los pasos anteriores.

Para obtener más información sobre la creación de instancias de servicio, consulte Creación de nuevas instancias de recursos utilizando la API.

Creación de una instancia del servicio Continuous Delivery con Terraform

1. Para instalar la CLI de Terraform y configurar el plug-in de proveedor de IBM Cloud para Terraform, siga la guía de aprendizaje Cómo empezar con Terraform en IBM Cloud.

2. Cree un archivo de configuración de Terraform denominado main.tf. En este archivo, añade la configuración para crear instancias de recursos utilizando el lenguaje de configuración de la plataforma de servicios en la nube de IBM ( HashiCorp ). Para obtener más información sobre cómo utilizar este idioma de configuración, consulte la documentación de Terraform.

   El siguiente ejemplo crea una instancia del servicio Continuous Delivery utilizando el recurso ibm_resource_instance, donde name es un nombre único y descriptivo que identifica la instancia del recurso.

   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
   }
   

   Para obtener más información sobre ibm_resource_instance, consulte los detalles de referencia de argumentos en la Documentación del registro de Terraform.

   Para suministrar la instancia de servicio para utilizar el cifrado gestionado por el cliente, añada y llene el atributo de parámetros con el ID de instancia de servicio de gestión de claves y el ID de clave raíz.

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

3. Inicialice la CLI de Terraform.

   terraform init
   

4. Cree un plan de ejecución de Terraform. Este plan resume todas las acciones que se deben ejecutar para crear una instancia de servicio de Continuous Delivery.

   terraform plan
   

5. Aplica el plan de ejecución de Terraform. Terraform realiza todas las acciones necesarias para crear la instancia de servicio Continuous Delivery.

   terraform apply