Usando uma cadeia de ferramentas
DevOps Insights chegará ao fim de sua vida útil e será descontinuado em 31 de agosto de 2026. O serviço Continuous Delivery será descontinuado nas seguintes regiões em 12 de fevereiro de 2027: au-syd, ca-tor, us-east. O Code Risk Analyzer também será descontinuado em todas as regiões nessa data. Se uma região não apresentar uso ativo desses recursos, os recursos nessa região poderão ser descontinuados mais cedo e deixar de aceitar novas instâncias. Saiba mais
As cadeias de ferramentas abertas estão disponíveis no IBM Cloud®. É possível usar uma cadeia de ferramentas para ser produtivo em seu trabalho diário de desenvolvimento, implementação e operações. Após configurar uma cadeia de ferramentas, é possível incluir, excluir ou configurar integrações de ferramenta e gerenciar acesso à cadeia de ferramentas. Para obter mais informações sobre como trabalhar com integrações de ferramentas, consulte Trabalhando com integrações de ferramentas..
Gerenciando o acesso a cadeias de ferramentas
É possível usar o serviço Identity and Access Management (IAM) para gerenciar o acesso de usuário a cadeias de ferramentas em grupos de recursos. Para obter mais informações sobre como gerenciar o controle de acesso com o IAM, consulte Gerenciando o acesso de usuário a cadeias de ferramentas em grupos de recursos.
Os usuários com acesso a cadeias de ferramentas podem ser contados como usuários autorizados do serviço IBM Cloud® Continuous Delivery. Para obter mais informações sobre como os usuários autorizados são contados, consulte Limitações e uso do plano.
Organizando cadeias de ferramentas
É possível incluir tags em suas cadeias de ferramentas para organizá-las e localizá-las posteriormente com facilidade. Uma tag é um rótulo que você designa a uma cadeia de ferramentas para filtragem fácil de cadeias de ferramentas em sua lista de cadeias de ferramentas.
- No console IBM Cloud, clique no ícone
Menu > Automação da plataforma > Cadeias de ferramentas.
- Na página Cadeias de ferramentas, localize a cadeia de ferramentas na qual você deseja incluir uma tag e clique em Incluir tags.
- Insira um nome para a tag que deseja incluir na cadeia de ferramentas. É possível incluir múltiplas tags, que são separadas por vírgulas.
- Clique em Salvar.
Para obter mais informações sobre identificações, consulte Trabalhando com identificações.
Visualizando conexões da cadeia de ferramentas para apps, clusters e serviços
Você pode visualizar as conexões da sua cadeia de ferramentas com os clusters e serviços d Kubernetes.
- No console IBM Cloud, clique no ícone
Menu > Automação da plataforma > Cadeias de ferramentas.
- Na página Cadeias de ferramentas, clique em uma cadeia de ferramentas para abrir a sua página de Visão geral. Como alternativa, na página Detalhes do app em seu app, clique no nome da cadeia de ferramentas.
- Selecione a guia Conexões e selecione o app, o cluster ou o serviço que deseja visualizar.
Excluindo uma cadeia de ferramentas
É possível excluir uma cadeia de ferramentas. Ao excluir uma cadeia de ferramentas, todas as integrações de ferramentas que pertencem a essa cadeia de ferramentas também são excluídas. A exclusão não pode ser revertida.
Quando você exclui uma integração da ferramenta Delivery Pipeline, a Delivery Pipeline associada também é excluída.
Quando uma integração de ferramenta do GitHub ou Git Repos and Issue Tracking é excluída, o repositório associado não é excluído do GitHub ou Git Repos and Issue Tracking. Deve-se remover manualmente o repositório.
Excluindo uma cadeia de ferramentas usando o console
- No console IBM Cloud, clique no ícone
Menu > Automação da plataforma > Cadeias de ferramentas.
- Na página Cadeias de ferramentas, clique em uma cadeia de ferramentas para abrir a sua página de Visão geral. Como alternativa, na página Detalhes do app em seu app, clique no nome da cadeia de ferramentas.
- Clique no menu Ações e selecione Excluir. Excluir uma cadeia de ferramentas remove todas as suas integrações de ferramenta, que pode excluir recursos que são gerenciados por essas integrações.
- Confirme a exclusão digitando o nome da cadeia de ferramentas e clicando em Excluir.
Excluindo uma cadeia de ferramentas da CLI (Beta)
-
Efetue login no IBM Cloud usando a IBM Cloud CLI.
ibmcloud loginSe o login falhar, execute o comando
ibmcloud login --ssopara tentar novamente. O parâmetro--ssoé necessário quando você efetua login com um ID federado. Se você usar essa opção, acesse o link listado na saída da CLI para gerar uma senha única. -
Opcional. Liste todas as cadeias de ferramentas na conta, região e grupo de recursos de destino para identificar a instância que você deseja excluir.
ibmcloud dev toolchains -
Exclua uma cadeia de ferramentas executando o comando
ibmcloud dev toolchain-delete..ibmcloud dev toolchain-delete TOOLCHAIN-NAME
A tabela a seguir lista e descreve cada uma das variáveis usadas nas etapas anteriores.
| Variável | Descrição |
|---|---|
TOOLCHAIN_NAME |
O nome da cadeia de ferramentas que você deseja excluir. |
Exclusão de uma cadeia de ferramentas por meio da API
-
Obtenha um token de acesso do IAM Como alternativa, se estiver usando um SDK, obtenha uma chave de API do IAM e configure as opções do cliente usando variáveis de ambiente.
export CD_TOOLCHAIN_AUTH_TYPE=iam && \ export CD_TOOLCHAIN_APIKEY={iam_api_key} && \ export CD_TOOLCHAIN_URL={base_url} -
Exclua a cadeia de ferramentas que você deseja remover.
curl -X DELETE \ "{base_url}/toolchains/{toolchain_id}" \ -H 'Authorization: Bearer {token}'const CdToolchainV2 = require('@ibm-cloud/continuous-delivery/cd-toolchain/v2'); const toolchainService = CdToolchainV2.newInstance(); ... (async() => { const response = await toolchainService.deleteToolchain({ toolchainId: {toolchain_id} }); })();import ( "github.com/IBM/continuous-delivery-go-sdk/cdtoolchainv2" ) ... toolchainClientOptions := &cdtoolchainv2.CdToolchainV2Options{} toolchainClient, err := cdtoolchainv2.NewCdToolchainV2UsingExternalConfig(toolchainClientOptions) deleteToolchainOptions := toolchainClient.NewDeleteToolchainOptions({toolchain_id}) response, err := toolchainClient.DeleteToolchain(deleteToolchainOptions)from ibm_continuous_delivery.cd_toolchain_v2 import CdToolchainV2 ... toolchain_service = CdToolchainV2.new_instance() response = toolchain_service.delete_toolchain( toolchain_id = toolchain_id )import com.ibm.cloud.continuous_delivery.cd_toolchain.v2.CdToolchain; import com.ibm.cloud.continuous_delivery.cd_toolchain.v2.model.*; ... CdToolchain toolchainService = CdToolchain.newInstance(); DeleteToolchainOptions deleteToolchainOptions = new DeleteToolchainOptions.Builder() .toolchainId({toolchain_id}) .build(); Response<Void> response = toolchainService.deleteToolchain(deleteToolchainOptions).execute();
A tabela a seguir lista e descreve cada uma das variáveis usadas nas etapas anteriores.
| Variável | Descrição |
|---|---|
{base_url} |
O endpoint da API Toolchain URL, por exemplo, https://api.us-south.devops.cloud.ibm.com/toolchain/v2. Para obter mais informações sobre esse endpoint URL, incluindo uma lista de valores, consulte Endpoint URL. |
{iam_api_key} |
Sua chave de API do IAM. |
{token} |
Um token de portador IAM válido. |
{toolchain_id} |
O ID da cadeia de ferramentas que você deseja excluir. |
Excluindo uma cadeia de ferramentas com o Terraform
-
Localize o arquivo Terraform (por exemplo,
main.tf) que contém o blocoresourcepara a cadeia de ferramentas existente. Para obter mais informações sobre como usar o Terraform com cadeias de ferramentas, consulte Criando uma cadeia de ferramentas com o Terraform.O
resourceno exemplo a seguir descreve uma cadeia de ferramentas existente.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 } -
Remova o bloco
resourcede seu arquivo do Terraform -
Inicialize a CLI do Terraform.
terraform init -
Crie um plano de execução do Terraform. Esse plano resume todas as ações que devem ser executadas para excluir a cadeia de ferramentas.
terraform plan -
Aplique o plano de execução do Terraform. O Terraform toma todas as ações necessárias para excluir a cadeia de ferramentas
terraform apply
Gerenciamento de cadeias de ferramentas alternativas em diferentes regiões
Você pode definir sua cadeia de ferramentas usando a Terraform Configuration Language e, em seguida, aplicar e manter a definição da cadeia de ferramentas em duas regiões: uma região primária com pipelines ativos e uma região alternativa com pipelines ociosos. Se você usar Git Repos and Issue Tracking, também poderá espelhar seus repositórios Git da região primária para a região alternativa. A manutenção de cadeias de ferramentas primárias e alternativas e de repositórios Git proporciona failover e redundância mais rápidos. Além disso, garante um funcionamento sem interrupções caso surjam problemas na região principal. Ao codificar sua cadeia de ferramentas no Terraform, você pode atualizar sua cadeia de ferramentas e aplicar as alterações em ambas as regiões.
Para obter mais informações sobre o uso do Terraform, consulte Configuração do Terraform para Continuous Delivery.