Criando uma instância de serviço Continuous Delivery usando o console

1. Efetue login na IBM Cloud.
2. No console do IBM Cloud, clique em Catálogo e selecione Serviços.
3. Selecione a categoria Ferramentas do desenvolvedor.
4. Clique no tile Continuous Delivery.
5. Selecione a região na qual você deseja criar o serviço Continuous Delivery.
6. Escolha um plano de preços Lite ou Professional. Os planos Lite oferecem os recursos integrais do Continuous Delivery para pequenas equipes sem custo, com limites de uso. Se você criar uma instância do plano Lite, ela será excluída automaticamente 30 dias após a criação. Para obter mais informações sobre os planos de serviço do Continuous Delivery, consulte Limitações e uso do plano.
7. Na seção Configurar seu recurso, especifique um nome para a instância do Continuous Delivery que você está criando.
8. Selecione o grupo de recursos no qual você deseja criar a instância de serviço do Continuous Delivery. Não é possível mudar o grupo de recursos selecionado depois de criar a instância de serviço do Continuous Delivery. Para obter mais informações sobre como organizar os recursos em sua conta do IBM Cloud, consulte Melhores práticas para organizar recursos em um grupo de recursos.
9. Especifique as tags que você deseja usar para organizar e filtrar os recursos em sua lista de recursos. Também é possível usar essas tags para identificar o uso de equipe ou alocação de custo. Essas tags são visíveis em toda a conta. Para obter mais informações sobre o uso de tags, consulte Trabalhando com tags.
10. Se você escolheu um plano de preços Professional, poderá selecionar a instância do serviço IBM® Key Protect for IBM Cloud® ou a instância do IBM Cloud® Hyper Protect Crypto Services, bem como a chave raiz utilizada para criptografar suas informações pessoais. Certifique-se de que a instância Key Protect ou a instância Hyper Protect Crypto Services e a chave raiz existam e que os recursos da cadeia de ferramentas estejam autorizados a acessar Key Protect ou Hyper Protect Crypto Services na seção “Gerenciar autorizações ”. Apenas os terminais privados são atualmente suportados para a instância de serviço Hyper Protect Crypto Services. Para obter mais informações sobre quais tipos de dados são criptografados, consulte Protegendo seus dados pessoais quando você usa o plano Professional.
11. Clique em Criar.

Criação de uma instância do serviço “ Continuous Delivery ” a partir da CLI

1. Faça login em IBM Cloud usando o IBM Cloud CLI.

   ibmcloud login
   

   Se o login falhar, execute o comando ibmcloud login --sso para tentar novamente. O parâmetro --sso é necessário quando você efetua login com um ID federado. Se você utilizar esta opção, vá para o link listado na saída CLI para gerar um passcode único.

2. Selecione a conta, a região e o grupo de recursos no qual você deseja criar uma instância de serviço do Continuous Delivery.

   ibmcloud target -c ACCOUNT -r REGION -g RESOURCE_GROUP
   

3. Crie uma instância de Continuous Delivery dentro da conta direcionada, região e grupo de recursos.

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

A tabela a seguir lista e descreve cada uma das variáveis que são utilizadas nas etapas anteriores.

Para obter mais informações sobre IDs de planos ou sobre como atualizar seu plano de serviços após criar uma instância, consulte Atualizando seu plano de serviço.

Criação de uma instância do serviço “ Continuous Delivery ” por meio da API

1. Obter um token de portador de IAM. Alternativamente, se você estiver usando um SDK, obtenha uma chave API IAM e configure as opções do cliente usando variáveis de ambiente.

   export RESOURCE_CONTROLLER_APIKEY={iam_api_key}
   

2. Consulte o ID do grupo de recursos no qual você deseja criar sua instância.

3. Escolha a região em que deseja criar sua instância.

4. Consulte o ID do plano de serviço da instância que você deseja criar.

5. Crie uma instância de Continuous Delivery dentro da conta direcionada, região e grupo de recursos.

   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)
   

A tabela a seguir lista e descreve cada uma das variáveis que são utilizadas nas etapas anteriores.

Para obter mais informações sobre a criação de instâncias de serviço, consulte Criando novas instâncias de recursos usando a API.

Criação de uma instância do serviço “ Continuous Delivery ” com o Terraform

1. Para instalar a CLI do Terraform e configurar o plug-in do IBM Cloud Provider para o Terraform, siga o tutorial de Introdução ao Terraform no IBM Cloud.

2. Crie um arquivo de configuração do Terraform que seja denominado main.tf. Neste arquivo, adicione a configuração para criar instâncias de recursos utilizando a Linguagem de Configuração do HashiCorp. Para obter mais informações sobre o uso dessa linguagem de configuração, consulte a documentação Terraform.

   O exemplo a seguir cria uma instância do serviço “ Continuous Delivery ” usando o recurso ibm_resource_instance, em que name é um nome único e descritivo que identifica a instância do 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 obter mais informações sobre ibm_resource_instance, consulte os detalhes de referência do argumento na Documentação do Terraform Registry.

   Para provisionar sua instância de serviço para usar a criptografia gerenciada pelo cliente, inclua e preencha o atributo de parâmetros com seu ID da instância de serviço de gerenciamento de chave e o ID da chave raiz

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

3. Inicialize a CLI do Terraform.

   terraform init
   

4. Crie um plano de execução do Terraform. Este plano resume todas as ações que devem ser executadas para criar uma instância de serviço Continuous Delivery.

   terraform plan
   

5. Aplique o plano de execução do Terraform. O Terraform toma todas as ações necessárias para criar a instância de serviço Continuous Delivery.

   terraform apply