Descrever e listar implantações azul-verde

Este documento descreve como listar e descrever implantações azul-verde do Cloud SQL, inspecionar detalhes de conexão e diferenças de configuração e se conectar ao ambiente de pré-produção verde para testar e validar suas cargas de trabalho.

Antes de começar

Para listar ou descrever uma implantação azul-verde e se conectar à instância de preparação verde, verifique se você tem os papéis e as credenciais de banco de dados necessários.

Papéis e permissões necessárias

Para ter as permissões necessárias para listar e descrever implantações azul-verde, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:

  • Leitor do Cloud SQL (roles/cloudsql.viewer)
  • Editor do Cloud SQL (roles/cloudsql.editor)
  • Administrador do Cloud SQL (roles/cloudsql.admin)

Para papéis personalizados, verifique se você tem as seguintes permissões:

  • cloudsql.blueGreenDeployments.get
  • cloudsql.blueGreenDeployments.list

Para se conectar à instância de staging verde e executar consultas de teste, você também precisa de credenciais de usuário do banco de dados configuradas na instância de origem.

Para mais informações sobre os papéis e as permissões do IAM no Cloud SQL, consulte Papéis e permissões.

Visão geral

O comando "describe" permite monitorar e acompanhar o status de uma implantação azul-verde do Cloud SQL a qualquer momento durante o ciclo de vida, desde o provisionamento e o preparo iniciais até a conclusão da troca.

A descrição de uma implantação azul-verde oferece visibilidade sobre:

  • Estado do ciclo de vida da implantação:monitore o status em tempo real da sua implantação à medida que ela passa por estados como PROVISIONING, SWITCHOVER_READY, SWITCHOVER_NOT_READY, SWITCHOVER_IN_PROGRESS e SWITCHOVER_COMPLETED.
  • Detalhes da conexão da instância de destino:recupere o nome exclusivo da conexão e os endpoints de rede da instância de staging verde. Isso permite que administradores de banco de dados (DBAs) e engenheiros de controle de qualidade conectem aplicativos, executem consultas de teste e validem o desempenho na instância verde sem afetar o tráfego de produção azul ativo.
  • Integridade da replicação e prontidão para failover:verifique se a replicação lógica contínua do azul para o verde está íntegra e inspecione os detalhes de erros de diagnóstico se surgirem problemas. Descrever uma implantação não mostra o atraso de replicação.
  • Diferenças de configuração:quando solicitado com a visualização detalhada, inspecione uma comparação lado a lado (diffs) de versões do banco de dados, níveis de máquina, configurações de armazenamento e configurações de alta disponibilidade entre as instâncias azul e verde.

Listar implantações azul-verde

Para listar implantações azul-verde em um projeto:

Console

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

    Acesse "Instâncias do Cloud SQL"

  2. Na lista de instâncias, confira a coluna ID da implantação azul-verde para ver as implantações azul-verde associadas às suas instâncias. As instâncias que fazem parte de uma implantação azul-verde também mostram uma tag de função (Azul, Verde, Azul-antigo ou Azul-novo) ao lado do nome da instância.

gcloud

Para listar implantações azul-verde usando gcloud, execute o comando blue-green-deployments list:

gcloud beta sql blue-green-deployments list \
  --region=REGION

Para listar implantações em todas as regiões do projeto, omita a flag --region.

REST v1

Para listar implantações usando a API Cloud SQL Admin, envie uma solicitação GET ao método blueGreenDeployments.list:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/
  locations/REGION/blueGreenDeployments

REST v1beta4

Para listar implantações usando a API Cloud SQL Admin, envie uma solicitação GET ao método blueGreenDeployments.list:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/
  locations/REGION/blueGreenDeployments

Descrever a implantação azul-verde

Para inspecionar o status da implantação e obter os detalhes da conexão da instância verde, descreva a implantação:

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 da implantação, faça o seguinte:
    • Na coluna ID da implantação azul-verde, clique no ID da implantação.
    • Clique no nome da instância para abrir a página Visão geral e, no card Status da implantação azul-verde, clique em Detalhes.
  3. Na página Visão geral da implantação, revise o card Detalhes da implantação para inspecionar o Status, a Instância de origem, a Instância de destino, o Endpoint da instância de destino e a Versão de destino. Além disso, revise o card Progresso da implantação para inspecionar os status das tarefas.

