Esta página foi traduzida pela API Cloud Translation.

Solução de arranque rápido: biblioteca cliente do SDK Cloud

Last reviewed 2024-03-21 UTC

Este guia ajuda a compreender e implementar a solução biblioteca cliente do Cloud SDK.

Esta solução permite-lhe interagir com o Google Cloud usando as bibliotecas cliente do Google Cloud SDK para processar e agregar dados e, em seguida, mostrar uma visualização de radar. Use esta app para identificar tendências e observações com base nos dados agregados.

Esta solução ajuda a aprender competências essenciais para fazer chamadas API com êxito. Esta solução usa as bibliotecas cliente do Google Cloud SDK para aceder às Google Cloud APIs de forma programática, tirando partido dos Google Cloud serviços (tarefas do Cloud Run e Cloud Storage) para reduzir o código repetitivo.

Nesta solução, o código analisa um conjunto de dados de exemplo (o censo de esquilos do Central Park de 2018) com tarefas do Cloud Run e do Cloud Storage. Todos os pedidos do cliente do Google Cloud SDK são registados no Cloud Logging, usando um padrão comum para permitir a resolução de problemas e a observabilidade, para que possa ver quanto tempo demoram esses pedidos e onde um processo pode encontrar um erro. Esta solução também oferece orientações para a execução de uma tarefa do Cloud Run para processar e armazenar o conjunto de dados.

As APIs são o mecanismo fundamental que os programadores usam para interagir com Google Cloud produtos e serviços. O Google Cloud SDK fornece bibliotecas cliente do Google Cloud específicas do idioma que suportam oito idiomas diferentes e as respetivas convenções e estilos. Use esta solução para saber como usar as bibliotecas de cliente do SDK Google Cloud para processar dados e implementar uma aplicação de front-end onde pode ver os resultados.

Objetivos

Este guia de soluções ajuda a fazer o seguinte:

Saiba como usar uma biblioteca cliente para Google Cloud chamadas API.
Implemente um conjunto de dados interativo com tarefas do Cloud Run e o Cloud Storage.
Explore Google Cloud chamadas API através do Cloud Logging.
Ver a aplicação do Cloud Run, as configurações da conta de serviço e as APIs ativadas e a respetiva utilização.

Arquitetura

Esta solução implementa os dados não processados num contentor no Cloud Storage, configura uma tarefa do Cloud Run para processar os dados e armazená-los num contentor separado no Cloud Storage, e implementa um serviço de front-end no Cloud Run que pode ver e interagir com os dados processados.

O diagrama seguinte mostra a arquitetura da solução:

Arquitetura da infraestrutura necessária para a solução da biblioteca cliente do Cloud SDK.

A secção seguinte descreve os Google Cloud recursos apresentados no diagrama.

Componentes e configuração

Segue-se o fluxo de processamento de pedidos desta solução. Os passos no fluxo estão numerados, conforme mostrado no diagrama de arquitetura anterior.

Os dados não processados foram carregados para um contentor do Cloud Storage.
Uma tarefa do Cloud Run transforma os dados não processados num formato mais estruturado que o serviço de front-end pode compreender. A tarefa do Cloud Run carrega os dados processados num segundo contentor do Cloud Storage.
O front-end, alojado como um serviço do Cloud Run, extrai os dados processados do segundo contentor do Cloud Storage.
O utilizador pode visitar a aplicação Web disponibilizada pelo serviço do Cloud Run de front-end.

Produtos usados

A solução usa os seguintes Google Cloud produtos:

Cloud Storage: um serviço pronto para empresas que oferece armazenamento de objetos de baixo custo e sem limite para diversos tipos de dados. Os dados são acessíveis a partir de dentro e fora do Google Cloud e são replicados de forma georredundante.
Cloud Logging: um serviço que lhe permite armazenar, pesquisar, analisar, monitorizar e enviar alertas sobre dados de registos e eventos do Google Cloud e de outras nuvens.
Cloud Run: um serviço totalmente gerido que lhe permite criar e implementar apps contentorizadas sem servidor. Google Cloud O serviço processa o dimensionamento e outras tarefas de infraestrutura para que se possa concentrar na lógica empresarial do seu código.

Custo

