Excluir uma implantação azul-verde

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.delete
  • cloudsql.blueGreenDeployments.get
  • cloudsql.instances.delete
  • cloudsql.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

  1. No console do Google Cloud , acesse a página Instâncias do Cloud SQL.

    Acesse "Instâncias do Cloud SQL"

  2. Para abrir a página Visão geral de uma instância, clique no nome dela.
  3. No card Status da implantação azul-verde, clique em Detalhes para abrir a página Visão geral da implantação.
  4. Clique em Excluir implantação.
  5. Na caixa de diálogo Excluir implantação?, insira o ID da implantação no campo ID da implantação para confirmar.
  6. 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 (ENTERPRISE ou ENTERPRISE_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

  1. Inicie o Cloud Shell.
  2. 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.

  1. 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 de main.tf.
    mkdir DIRECTORY && cd DIRECTORY && touch main.tf
  2. 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.tf recé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.

  3. Revise e modifique os parâmetros de amostra para aplicar ao seu ambiente.
  4. Salve as alterações.
  5. 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

  1. 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.

  2. Para aplicar a configuração do Terraform, execute o comando a seguir e digite yes no prompt:
    terraform apply

    Aguarde até que o Terraform exiba a mensagem "Apply complete!".

  3. 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

  1. No console do Google Cloud , acesse a página Instâncias do Cloud SQL.

    Acesse "Instâncias do Cloud SQL"

  2. Para abrir a página Visão geral de uma instância, clique no nome dela.
  3. No card Status da implantação azul-verde, clique em Detalhes para abrir a página Visão geral da implantação.
  4. Clique em Excluir implantação.
  5. Na caixa de diálogo Excluir implantação?, insira o ID da implantação no campo ID da implantação para confirmar.
  6. 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.
  7. 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

  1. Se o campo delete_old_source_on_destroy ainda não estiver definido como true no estado do Terraform no bloco de código blue_green_deployment, defina delete_old_source_on_destroy = true no bloco de código blue_green_deployment e execute o comando terraform apply primeiro para que o Terraform registre a configuração no estado.
  2. Remova o bloco de código blue_green_deployment do recurso google_sql_database_instance (mantendo o campo database_version definido como a nova versão de produção) e execute o comando terraform 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 (ENTERPRISE ou ENTERPRISE_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_instance e 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_name antes 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

  1. Inicie o Cloud Shell.
  2. 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.

  1. 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 de main.tf.
    mkdir DIRECTORY && cd DIRECTORY && touch main.tf
  2. 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.tf recé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.

  3. Revise e modifique os parâmetros de amostra para aplicar ao seu ambiente.
  4. Salve as alterações.
  5. 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

  1. 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.

  2. Para aplicar a configuração do Terraform, execute o comando a seguir e digite yes no prompt:
    terraform apply

    Aguarde até que o Terraform exiba a mensagem "Apply complete!".

  3. 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