gcloud

Para descrever uma implantação usando gcloud, execute o comando blue-green-deployments describe:

gcloud beta sql blue-green-deployments describe 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 descrever uma implantação usando a API Cloud SQL Admin, envie uma solicitação GET ao método blueGreenDeployments.get:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/
  locations/REGION/
  blueGreenDeployments/DEPLOYMENT_NAME

REST v1beta4

Para descrever uma implantação usando a API Cloud SQL Admin, envie uma solicitação GET ao método blueGreenDeployments.get:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/
  locations/REGION/
  blueGreenDeployments/DEPLOYMENT_NAME

Inspecionar o status e os detalhes da conexão

Na resposta ao comando, verifique o estado da implantação e localize as informações de conexão da instância verde de destino:

name: projects/my-project/locations/us-central1/
  blueGreenDeployments/my-deployment
createTime: '2026-08-13T10:00:00.000Z'
state: SWITCHOVER_READY
sourceInstance: my-source-instance
switchoverTargetInstance: my-target-instance
requestedConfig:
  databaseVersion: MYSQL_8_4
deploymentMappings:
- source:
    connection: my-project:us-central1:my-source-instance
    dns: my-source-instance.123456789012.us-central1.sql.goog.
    instance: projects/my-project/instances/my-source-instance
    ipAddresses:
    - ipAddress: 10.0.0.1
      type: PRIMARY
  state: PROVISIONED
  target:
    connection: my-project:us-central1:my-target-instance
    dns: my-target-instance.123456789012.us-central1.sql.goog.
    instance: projects/my-project/instances/my-target-instance
    ipAddresses:
    - ipAddress: 10.0.0.2
      type: PRIMARY
  tasks:
  - type: PROVISION
    state: SUCCEEDED
    startTime: '2026-08-13T10:00:00.000Z'
    endTime: '2026-08-13T10:15:00.000Z'
deploymentTasks:
- type: PROVISION
  state: SUCCEEDED
  startTime: '2026-08-13T10:00:00.000Z'
  endTime: '2026-08-13T10:15:00.000Z'

Revise os seguintes campos na resposta:

  • name:o caminho totalmente qualificado do recurso da implantação no formato projects/PROJECT_ID/locations/REGION/blueGreenDeployments/DEPLOYMENT_NAME.
  • createTime:o carimbo de data/hora em que a implantação foi criada.
  • state:o status geral do ciclo de vida da implantação:
    • PROVISIONING: a implantação está provisionando o ambiente verde e configurando a replicação.
    • SWITCHOVER_READY: o preparo foi concluído, a replicação lógica está funcionando bem e a implantação está pronta para alternância. Confirme esse estado antes de executar os testes.
    • SWITCHOVER_NOT_READY: a implantação não está pronta para a troca. Confira errorDetail para resolver problemas.
    • SWITCHOVER_IN_PROGRESS: uma operação de alternância está sendo executada.
    • SWITCHOVER_COMPLETED: a troca foi concluída, e a instância verde agora está atendendo ao tráfego de produção como a instância ativa de leitura e gravação.
    • DELETING: o recurso de implantação está sendo excluído.
  • sourceInstance:o identificador da instância de produção azul original.
  • switchoverTargetInstance:o identificador da instância de pré-produção verde que se torna a instância de leitura e gravação de produção durante o failover.
  • requestedConfig:a configuração destinada à instância de destino no momento da criação, como databaseVersion para upgrades de versão principal.
  • errorDetail:detalhes do erro de diagnóstico explicando por que a troca não está pronta ou por que uma tarefa de provisionamento ou troca falhou.
  • deploymentMappings:a lista de pares de instâncias de origem e de destino na implantação. Para cada par, revise:
    • source:detalhes de conexão e rede para a instância azul, incluindo o caminho do recurso da instância (instance), o nome da conexão (connection), o nome do host DNS (dns) e os endereços IP (ipAddresses).
    • Detalhes de conexão e rede target: para a instância verde. Use o nome connection ou ipAddresses de destino para conectar aplicativos de pré-produção e conjuntos de testes ao ambiente verde.
    • diffs:diferenças na configuração entre as instâncias azul e verde ao usar a visualização detalhada. Durante o pré-lançamento, as mudanças de flags de banco de dados não são mostradas.
    • state:o status de funcionamento do nó pareado (como PROVISIONING, PROVISIONED, UPGRADING, UPGRADED, UPGRADE_FAILED, SWITCHOVER_IN_PROGRESS, SWITCHOVER_FAILED, SWITCHOVER_SUCCEEDED ou DELETING).
    • tasks:o status de execução, o horário de início e de término e os detalhes do erro das tarefas de implantação realizadas nesse nó.
  • deploymentTasks:uma lista consolidada de todas as tarefas de implantação em todos os nós, incluindo a tarefa type (PROVISION, UPGRADE, SWITCHOVER, DELETE ou POST_SWITCHOVER_OPERATIONS), state (PENDING, RUNNING, SUCCEEDED ou FAILED), startTime, endTime e errorMessage.

