Configuração legada para alta disponibilidade

MySQL   |  PostgreSQL   |  SQL Server

Nesta página, descrevemos a configuração legada de uma instância do MySQL para alta disponibilidade.

Em uma configuração de alta disponibilidade legada, uma instância do Cloud SQL para MySQL usa uma réplica de failover para adicionar alta disponibilidade à instância. Esse recurso não está disponível no console do Google Cloud. A nova recomendação não usa réplicas de failover. Em vez disso, ela usa discos permanentes regionais do Google, que replicam dados de maneira síncrona no nível do bloco entre duas zonas em uma região.

Para mais informações sobre a configuração atual de alta disponibilidade, consulte Visão geral da configuração de alta disponibilidade.

Importante: o Cloud SQL vai descontinuar o suporte à configuração de instâncias legada de alta disponibilidade (HA) em 6 de janeiro de 2025. Após essa data, não será possível criar instâncias com a configuração legada para alta disponibilidade. Também não é possível ativar a configuração legada para alta disponibilidade em instâncias atuais. Até 6 de janeiro de 2025, as instâncias de alta disponibilidade legadas ainda são cobertas pelo SLA do Cloud SQL. Recomendamos que você faça upgrade das instâncias de alta disponibilidade legadas para instâncias de alta disponibilidade de disco permanente regional o mais rápido possível e crie novas instâncias de alta disponibilidade usando discos permanentes regionais.

A partir de 1º de maio de 2025, o Cloud SQL vai migrar automaticamente todas as instâncias restantes que usam a configuração legada de alta disponibilidade para a configuração atual.

Atualizar uma instância de alta disponibilidade legada para atual

Para atualizar a instância da legada para a nova configuração de alta disponibilidade, faça o seguinte:

1. Exclua a réplica de failover nas instâncias do MySQL que você quer atualizar. Para mais informações, consulte Desativar a alta disponibilidade em uma instância.
2. Configure a instância para usar a versão atual da alta disponibilidade. Para mais informações, consulte Configurar uma instância existente para alta disponibilidade.

Configuração legada: criar uma nova instância configurada para alta disponibilidade

Quando você cria uma instância, é possível configurá-la para ter alta disponibilidade. O Cloud SQL cria a réplica de failover ao mesmo tempo que cria a instância principal. O recurso legado não está disponível no console do Google Cloud. Em vez disso, use os comandos gcloud CLI ou cURL.

Observação: para informações sobre como usar a replicação paralela para melhorar o desempenho, consulte Como configurar a replicação paralela.

Para criar uma instância configurada para alta disponibilidade:

gcloud

1. Crie a instância principal e a réplica de failover:

   gcloud sql instances create PRIMARY_INSTANCE_NAME \
   --backup-start-time=BACKUP_WINDOW_START_TIME \
   --failover-replica-name=FAILOVER_REPLICA_NAME \
   --cpu=CPU \
   --database-version=DATABASE_VERSION \
   --memory=MEMORY \
   --enable-bin-log

   O horário de início da janela de backup está no formato HH:MM.

   Lembre-se de substituir o marcador DATABASE_VERSION pelo MySQL 5.6 ou MySQL 5.7 (--database-version=MYSQL_5_6 ou
   --database-version=MYSQL_5_7).

   Se você não especificar uma versão para o parâmetro database-version, o MySQL 8.0 será selecionado por padrão. A configuração legada para alta disponibilidade do MySQL não é compatível com a versão 8.0.

   Para uma lista completa de parâmetros disponíveis, consulte a página de referência gcloud sql instances create.

2. Configure o usuário raiz na instância principal:

   gcloud sql users set-password root --host=% \
   --instance PRIMARY_INSTANCE_NAME \
   --password PASSWORD

   A réplica de failover é criada com a mesma quantidade de CPU e MEMORY que a instância primária. É possível alterar a CPU e a MEMORY da réplica de failover posteriormente, mas elas precisam ser pelo menos tão grande quanto as da instância principal.

curl

1. Crie a instância principal e a réplica de failover:

   gcloud auth login
   ACCESS_TOKEN="$(gcloud auth print-access-token)"
   curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
        --header 'Content-Type: application/json' \
        --data '{"name":"PRIMARY_INSTANCE_NAME", "region":"REGION",
                 "settings": {
                              "tier":"MACHINE_TYPE",
                              "backupConfiguration": {"binaryLogEnabled": true, "enabled": true}},
                              "failoverReplica": {"name": "FAILOVER_REPLICA_NAME"}}' \
        -X POST \
        https://www.googleapis.com/sql/v1beta4/projects/PROJECT-ID/instances

   Para ver a lista completa de parâmetros dessa solicitação, consulte a página instances:insert.
2. Quando a inicialização da instância principal for concluída, atualize a senha raiz nela:

   gcloud auth login
   ACCESS_TOKEN="$(gcloud auth print-access-token)"
   curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
        --header 'Content-Type: application/json' \
        --data '{"name": "root", "host": "%", "password": "ROOT_PASSWORD"}' \
        'https://www.googleapis.com/sql/v1beta4/projects/PROJECT-ID/instances/INSTANCE_NAME/users?host=%25&name=root'

   Essa alteração é propagada automaticamente para a réplica.