Para uma estimativa do custo dos Google Cloud recursos que a solução da biblioteca de cliente do SDK Cloud usa, consulte a estimativa pré-calculada na Google Cloud calculadora de preços.

Use a estimativa como ponto de partida para calcular o custo da implementação. Pode modificar a estimativa para refletir quaisquer alterações de configuração que planeie fazer aos recursos usados na solução.

A estimativa pré-calculada baseia-se em pressupostos para determinados fatores, incluindo o seguinte:

As Google Cloud localizações onde os recursos são implementados.
O tempo durante o qual os recursos são usados.
As Google Cloud localizações onde os recursos são implementados.
O tempo durante o qual os recursos são usados.

Implemente a solução

As secções seguintes explicam o processo de implementação da solução.

Crie ou escolha um Google Cloud projeto

Quando implementa a solução, escolhe o Google Cloud projeto onde os recursos são implementados. Pode criar um novo projeto ou usar um projeto existente para a implementação.

Se quiser criar um novo projeto, faça-o antes de iniciar a implementação. A utilização de um novo projeto pode ajudar a evitar conflitos com recursos aprovisionados anteriormente, como recursos usados para cargas de trabalho de produção.

Para criar um projeto, conclua os seguintes passos:

Ensure that you have the Project Creator IAM role (roles/resourcemanager.projectCreator). Learn how to grant roles.
In the Google Cloud console, go to the project selector page.

Go to project selector
Click Create project.
Name your project. Make a note of your generated project ID.
Edit the other fields as needed.
Click Create.

Obtenha as autorizações de IAM necessárias

Para iniciar o processo de implementação, precisa das autorizações da gestão de identidade e de acesso (IAM) indicadas na tabela seguinte.

Se criou um novo projeto para esta solução, tem a roles/owner função básica nesse projeto e tem todas as autorizações necessárias. Se não tiver a função de roles/owner, peça ao administrador para lhe conceder estas autorizações (ou as funções que incluem estas autorizações).

Autorização de IAM necessária	Função predefinida que inclui as autorizações necessárias
`serviceusage.services.enable`	Administrador de utilização de serviços (`roles/serviceusage.serviceUsageAdmin`)
`iam.serviceAccounts.create`	Administrador da conta de serviço (`roles/iam.serviceAccountAdmin`)
`resourcemanager.projects.setIamPolicy`	Project IAM Admin (`roles/resourcemanager.projectIamAdmin`)
`config.deployments.create` `config.deployments.list`	Administrador do Cloud Infrastructure Manager (`roles/config.admin`)
`iam.serviceAccount.actAs`	Utilizador da conta de serviço (`roles/iam.serviceAccountUser`)

Acerca das autorizações temporárias da conta de serviço

Se iniciar o processo de implementação através da consola, a Google cria uma conta de serviço para implementar a solução em seu nome (e para eliminar a implementação mais tarde, se quiser). A esta conta de serviço são atribuídas determinadas autorizações da IAM temporariamente, ou seja, as autorizações são revogadas automaticamente após a conclusão das operações de implementação e eliminação da solução. A Google recomenda que, depois de eliminar a implementação, elimine a conta de serviço, conforme descrito mais adiante neste guia.

Veja as funções atribuídas à conta de serviço

Estes papéis estão listados aqui caso um administrador do seu projeto ou organização do Google Cloud precise destas informações.

roles/storage.admin
roles/run.admin
roles/iam.serviceAccountAdmin
roles/iam.serviceAccountUser
roles/resourcemanager.projectIamAdmin
roles/iam.roleAdmin
roles/serviceusage.serviceUsageAdmin

Escolha um método de implementação

Para ajudar a implementar esta solução com o mínimo de esforço, é disponibilizada uma configuração do Terraform no GitHub. A configuração do Terraform define todos os Google Cloud recursos necessários para a solução.

Pode implementar a solução através de um dos seguintes métodos:

Através da consola: use este método se quiser experimentar a solução com a configuração predefinida e ver como funciona. O Cloud Build implementa todos os recursos necessários para a solução. Quando já não precisar da solução implementada, pode eliminá-la através da consola. Quaisquer recursos que criar depois de implementar a solução podem ter de ser eliminados separadamente.

