Neste documento, explicamos como excluir uma implantação azul-verde do Cloud SQL e detalhamos a diferença crítica no comportamento de exclusão antes e depois da alternância.
Antes de começar
Para excluir ou cancelar uma implantação azul-verde, verifique se você tem os papéis e as permissões necessários.
Papéis e permissões necessárias
Para receber as permissões necessárias para excluir uma implantação azul-verde, peça ao administrador para conceder a você o seguinte papel do IAM no projeto:
- Administrador do Cloud SQL (
roles/cloudsql.admin)
Para funções personalizadas, verifique se você tem as seguintes permissões:
cloudsql.blueGreenDeployments.deletecloudsql.blueGreenDeployments.getcloudsql.instances.deletecloudsql.operations.get
Para mais informações sobre os papéis e as permissões do IAM no Cloud SQL, consulte Papéis e permissões.
Comportamentos de exclusão
A operação delete se comporta de maneira diferente dependendo se
a troca ocorreu:
| Estágio de implantação | Comportamento padrão | Impacto na instância |
|---|---|---|
| Antes da troca (Cancelar) |
Exclui os metadados de implantação e a instância de preparo verde automaticamente. | A instância de produção azul continua em execução e não é afetada. |
| Após a troca (Excluir) |
Exclui os metadados da implantação, mas mantém as duas instâncias como independentes por padrão. | A instância verde continua atendendo ao tráfego de produção como sua
instância de banco de dados ativa de leitura e gravação. A instância azul é
mantida como uma instância independente, a menos que você selecione a opção
Excluir instância de origem antiga, transmita a flag opcional
--delete-old-source, defina
delete_old_source_on_destroy = true no Terraform antes de
remover o bloco de código blue_green_deployment ou defina o
parâmetro deleteOldSource como true para
excluí-la. |
Caso 1: cancelar uma implantação antes da transição
Se você detectar problemas durante a validação ou decidir não prosseguir com um upgrade, exclua a implantação antes de acionar a troca.
Console
-
No console do Google Cloud , acesse a página Instâncias do Cloud SQL.
- Para abrir a página Visão geral de uma instância, clique no nome dela.
- No card Status da implantação azul-verde, clique em Detalhes para abrir a página Visão geral da implantação.
- Clique em Excluir implantação.
- Na caixa de diálogo Excluir implantação?, insira o ID da implantação no campo ID da implantação para confirmar.
- Clique em Excluir.
gcloud
Para cancelar e excluir uma implantação azul-verde usando a CLI gcloud, execute o comando gcloud
sql blue-green-deployments delete:
gcloud sql blue-green-deployments delete DEPLOYMENT_NAME \ --region=REGION
Substitua:
- DEPLOYMENT_NAME: o nome da implantação azul-verde.
- REGION: a região do Google Cloud em que a implantação foi criada.
Terraform
Para cancelar e excluir uma implantação azul-verde antes da transição usando o Terraform (enquanto o campo active_environment está definido como "SOURCE"), remova o bloco de código blue_green_deployment do recurso google_sql_database_instance e mantenha o campo database_version definido como a versão de origem azul:
resource "google_sql_database_instance" "primary" { name = "SOURCE_INSTANCE_ID" region = "REGION" database_version = "SOURCE_DATABASE_VERSION" settings { tier = "MACHINE_TIER" edition = "EDITION" availability_type = "REGIONAL" backup_configuration { enabled = true binary_log_enabled = true } } }
Substitua:
- SOURCE_INSTANCE_ID: o nome da instância de origem azul.
- REGION: a região do Google Cloud em que a implantação foi criada.
- SOURCE_DATABASE_VERSION: a versão do banco de dados da instância de origem azul (por exemplo,
MYSQL_8_0). - MACHINE_TIER: o tipo de máquina da instância (por
exemplo,
db-custom-2-7680). - EDITION: a edição do Cloud SQL da sua instância
(
ENTERPRISEouENTERPRISE_PLUS).
Quando você remove o bloco de código blue_green_deployment antes
da troca, o Terraform cancela a implantação e exclui a instância de preparo
verde, independentemente da configuração
delete_old_source_on_destroy.
Para aplicar a configuração do Terraform em um projeto do Google Cloud , conclua as etapas nas seções a seguir.
Preparar o Cloud Shell
- Inicie o Cloud Shell.
-
Defina o projeto padrão do Google Cloud em que você quer aplicar as configurações do Terraform.
Você só precisa executar esse comando uma vez por projeto, e ele pode ser executado em qualquer diretório.
export GOOGLE_CLOUD_PROJECT=PROJECT_ID
As variáveis de ambiente serão substituídas se você definir valores explícitos no arquivo de configuração do Terraform.
Preparar o diretório
Cada arquivo de configuração do Terraform precisa ter o próprio diretório, também chamado de módulo raiz.
-
No Cloud Shell, crie um diretório e um novo
arquivo dentro dele. O nome do arquivo precisa ter a extensão
.tf, por exemplo,main.tf. Neste tutorial, o arquivo é chamado demain.tf.mkdir DIRECTORY && cd DIRECTORY && touch main.tf
-
Se você estiver seguindo um tutorial, poderá copiar o exemplo de código em cada seção ou etapa.
Copie o exemplo de código no
main.tfrecém-criado.Se preferir, copie o código do GitHub. Isso é recomendado quando o snippet do Terraform faz parte de uma solução de ponta a ponta.
- Revise e modifique os parâmetros de amostra para aplicar ao seu ambiente.
- Salve as alterações.
-
Inicialize o Terraform. Você só precisa fazer isso uma vez por diretório.
terraform init
Opcionalmente, para usar a versão mais recente do provedor do Google, inclua a opção
-upgrade:terraform init -upgrade
Aplique as alterações
-
Revise a configuração e verifique se os recursos que o Terraform vai criar ou
atualizar correspondem às suas expectativas:
terraform plan
Faça as correções necessárias na configuração.
-
Para aplicar a configuração do Terraform, execute o comando a seguir e digite
yesno prompt:terraform apply
Aguarde até que o Terraform exiba a mensagem "Apply complete!".
- Abra seu projeto do Google Cloud para ver os resultados. No console do Google Cloud , navegue até seus recursos na UI para verificar se foram criados ou atualizados pelo Terraform.
REST v1
Para cancelar e excluir uma implantação azul-verde usando a API Cloud SQL Admin, envie uma
solicitação DELETE para o método blueGreenDeployments.delete:
DELETE https://sqladmin.googleapis.com/v1/ projects/PROJECT_ID/locations/REGION/ blueGreenDeployments/DEPLOYMENT_NAME
Substitua:
- PROJECT_ID: o ID do seu projeto do Google Cloud .
- REGION: a região do Google Cloud em que a implantação foi criada.
- DEPLOYMENT_NAME: o nome da implantação azul-verde.
REST v1beta4
Para cancelar e excluir uma implantação azul-verde usando a API Cloud SQL Admin, envie uma
solicitação DELETE para o método blueGreenDeployments.delete:
DELETE https://sqladmin.googleapis.com/sql/v1beta4/ projects/PROJECT_ID/locations/REGION/ blueGreenDeployments/DEPLOYMENT_NAME
Substitua:
- PROJECT_ID: o ID do seu projeto do Google Cloud .
- REGION: a região do Google Cloud em que a implantação foi criada.
- DEPLOYMENT_NAME: o nome da implantação azul-verde.
Isso remove a instância de preparo verde e restaura o ambiente para o estado original de instância única sem inatividade.
Caso 2: excluir após a troca
Após uma troca e uma janela de verificação bem-sucedidas, é possível excluir a implantação com a antiga instância azul para interromper as cobranças em duas instâncias.
Console
-
No console do Google Cloud , acesse a página Instâncias do Cloud SQL.
- Para abrir a página Visão geral de uma instância, clique no nome dela.
- No card Status da implantação azul-verde, clique em Detalhes para abrir a página Visão geral da implantação.
- Clique em Excluir implantação.
- Na caixa de diálogo Excluir implantação?, insira o ID da implantação no campo ID da implantação para confirmar.
- Escolha se quer excluir ou manter a instância azul anterior:
- Opção A (excluir a implantação e a instância azul anterior): marque a caixa de seleção Excluir a instância de origem antiga.
- Opção B (excluir apenas os metadados de implantação): deixe a caixa de seleção Excluir instância de origem antiga desmarcada para manter a instância azul anterior como uma instância independente.
- Clique em Excluir.
Se você mantiver a instância azul anterior, as duas instâncias vão permanecer ativas no
projeto e você vai continuar sendo cobrado por ambas. Para evitar gravações na
instância retida ao usá-la como backup ou para consultas históricas, defina a
flag de banco de dados read_only como on. Para mais informações,
consulte Configurar flags de banco de dados.
gcloud
Para excluir uma implantação azul-verde usando a CLI gcloud, execute o
comando gcloud
sql blue-green-deployments delete.
Opção A: excluir a implantação e a instância azul anterior
Para excluir os metadados de implantação e a antiga instância azul automaticamente, transmita a flag opcional --delete-old-source:
gcloud sql blue-green-deployments delete DEPLOYMENT_NAME \ --region=REGION \ --delete-old-source
Substitua:
- DEPLOYMENT_NAME: o nome da implantação azul-verde.
- REGION: a região do Google Cloud em que a implantação foi criada.
Quando solicitado, confirme que você quer excluir permanentemente a instância azul antiga.
Opção B: excluir apenas os metadados de implantação (manter a instância azul anterior)
Para manter a instância azul anterior em execução como uma instância independente (por exemplo, como um backup ou para consultas analíticas históricas), omita a flag opcional --delete-old-source:
gcloud sql blue-green-deployments delete DEPLOYMENT_NAME \ --region=REGION
Substitua:
- DEPLOYMENT_NAME: o nome da implantação azul-verde.
- REGION: a região do Google Cloud em que a implantação foi criada.
Esse comando exclui apenas os metadados da implantação azul-verde, deixando as duas
instâncias como independentes até que você exclua manualmente a
antiga instância azul. Para evitar gravações na instância retida ao usá-la
como backup ou para consultas históricas, defina a flag de banco de dados
read_only como on. Para mais informações, consulte
Configurar flags de banco de dados. As duas instâncias permanecem ativas no projeto, e você continua sendo cobrado por ambas.
Terraform
Para limpar uma implantação azul-verde após a alternância usando o Terraform
(quando o campo active_environment está definido como
"TARGET"), remova o bloco de código blue_green_deployment
do
recurso
google_sql_database_instance e execute o comando terraform apply. Se o Terraform
também excluirá a instância azul anterior depende do valor do
campo delete_old_source_on_destroy registrado no estado do Terraform
antes de remover o bloco de código.
Opção A: excluir a implantação e a instância azul anterior
- Se o campo
delete_old_source_on_destroyainda não estiver definido comotrueno estado do Terraform no bloco de códigoblue_green_deployment, definadelete_old_source_on_destroy = trueno bloco de códigoblue_green_deploymente execute o comandoterraform applyprimeiro para que o Terraform registre a configuração no estado. - Remova o bloco de código
blue_green_deploymentdo recursogoogle_sql_database_instance(mantendo o campodatabase_versiondefinido como a nova versão de produção) e execute o comandoterraform apply:
resource "google_sql_database_instance" "primary" { name = "SOURCE_INSTANCE_ID" region = "REGION" database_version = "TARGET_DATABASE_VERSION" settings { tier = "MACHINE_TIER" edition = "EDITION" availability_type = "REGIONAL" backup_configuration { enabled = true binary_log_enabled = true } } }
Substitua:
- SOURCE_INSTANCE_ID: o nome da instância principal.
- REGION: a região do Google Cloud em que a implantação foi criada.
- TARGET_DATABASE_VERSION: a versão do banco de dados da sua
instância de produção (por exemplo,
MYSQL_8_4). - MACHINE_TIER: o tipo de máquina da instância (por
exemplo,
db-custom-2-7680). - EDITION: a edição do Cloud SQL da sua instância
(
ENTERPRISEouENTERPRISE_PLUS).
Opção B: excluir apenas os metadados de implantação (manter a instância azul anterior)
Se o campo delete_old_source_on_destroy estiver definido como
false (o padrão) no estado do Terraform, remova o
bloco de código blue_green_deployment do
recurso google_sql_database_instance e execute o
comando terraform apply. O Terraform exclui apenas os metadados de implantação azul-verde e mantém a antiga instância azul como uma instância independente.
Se você mantiver a instância azul anterior, as duas instâncias vão permanecer ativas no
projeto e você vai continuar sendo cobrado por ambas. Para evitar gravações na
instância retida ao usá-la como backup ou para consultas históricas, defina a
flag de banco de dados read_only como on. Para mais informações,
consulte Configurar flags de banco de dados. Depois,
é possível gerenciar ou excluir a instância retida usando um dos
seguintes métodos:
- Exclua a instância manualmente executando o seguinte comando com o valor de saída
old_source_instance_name:gcloud sql instances delete OLD_SOURCE_INSTANCE_NAME
- Declare um novo bloco de código de recurso
google_sql_database_instancee importe a instância retida para o estado do Terraform:terraform import google_sql_database_instance.old_source \ projects/PROJECT_ID/instances/OLD_SOURCE_INSTANCE_NAME
Substitua:
- OLD_SOURCE_INSTANCE_NAME: o nome da antiga instância azul
retida (exportada no atributo
old_source_instance_nameantes da remoção do bloco de código). - PROJECT_ID: o ID do seu projeto do Google Cloud .
Para aplicar a configuração do Terraform em um projeto do Google Cloud , conclua as etapas nas seções a seguir.
Preparar o Cloud Shell
- Inicie o Cloud Shell.
-
Defina o projeto padrão do Google Cloud em que você quer aplicar as configurações do Terraform.
Você só precisa executar esse comando uma vez por projeto, e ele pode ser executado em qualquer diretório.
export GOOGLE_CLOUD_PROJECT=PROJECT_ID
As variáveis de ambiente serão substituídas se você definir valores explícitos no arquivo de configuração do Terraform.
Preparar o diretório
Cada arquivo de configuração do Terraform precisa ter o próprio diretório, também chamado de módulo raiz.
-
No Cloud Shell, crie um diretório e um novo
arquivo dentro dele. O nome do arquivo precisa ter a extensão
.tf, por exemplo,main.tf. Neste tutorial, o arquivo é chamado demain.tf.mkdir DIRECTORY && cd DIRECTORY && touch main.tf
-
Se você estiver seguindo um tutorial, poderá copiar o exemplo de código em cada seção ou etapa.
Copie o exemplo de código no
main.tfrecém-criado.Se preferir, copie o código do GitHub. Isso é recomendado quando o snippet do Terraform faz parte de uma solução de ponta a ponta.
- Revise e modifique os parâmetros de amostra para aplicar ao seu ambiente.
- Salve as alterações.
-
Inicialize o Terraform. Você só precisa fazer isso uma vez por diretório.
terraform init
Opcionalmente, para usar a versão mais recente do provedor do Google, inclua a opção
-upgrade:terraform init -upgrade
Aplique as alterações
-
Revise a configuração e verifique se os recursos que o Terraform vai criar ou
atualizar correspondem às suas expectativas:
terraform plan
Faça as correções necessárias na configuração.
-
Para aplicar a configuração do Terraform, execute o comando a seguir e digite
yesno prompt:terraform apply
Aguarde até que o Terraform exiba a mensagem "Apply complete!".
- Abra seu projeto do Google Cloud para ver os resultados. No console do Google Cloud , navegue até seus recursos na UI para verificar se foram criados ou atualizados pelo Terraform.
REST v1
Para excluir uma implantação azul-verde usando a API Cloud SQL Admin, envie uma solicitação DELETE
para o método blueGreenDeployments.delete.
Opção A: excluir a implantação e a instância azul anterior
Para excluir os metadados de implantação e a antiga instância azul
automaticamente, defina o parâmetro de consulta deleteOldSource como
true:
DELETE https://sqladmin.googleapis.com/v1/ projects/PROJECT_ID/locations/REGION/ blueGreenDeployments/DEPLOYMENT_NAME?deleteOldSource=true
Substitua:
- PROJECT_ID: o ID do seu projeto do Google Cloud .
- REGION: a região do Google Cloud em que a implantação foi criada.
- DEPLOYMENT_NAME: o nome da implantação azul-verde.
Opção B: excluir apenas os metadados de implantação (manter a instância azul anterior)
Para manter a instância azul anterior em execução como uma instância independente (por exemplo, como um backup ou para consultas analíticas históricas), omita o parâmetro de consulta deleteOldSource:
DELETE https://sqladmin.googleapis.com/v1/ projects/PROJECT_ID/locations/REGION/ blueGreenDeployments/DEPLOYMENT_NAME
Substitua:
- PROJECT_ID: o ID do seu projeto do Google Cloud .
- REGION: a região do Google Cloud em que a implantação foi criada.
- DEPLOYMENT_NAME: o nome da implantação azul-verde.
Essa solicitação exclui apenas os metadados da implantação azul-verde, deixando as duas
instâncias como independentes até que você exclua manualmente a
antiga instância azul. Para evitar gravações na instância retida ao usá-la
como backup ou para consultas históricas, defina a flag de banco de dados
read_only como on. Para mais informações, consulte
Configurar flags de banco de dados. As duas instâncias permanecem ativas no projeto, e você continua sendo cobrado por ambas.
REST v1beta4
Para excluir uma implantação azul-verde usando a API Cloud SQL Admin, envie uma solicitação DELETE
para o método blueGreenDeployments.delete.
Opção A: excluir a implantação e a instância azul anterior
Para excluir os metadados de implantação e a antiga instância azul
automaticamente, defina o parâmetro de consulta deleteOldSource como
true:
DELETE https://sqladmin.googleapis.com/sql/v1beta4/ projects/PROJECT_ID/locations/REGION/ blueGreenDeployments/DEPLOYMENT_NAME?deleteOldSource=true
Substitua:
- PROJECT_ID: o ID do seu projeto do Google Cloud .
- REGION: a região do Google Cloud em que a implantação foi criada.
- DEPLOYMENT_NAME: o nome da implantação azul-verde.
Opção B: excluir apenas os metadados de implantação (manter a instância azul anterior)
Para manter a instância azul anterior em execução como uma instância independente (por exemplo, como um backup ou para consultas analíticas históricas), omita o parâmetro de consulta deleteOldSource:
DELETE https://sqladmin.googleapis.com/sql/v1beta4/ projects/PROJECT_ID/locations/REGION/ blueGreenDeployments/DEPLOYMENT_NAME
Substitua:
- PROJECT_ID: o ID do seu projeto do Google Cloud .
- REGION: a região do Google Cloud em que a implantação foi criada.
- DEPLOYMENT_NAME: o nome da implantação azul-verde.
Essa solicitação exclui apenas os metadados da implantação azul-verde, deixando as duas
instâncias como independentes até que você exclua manualmente a
antiga instância azul. Para evitar gravações na instância retida ao usá-la
como backup ou para consultas históricas, defina a flag de banco de dados
read_only como on. Para mais informações, consulte
Configurar flags de banco de dados. As duas instâncias permanecem ativas no projeto, e você continua sendo cobrado por ambas.
A seguir
- Leia sobre as implantações azul-verde para entender a arquitetura de implantação e os estados do ciclo de vida.
- Conheça os upgrades de versão principal no local.
- Saiba como configurar a alta disponibilidade.