Conferir as diferenças de configuração

Por padrão, a descrição de uma implantação retorna a visualização básica com metadados principais. Para analisar as diferenças de configuração entre as instâncias azul e verde, confira as diferenças de configuração no console Google Cloud ou solicite a visualização detalhada usando a CLI gcloud ou a API Cloud SQL Admin:

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. No card Detalhes da implantação, clique em Ver diferenças de configuração.
  5. Na caixa de diálogo Diferenças nas configurações da instância, analise a comparação entre as instâncias Origem e Destino e clique em Fechar.

gcloud

Execute o comando blue-green-deployments describe com a sinalização --show-config-diff.

gcloud beta sql blue-green-deployments describe DEPLOYMENT_NAME \
  --region=REGION \
  --show-config-diff

REST v1

Envie uma solicitação GET para o método blueGreenDeployments.get com o parâmetro de consulta view=DETAILED:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/
  locations/REGION/
  blueGreenDeployments/DEPLOYMENT_NAME?view=DETAILED

REST v1beta4

Envie uma solicitação GET para o método blueGreenDeployments.get com o parâmetro de consulta view=DETAILED:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/
  locations/REGION/
  blueGreenDeployments/DEPLOYMENT_NAME?view=DETAILED

Analisar as diferenças de configuração

Quando você especifica a visualização detalhada, a resposta inclui uma seção diffs em cada nó pareado em deploymentMappings:

deploymentMappings:
- diffs:
  - field: database_version
    sourceValue: MYSQL_8_0
    targetValue: MYSQL_8_4
  - field: settings/tier
    sourceValue: db-custom-2-7680
    targetValue: db-custom-4-15360
  source:
    instance: projects/PROJECT_ID/instances/my-source-instance
  target:
    connection: PROJECT_ID:REGION:my-target-instance
    instance: projects/PROJECT_ID/instances/my-target-instance

A seção diffs destaca as diferenças entre as instâncias de origem e de destino para atributos como:

  • database_version:a versão do mecanismo de banco de dados nas instâncias azul e verde.
  • settings/tier:tipo de máquina (vCPU e memória) alocado para a instância.
  • edition:a edição do Cloud SQL (Enterprise ou Enterprise Plus).
  • availability_type:configuração de alta disponibilidade (HA) (ZONAL ou REGIONAL).
  • settings/data_disk_size_gb:capacidade de armazenamento em gigabytes.
  • settings/data_disk_type:tipo de armazenamento (PD_SSD).

Confirme se todas as mudanças listadas correspondem às especificações de implantação planejadas antes de iniciar o teste funcional da carga de trabalho.

Conectar e validar cargas de trabalho de aplicativos

Conecte seu aplicativo ou ferramentas de cliente à instância verde usando a string de conexão exclusiva dela:

gcloud sql connect TARGET_INSTANCE_NAME --user=DB_USER

Substitua:

  • TARGET_INSTANCE_NAME: o nome da instância verde de destino.
  • DB_USER: o nome de usuário do banco de dados.

Siga estas etapas de validação:

  • Execute testes de integração:verifique se as consultas de aplicativos e os procedimentos armazenados são executados sem erros na instância verde.
  • Inspecione os registros de erros:verifique os registros de erros do banco de dados do Cloud Logging e do Cloud SQL em busca de avisos de sintaxe descontinuada ou erros inesperados do mecanismo.
  • Analise as estatísticas de desempenho:monitore as métricas de CPU, memória e E/S na instância verde para garantir que o desempenho atenda aos SLOs operacionais.

A seguir