Para usar este método de implementação, siga as instruções em Implemente através da consola.
Usando a CLI do Terraform: use este método se quiser personalizar a solução ou se quiser automatizar o aprovisionamento e a gestão dos recursos usando a abordagem de infraestrutura como código (IaC). Transfira a configuração do Terraform a partir do GitHub, personalize opcionalmente o código conforme necessário e, em seguida, implemente a solução através da CLI do Terraform. Depois de implementar a solução, pode continuar a usar o Terraform para gerir a solução.

Para usar este método de implementação, siga as instruções em Implemente através da CLI do Terraform.

Implemente através da consola

Conclua os passos seguintes para implementar a solução pré-configurada.

No catálogo de Google Cloud soluções de início rápido, aceda à solução biblioteca cliente do SDK Cloud.

Aceda à solução da biblioteca cliente do SDK do Google Cloud
Reveja as informações apresentadas na página, como o custo estimado da solução e o tempo de implementação estimado.
Quando tiver tudo pronto para começar a implementar a solução, clique em Implementar.

É apresentado um painel de configuração passo a passo.
Conclua os passos no painel de configuração.

Tome nota do nome que introduz para a implementação. Este nome é necessário mais tarde quando eliminar a implementação.

Quando clica em Implementar, é apresentada a página Implementações de soluções. O campo Estado nesta página mostra Implementação.
Aguarde a implementação da solução.

Se a implementação falhar, o campo Estado apresenta Falhou. Pode usar o registo do Cloud Build para diagnosticar os erros. Para mais informações, consulte Erros ao implementar através da consola.

Após a conclusão da implementação, o campo Estado é alterado para Implementado.
Para ver a solução, regresse à página Implementações de soluções na consola.
Com esta solução, tem de executar a tarefa de processamento de dados através de tarefas do Cloud Run para poder transformar e interagir com o conjunto de dados de amostra. Para seguir orientações passo a passo para esta tarefa diretamente na Google Cloud consola, clique em Iniciar a tarefa de processamento de dados.

Inicie a tarefa de processamento de dados
Para ver os Google Cloud recursos implementados e a respetiva configuração, escolha uma visita interativa no seu idioma preferido (Python, Node.js ou Java).

Escolha uma visita guiada

Agora que processou o conjunto de dados de amostra num contentor do Cloud Storage, pode continuar a usar a solução da biblioteca de cliente do SDK Cloud para explorar mais sobre a interação com as Google Cloud APIs, como as APIs são alimentadas pela gestão de identidades e acessos e a resolução de problemas de API nas apps de API de cliente do Google Cloud.

Quando já não precisar da solução, pode eliminar a implementação para evitar a faturação contínua dos Google Cloud recursos. Para mais informações, consulte Elimine a implementação.

Faça a implementação através da CLI do Terraform

Esta secção descreve como pode personalizar a solução ou automatizar o aprovisionamento e a gestão da solução através da CLI do Terraform. As soluções implementadas através da CLI do Terraform não são apresentadas na página Implementações de soluções na Google Cloud consola.

Configure o cliente do Terraform

Pode executar o Terraform no Cloud Shell ou no seu anfitrião local. Este guia descreve como executar o Terraform no Cloud Shell, que tem o Terraform pré-instalado e configurado para autenticação com o Google Cloud.

O código do Terraform para esta solução está disponível num repositório do GitHub.

Clone o repositório do GitHub para o Cloud Shell.

É apresentada uma mensagem para confirmar a transferência do repositório do GitHub para o Cloud Shell.
Clique em Confirm.

O Cloud Shell é iniciado num separador do navegador separado e o código do Terraform é transferido para o diretório $HOME/cloudshell_open do seu ambiente do Cloud Shell.
No Cloud Shell, verifique se o diretório de trabalho atual é $HOME/cloudshell_open/terraform-cloud-client-api/infra. Este é o diretório que contém os ficheiros de configuração do Terraform para a solução. Se precisar de alterar para esse diretório, execute o seguinte comando:
```
cd $HOME/cloudshell_open/terraform-cloud-client-api/infra
```
Inicialize o Terraform executando o seguinte comando:
```
terraform init
```
Aguarde até ver a seguinte mensagem:
```
Terraform has been successfully initialized!
```

Configure as variáveis do Terraform

O código do Terraform que transferiu inclui variáveis que pode usar para personalizar a implementação com base nos seus requisitos. Por exemplo, pode especificar o Google Cloud projeto e aregião onde quer que a solução seja implementada.