Configuração legada: configurar uma instância para alta disponibilidade

Quando uma instância existente é configurada para alta disponibilidade, ela fica inativa por alguns minutos durante a reconfiguração.

Para configurar uma instância existente para alta disponibilidade:

gcloud

1. Verificar o status da instância principal:

   gcloud sql instances describe PRIMARY_INSTANCE_NAME

   Se a propriedade databaseReplicationEnabled for true, a instância é uma réplica. Não é possível criar uma réplica de failover para outra.

2. Se a propriedade enabled em backupConfiguration for false, ative os backups para a instância principal:

   gcloud sql instances patch PRIMARY_INSTANCE_NAME \
   --backup-start-time HH:MM

   O parâmetro backup-start-time é especificado em 24 horas, no fuso horário UTC±00, e especifica o início de uma janela de backup de 4 horas. Os backups podem começar a qualquer momento durante a janela de backup.

3. Se a propriedade binaryLogEnabled for false, ative os registros binários:

   gcloud sql instances patch PRIMARY_INSTANCE_NAME \
   --enable-bin-log

   A ativação de registros binários causa a reinicialização da instância.

4. Crie a réplica:

   gcloud sql instances create FAILOVER_REPLICA_NAME \
   --master-instance-name=PRIMARY_INSTANCE_NAME \
   --replica-type=FAILOVER

curl

1. Verificar o status da instância principal:

   gcloud auth login
   ACCESS_TOKEN="$(gcloud auth print-access-token)"
   curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
        -X GET \
        https://www.googleapis.com/sql/v1beta4/projects/PROJECT-ID/instances/PRIMARY_INSTANCE_NAME?fields=settings

   A saída conterá backupConfiguration, por exemplo:

   "backupConfiguration": {
       "kind": "sql#backupConfiguration",
       "startTime": "12:00",
       "enabled": true,
       "binaryLogEnabled": true
   }
   

2. Se enabled ou binaryLogEnabled forem false, use o método patch do recurso de instâncias para ativar os dois. Especifique as propriedades da configuração de backup que você quer manter como está e as que quer alterar.

   Para ativar backups, defina enabled como true e startTime como um valor que seja o início da janela de backup. Para ativar a geração de registros binários, defina binaryLogEnabled como true.

   gcloud auth login
   ACCESS_TOKEN="$(gcloud auth print-access-token)"
   curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
        --header 'Content-Type: application/json' \
        --data '{"settings" : {"backupConfiguration" : {"startTime": "HH:MM", "enabled": true, "binaryLogEnabled": true}}}' \
        -X PATCH \
        https://www.googleapis.com/sql/v1beta4/projects/PROJECT-ID/instances/PRIMARY_INSTANCE_NAME/

3. Use o método insert do recurso de instâncias para criar a réplica de failover.

   gcloud auth login
   ACCESS_TOKEN="$(gcloud auth print-access-token)"
   curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
        --header 'Content-Type: application/json' \
        --data '{"name": "REPLICA_NAME", "masterInstanceName": "PRIMARY_INSTANCE_NAME",
                 "region": "PRIMARY_IMSTANCE_REGION", "databaseVersion": "PRIMARY_DATABASE_VERSION",
                 "replicaConfiguration": {"failoverTarget": true},
                 "settings": {"tier":"MACHINE_TYPE"}}' \
        -X POST \
        https://www.googleapis.com/sql/v1beta4/projects/PROJECT-ID/instances

   MACHINE_TYPE precisa ser pelo menos tão grande quanto o tipo de máquina da instância principal.

Iniciar o failover

O teste de failover é opcional, mas é recomendado. Portanto, você pode ver como seu aplicativo responde em caso de um failover.

Observação:com esse recurso, é possível testar a resposta do seu aplicativo a um failover automático. Certifique-se de que sua instância tenha concluído qualquer failover anterior e, portanto, esteja respondendo a solicitações de conexão, antes de acionar outro failover.

Para saber mais sobre failover, consulte a Visão geral do failover.

gcloud

Inicie o failover:

gcloud sql instances failover PRIMARY_INSTANCE_NAME

curl

1. Descreva a instância principal para conseguir o valor do campo settingsVersion.

   gcloud auth login
   ACCESS_TOKEN="$(gcloud auth print-access-token)"
   curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
        -X GET \
        https://www.googleapis.com/sql/v1beta4/projects/PROJECT-ID/instances/PRIMARY_INSTANCE_NAME

2. Inicie o failover:

   gcloud auth login
   ACCESS_TOKEN="$(gcloud auth print-access-token)"
   curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
        --header 'Content-Type: application/json' \
        --data '{"failoverContext":{"settingsVersion":"SETTINGS_VERSION"}}' \
        -X POST \
        https://www.googleapis.com/sql/v1beta4/projects/PROJECT-ID/instances/PRIMARY_INSTANCE_NAME/failover

A instância realizou failover e não está disponível para exibir dados por alguns minutos.

Configuração legada: criar um alerta para atraso de replicação

