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

Antes de começar

Para excluir ou cancelar uma implantação azul-verde, verifique se você tem as funções e permissões necessárias.

Papéis e permissões necessárias

Para ter 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 papéis personalizados, 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.

Entender os comportamentos de exclusão

A operação delete se comporta de maneira diferente dependendo de se ocorreu uma troca:

Estágio de implantação Comportamento padrão Impacto na instância
Antes da troca
(Cancelar)		 Exclui os metadados da implantação e a instância de pré-produção verde automaticamente. Sua instância de produção azul continua em execução e totalmente inalterada.
Após a substituição
(Excluir)		 Exclui os metadados da implantação, mas mantém as duas instâncias como instâncias autônomas 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 será mantida como uma instância independente de leitura e gravação, a menos que você selecione a opção Excluir instância de origem antiga, transmita a flag opcional --delete-old-source ou defina o parâmetro deleteOldSource como true para excluí-la.

Caso 1: cancelar uma implantação antes da troca

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 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 gcloud, execute o comando blue-green-deployments delete:

gcloud beta 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.

REST v1

Para cancelar e excluir uma implantação azul-verde usando a API Cloud SQL Admin, envie uma solicitação DELETE ao 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 ao 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 pré-produção verde e restaura o ambiente ao 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 junto com a antiga instância azul para evitar cobranças em duas instâncias.

Console

  1. No console 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 da implantação): deixe a caixa de seleção Excluir a instância de origem antiga desmarcada para manter a instância azul anterior como uma instância independente.
  7. Clique em Excluir.

gcloud

Para excluir uma implantação azul-verde usando gcloud, execute o comando blue-green-deployments delete.

Opção A: excluir a implantação e a instância azul anterior

Para excluir os metadados da implantação e excluir automaticamente a instância azul anterior, transmita a flag opcional --delete-old-source:

gcloud beta 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 anterior.

Opção B: excluir apenas os metadados de implantação (manter a instância azul anterior)

Se você quiser manter a instância azul anterior em execução como uma instância independente (por exemplo, como backup ou para consultas analíticas históricas), omita a flag opcional --delete-old-source:

gcloud beta 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 instância azul anterior. As duas instâncias permanecem ativas no projeto, e você continua recebendo cobranças pelas duas.

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 da implantação e excluir automaticamente a instância azul anterior, 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)

Se você quiser 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 instância azul anterior. As duas instâncias permanecem ativas no projeto, e você continua recebendo cobranças pelas duas.

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 da implantação e excluir automaticamente a instância azul anterior, 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)

Se você quiser 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 instância azul anterior. As duas instâncias permanecem ativas no projeto, e você continua recebendo cobranças pelas duas.

A seguir