Certifique-se de que o diretório de trabalho atual é $HOME/cloudshell_open/terraform-cloud-client-api/infra. Se não for, aceda a esse diretório.
No mesmo diretório, crie um ficheiro de texto com o nome terraform.tfvars.
No ficheiro terraform.tfvars, copie o seguinte fragmento do código e defina os valores para as variáveis necessárias.
- Siga as instruções fornecidas como comentários no fragmento de código.
- Este fragmento do código inclui apenas as variáveis para as quais tem de definir valores. A configuração do Terraform inclui outras variáveis que têm valores predefinidos. Para rever todas as variáveis e os valores predefinidos, consulte o ficheiro variables.tf que está disponível no diretório $HOME/cloudshell_open/terraform-cloud-client-api/infra.
- Certifique-se de que cada valor que define no ficheiro terraform.tfvars corresponde ao tipo de variável, conforme declarado no ficheiro variables.tf. Por exemplo, se o tipo definido para uma variável no ficheiro variables.tf for bool, tem de especificar true ou false como o valor dessa variável no ficheiro terraform.tfvars.
```
# ID of the project in which you want to deploy the solution
project_id = "PROJECT_ID"

# Google Cloud region where you want to deploy the solution
# Example: us-central1
region = "REGION"

# Programming language implementation to use
# Example: python
language = "LANGUAGE"

# Version of application image to use
# Example: 0.4.0
image_version = "IMAGE_VERSION"
```

Para informações sobre os valores que pode atribuir às variáveis obrigatórias, consulte o seguinte:

project_id: identificar projetos.
region: Regiões disponíveis.
language: implementação da linguagem de programação a usar.
image_version: versão da imagem da aplicação a usar.

Valide e reveja a configuração do Terraform

Certifique-se de que o diretório de trabalho atual é $HOME/cloudshell_open/terraform-cloud-client-api/infra. Se não for, aceda a esse diretório.
Verifique se a configuração do Terraform não tem erros:
```
terraform validate
```
Se o comando devolver erros, faça as correções necessárias na configuração e, em seguida, execute novamente o comando terraform validate. Repita este passo até o comando devolver a seguinte mensagem:
```
Success! The configuration is valid.
```
Reveja os recursos definidos na configuração:
```
terraform plan
```
Se não criou o ficheiro terraform.tfvars conforme descrito anteriormente, o Terraform pede-lhe que introduza valores para as variáveis que não têm valores predefinidos. Introduza os valores obrigatórios.

O resultado do comando terraform plan é uma lista dos recursos que o Terraform aprovisiona quando aplica a configuração.

Se quiser fazer alterações, edite a configuração e, em seguida, execute novamente os comandos terraform validate e terraform plan.

Aprovisione os recursos

Quando não forem necessárias mais alterações na configuração do Terraform, implemente os recursos.

Certifique-se de que o diretório de trabalho atual é $HOME/cloudshell_open/terraform-cloud-client-api/infra. Se não for, aceda a esse diretório.
Aplique a configuração do Terraform:
```
terraform apply
```
Se não criou o ficheiro terraform.tfvars conforme descrito anteriormente, o Terraform pede-lhe que introduza valores para as variáveis que não têm valores predefinidos. Introduza os valores obrigatórios.

O Terraform apresenta uma lista dos recursos que vão ser criados.
Quando lhe for pedido para realizar as ações, introduza yes.

O Terraform apresenta mensagens que mostram o progresso da implementação.

Se não for possível concluir a implementação, o Terraform apresenta os erros que causaram a falha. Reveja as mensagens de erro e atualize a configuração para corrigir os erros. Em seguida, execute novamente o comando terraform apply. Para obter ajuda na resolução de problemas de erros do Terraform, consulte o artigo Erros ao implementar a solução com a CLI do Terraform.

Depois de criar todos os recursos, o Terraform apresenta a seguinte mensagem:
```
Apply complete!
```
Para ver a solução, regresse à página Implementações de soluções na consola.
Com esta solução, tem de executar a tarefa de processamento de dados através de tarefas do Cloud Run para poder transformar e interagir com o conjunto de dados de amostra. Para seguir orientações passo a passo para esta tarefa diretamente na Google Cloud consola, clique em Iniciar a tarefa de processamento de dados.