O tempo necessário para uma operação de failover depende da quantidade de atraso da replicação quando o failover é iniciado. Use o Cloud Monitoring no console do Google Cloud para enviar alertas quando o atraso da replicação ultrapassar um limite.

Observação: a inatividade de failover causada pelo atraso de replicação superior a 1.200 segundos não é contabilizada pelo SLA da instância.

Para mais informações sobre atraso de replicação, pesquise por "seconds_behind_master" na página Sintaxe SHOW SLAVE STATUS na documentação do MySQL.

Para mais informações sobre o Cloud Monitoring, consulte a documentação do Cloud Monitoring.

Observação: uma instância recém-criada do Cloud SQL pode levar algum tempo para aparecer na interface do Cloud Monitoring. Se uma nova instância não aparecer, verifique novamente em uma hora.

Configuração legada: configurar um alerta para uma réplica de failover específica

1. No painel de navegação do console do Google Cloud, selecione Monitoramento e Alertas.
2. Clique em Create Alerting Policy.
3. Digite um nome descritivo para o alerta.
4. Selecione Limite de métrica e clique em Avançar para abrir a guia "Destino".
5. Para Tipo de recurso, selecione Cloud SQL.
6. Para Aplicável a, selecione Único. Depois, selecione a réplica de failover.
7. Clique em Avançar para abrir a guia "Configuração".

8. Digite os seguintes valores:

   Campo	Valor
   Métrica Se	Segundos atrás do mestre
   Condição	acima
   Limites	120 (ou qualquer valor que seja apropriado para seu ambiente)
   Para	3 minutos

9. Selecione os métodos de Notificação e clique em Salvar condição.

Configuração legada: definir um alerta para um grupo de réplicas de failover

Se você planeja criar várias réplicas de failover no mesmo projeto, pode ser mais fácil definir o alerta para todo o grupo, e não em cada réplica de failover individualmente. Para criar um grupo para monitoramento, use um sufixo para os nomes das réplicas de failover, como "-failover". Não use esse sufixo para nenhum outro tipo de instâncias do Cloud SQL.

Crie o grupo de réplicas de failover:

1. No console do Google Cloud, acesse a página Monitoring.

   Acessar Monitoring

2. Na barra de menus superior, selecione Grupos > Criar....
3. Digite um nome descritivo para o grupo.
4. Deixe Nome e Contém selecionados e digite a substring de nome.
5. Clique em Salvar grupo. A página de resumo do novo grupo é aberta.
6. Confirme se as instâncias esperadas estão incluídas no grupo.

Observação: se você abrir a página Visão geral dos grupos, em que todos os grupos existentes estão listados, seu grupo mostrará zero instâncias. Isso ocorre porque o Cloud Monitoring usa o termo "instâncias" para VMs e clusters de VM. As instâncias do Cloud SQL são mostradas em Recursos.

Crie o alerta para o grupo de réplicas de failover:

1. No painel de navegação do console do Google Cloud, selecione Monitoramento e Alertas.
2. Clique em Create Alerting Policy.
3. Digite um nome descritivo para o alerta de grupo.
4. Selecione Limite de métrica e clique em Avançar para abrir a guia "Destino".
5. Para Tipo de recurso, selecione Cloud SQL.
6. Para Aplicável a, selecione Grupo. Depois, selecione seu grupo de failover.
7. Deixe Qualquer membro viola selecionado e clique em Avançar para abrir a guia "Configuração".

8. Digite os seguintes valores:

   Campo	Valor
   Métrica Se	Segundos atrás do mestre
   Condição	acima
   Limites	120 (ou qualquer valor que seja apropriado para seu ambiente)
   Para	3 minutos

9. Selecione os métodos desejados de Notificação e clique em Salvar condição.

Configuração legada: desativar a alta disponibilidade em uma instância

É preciso excluir a instância de réplica de failover para remover a alta disponibilidade da instância principal.

Antes de fazer esse procedimento, verifique se não há operações em execução no momento na instância principal.

Para desativar a alta disponibilidade:

Console

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

   Acesse "Instâncias do Cloud SQL"

2. Selecione a instância de failover associada à instância em que você quer desativar a alta disponibilidade.
3. Na página Detalhes da instância, clique em Excluir.
4. Na janela Excluir réplica, digite novamente o nome da instância de failover.
5. Clique em Excluir. A configuração da instância original será alterada para zonal.

gcloud

Para informações de referência, consulte gcloud sql instances delete.

gcloud sql instances delete FAILOVER_REPLICA_NAME

curl

A solicitação abaixo usa o método instances:delete para excluir a instância.

gcloud auth login
ACCESS_TOKEN="$(gcloud auth print-access-token)"
curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
     --header 'Content-Type: application/json'\
      -X DELETE\
https://www.googleapis.com/sql/v1beta4/projects/PROJECT-ID/instances/INSTANCE_NAME

A seguir

• Saiba mais sobre como funciona a configuração de alta disponibilidade.
• Teste a resposta do aplicativo a conexões perdidas reiniciando a instância.
• Saiba mais sobre como gerenciar as conexões de banco de dados.
• Saiba mais sobre o Cloud Monitoring.
• Crie réplicas de leitura para sua instância.