Inicie a tarefa de processamento de dados
Para ver os Google Cloud recursos implementados e a respetiva configuração, escolha uma visita interativa no seu idioma preferido (Python, Node.js ou Java).

Escolha uma visita guiada

Agora que processou o conjunto de dados de amostra num contentor do Cloud Storage, pode continuar a usar a solução da biblioteca de cliente do SDK Cloud para explorar mais sobre a interação com as Google Cloud APIs, como as APIs são alimentadas pela gestão de identidades e acessos e a resolução de problemas de API nas apps de API de cliente do Google Cloud.

Quando já não precisar da solução, pode eliminar a implementação para evitar a faturação contínua dos Google Cloud recursos. Para mais informações, consulte Elimine a implementação.

Elimine a implementação

Quando já não precisar da solução, para evitar a faturação contínua dos recursos que criou nesta solução, elimine todos os recursos.

Elimine-o através da consola

Use este procedimento se implementou a solução através da consola.

Na Google Cloud consola, aceda à página Implementações de soluções.

Aceda a Implementações de soluções
Selecione o projeto que contém a implementação que quer eliminar.
Localize a implementação que quer eliminar.
Na linha da implementação, clique em Ações e, de seguida, selecione Eliminar.

Pode ter de deslocar a página para ver Ações na linha.
Introduza o nome da implementação e, de seguida, clique em Confirmar.

O campo Estado mostra A eliminar.

Se a eliminação falhar, consulte as orientações de resolução de problemas em Erro ao eliminar uma implementação.

Quando já não precisar do Google Cloud projeto que usou para a solução, pode eliminá-lo. Para mais informações, consulte a secção Opcional: elimine o projeto.

Elimine através da CLI do Terraform

Use este procedimento se tiver implementado a solução através da CLI do Terraform.

No Cloud Shell, certifique-se de que o diretório de trabalho atual é $HOME/cloudshell_open/terraform-cloud-client-api/infra. Se não for, aceda a esse diretório.
Remova os recursos aprovisionados pelo Terraform:
```
terraform destroy
```
O Terraform apresenta uma lista dos recursos que vão ser destruídos.
Quando lhe for pedido para realizar as ações, introduza yes.

O Terraform apresenta mensagens que mostram o progresso. Depois de todos os recursos serem eliminados, o Terraform apresenta a seguinte mensagem:
```
Destroy complete!
```
Se a eliminação falhar, consulte as orientações de resolução de problemas em Erro ao eliminar uma implementação.

Quando já não precisar do Google Cloud projeto que usou para a solução, pode eliminá-lo. Para mais informações, consulte a secção Opcional: elimine o projeto.

Opcional: elimine o projeto

Se implementou a solução num novo Google Cloud projeto e já não precisa do projeto, elimine-o concluindo os seguintes passos:

Na Google Cloud consola, aceda à página Gerir recursos.
Aceda a Gerir recursos
Na lista de projetos, selecione o projeto que quer eliminar e, de seguida, clique em Eliminar.
Na mensagem, escreva o ID do projeto e, de seguida, clique em Encerrar.

Se decidir manter o projeto, elimine a conta de serviço que foi criada para esta solução, conforme descrito na secção seguinte.

Opcional: elimine a conta de serviço

Se eliminou o projeto que usou para a solução, ignore esta secção.

Conforme mencionado anteriormente neste guia, quando implementou a solução, foi criada uma conta de serviço em seu nome. Foram atribuídas determinadas autorizações do IAM à conta de serviço temporariamente, ou seja, as autorizações foram revogadas automaticamente após a conclusão das operações de implementação e eliminação da solução, mas a conta de serviço não é eliminada. A Google recomenda que elimine esta conta de serviço.

Se implementou a solução através da Google Cloud consola, aceda à página Implementações de soluções. (Se já estiver nessa página, atualize o navegador.) É acionado um processo em segundo plano para eliminar a conta de serviço. Não é necessária nenhuma ação adicional.
Se implementou a solução através da CLI do Terraform, conclua os seguintes passos:
1. Na Google Cloud consola, aceda à página Contas de serviço.
  
  Aceda a Contas de serviço
2. Selecione o projeto que usou para a solução.
3. Selecione a conta de serviço que quer eliminar.
  
  O ID de email da conta de serviço que foi criada para a solução está no seguinte formato:
```
goog-sc-DEPLOYMENT_NAME-NNN@PROJECT_ID.iam.gserviceaccount.com
```
  O ID do email contém os seguintes valores:
  - DEPLOYMENT_NAME: o nome da implementação.
  - NNN: um número aleatório de 3 dígitos.
  - PROJECT_ID: o ID do projeto no qual implementou a solução.
4. Clique em Eliminar.

Resolva problemas de erros

As ações que pode realizar para diagnosticar e resolver erros dependem do método de implementação e da complexidade do erro.

Erros ao implementar através da consola

Se a implementação falhar quando usa a consola, faça o seguinte:

Aceda à página Implementações de soluções.

Se a implementação falhar, o campo Estado apresenta Falhou.
Veja os detalhes dos erros que causaram a falha:
1. Na linha da implementação, clique em Ações.
  
  Pode ter de deslocar a página para ver Ações na linha.
2. Selecione Ver registos do Cloud Build.
Reveja o registo do Cloud Build e tome as medidas adequadas para resolver o problema que causou a falha.

Erros ao implementar através da CLI do Terraform

Se a implementação falhar quando usa o Terraform, o resultado do comando terraform apply inclui mensagens de erro que pode rever para diagnosticar o problema.

Os exemplos nas secções seguintes mostram erros de implementação que pode encontrar quando usa o Terraform.

Erro de API não ativada

Se criar um projeto e, de seguida, tentar implementar a solução no novo projeto, a implementação pode falhar com um erro semelhante ao seguinte:

Error: Error creating Network: googleapi: Error 403: Compute Engine API has not
been used in project PROJECT_ID before or it is disabled. Enable it by visiting
https://console.developers.google.com/apis/api/compute.googleapis.com/overview?project=PROJECT_ID
then retry. If you enabled this API recently, wait a few minutes for the action
to propagate to our systems and retry.

Se este erro ocorrer, aguarde alguns minutos e, em seguida, execute novamente o comando terraform apply.

Erro ao eliminar uma implementação

Em determinados casos, as tentativas de eliminar uma implementação podem falhar:

Após implementar uma solução através da consola, se alterar qualquer recurso aprovisionado pela solução e, em seguida, tentar eliminar a implementação, a eliminação pode falhar. O campo Estado na página Implementações de soluções mostra Falhou e o registo do Cloud Build mostra a causa do erro.
Depois de implementar uma solução através da CLI do Terraform, se alterar qualquer recurso através de uma interface não pertencente ao Terraform (por exemplo, a consola) e, em seguida, tentar eliminar a implementação, a eliminação pode falhar. As mensagens no resultado do comando terraform destroy mostram a causa do erro.

Reveja os registos e as mensagens de erro, identifique e elimine os recursos que causaram o erro e, de seguida, tente eliminar a implementação novamente.

Se uma implementação baseada na consola não for eliminada e não conseguir diagnosticar o erro através do registo do Cloud Build, pode eliminar a implementação através da CLI do Terraform, conforme descrito na secção seguinte.

Elimine uma implementação baseada na consola através da CLI do Terraform

Esta secção descreve como eliminar uma implementação baseada na consola se ocorrerem erros quando tentar eliminá-la através da consola. Nesta abordagem, transfere a configuração do Terraform para a implementação que quer eliminar e, em seguida, usa a CLI do Terraform para eliminar a implementação.

Identifique a região onde o código, os registos e outros dados do Terraform da implementação são armazenados. Esta região pode ser diferente da região que selecionou durante a implementação da solução.
1. Na Google Cloud consola, aceda à página Implementações de soluções.
  
  Aceda a Implementações de soluções
2. Selecione o projeto que contém a implementação que quer eliminar.
3. Na lista de implementações, identifique a linha da implementação que quer eliminar.
4. Clique em Ver todo o conteúdo da linha.
5. Na coluna Localização, repare na segunda localização, conforme realçado no exemplo seguinte:
In the Google Cloud console, activate Cloud Shell.

Activate Cloud Shell

At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Crie variáveis de ambiente para o ID do projeto, a região e o nome da implementação que quer eliminar:
```
export REGION="REGION"
export PROJECT_ID="PROJECT_ID"
export DEPLOYMENT_NAME="DEPLOYMENT_NAME"
```
Nestes comandos, substitua o seguinte:
- REGION: a localização que indicou anteriormente neste procedimento.
- PROJECT_ID: o ID do projeto onde implementou a solução.
- DEPLOYMENT_NAME: o nome da implementação que quer eliminar.

Obtenha o ID da revisão mais recente da implementação que quer eliminar:

export REVISION_ID=$(curl \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    "https://config.googleapis.com/v1alpha2/projects/${PROJECT_ID}/locations/${REGION}/deployments/${DEPLOYMENT_NAME}" \
    | jq .latestRevision -r)
    echo $REVISION_ID

O resultado é semelhante ao seguinte:

projects/PROJECT_ID/locations/REGION/deployments/DEPLOYMENT_NAME/revisions/r-0

Obtenha a localização do Cloud Storage da configuração do Terraform para a implementação:

export CONTENT_PATH=$(curl \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    "https://config.googleapis.com/v1alpha2/${REVISION_ID}" \
    | jq .applyResults.content -r)
    echo $CONTENT_PATH

Segue-se um exemplo do resultado deste comando:

gs://PROJECT_ID-REGION-blueprint-config/DEPLOYMENT_NAME/r-0/apply_results/content

Transfira a configuração do Terraform do Cloud Storage para o Cloud Shell:
```
gcloud storage cp $CONTENT_PATH $HOME --recursive
cd $HOME/content/infra
```
Aguarde até que a mensagem Operation completed seja apresentada, conforme mostrado no exemplo seguinte:
```
Operation completed over 45 objects/268.5 KiB
```

Inicialize o Terraform:

terraform init

Aguarde até ver a seguinte mensagem:

Terraform has been successfully initialized!

Remova os recursos implementados:
```
terraform destroy
```
O Terraform apresenta uma lista dos recursos que vão ser destruídos.

Se forem apresentados avisos sobre variáveis não declaradas, ignore-os.
Quando lhe for pedido para realizar as ações, introduza yes.

O Terraform apresenta mensagens que mostram o progresso. Depois de todos os recursos serem eliminados, o Terraform apresenta a seguinte mensagem:
```
Destroy complete!
```

Elimine o artefacto de implementação:

curl -X DELETE \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    "https://config.googleapis.com/v1alpha2/projects/${PROJECT_ID}/locations/${REGION}/deployments/${DEPLOYMENT_NAME}?force=true&delete_policy=abandon"

Aguarde alguns segundos e, em seguida, verifique se o artefacto de implementação foi eliminado:

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    "https://config.googleapis.com/v1alpha2/projects/${PROJECT_ID}/locations/${REGION}/deployments/${DEPLOYMENT_NAME}" \
    | jq .error.message

Se o resultado apresentar null, aguarde alguns segundos e, em seguida, execute o comando novamente.

Após a eliminação do artefacto de implementação, é apresentada uma mensagem, conforme mostrado no exemplo seguinte:

Resource 'projects/PROJECT_ID/locations/REGION/deployments/DEPLOYMENT_NAME' was not found

Enviar feedback

As soluções de arranque rápido destinam-se apenas a fins informativos e não são produtos oficialmente suportados. A Google pode alterar ou remover soluções sem aviso prévio.

Para resolver problemas de erros, reveja os registos do Cloud Build e o resultado do Terraform.

Para enviar feedback, faça o seguinte:

Para aceder à documentação, aos tutoriais na consola ou à solução, use o botão Enviar feedback na página.

Para código Terraform não modificado, crie problemas no repositório do GitHub. Os problemas do GitHub são revistos com base no melhor esforço e não se destinam a perguntas de utilização geral.

Para problemas com os produtos usados na solução, contacte o apoio técnico ao cliente do Google Cloud.

O que se segue?

Para explorar mais através da solução da biblioteca cliente do Cloud SDK:

Saiba mais sobre as APIs que alimentam Google Cloud> e como interagir com elas na sua linguagem de programação preferencial.
Saiba como as APIs são baseadas na gestão de identidades e acessos no Google Cloud.
Resolva problemas de API nas apps da API Cloud Client.

Colaboradores

Autor: Kadeem Dunn | Redator técnico

Outro colaborador: Katie McLaughlin | Senior Developer Relations Engineer