Como soluciono problemas de upgrade no Aurora compatível com MySQL?

Breve descrição

Se você usar uma implantação azul/verde para fazer upgrade em um banco de dados do Aurora compatível com MySQL, sua implantação poderá mostrar “Invalid configuration” como o estado do upgrade. Para obter mais informações sobre o problema, procure a seguinte mensagem em Logs e eventos da instância do gravador:

"Failed to provision due to upgrade incompatibilities."

Para solucionar esse erro, conclua as seguintes etapas de solução de problemas:

Resolução

Prepare-se para a implantação azul/verde

Para reduzir os problemas com sua implantação azul/verde, conclua as seguintes práticas recomendadas para se preparar para a implantação:

• Analise a matriz de compatibilidade de versões do Aurora MySQL para garantir que seja possível fazer o upgrade da sua versão atual para a versão de destino com implantação azul/verde. Para obter mais informações, consulte Conferir os números de versão do Aurora MySQL.
• Avalie a capacidade da sua aplicação de lidar com breves interrupções durante a modificação. Também é possível implementar a lógica de nova tentativa de conexão no código da sua aplicação para auxiliar no processo de modificação. Para obter mais informações, consulte Práticas recomendadas gerais para implantações azul/verde.
• Revise todas as configurações para garantir que sua versão atual seja compatível com a versão de destino.
• Crie um backup do seu banco de dados atual para garantir que seja possível reverter, se necessário.

Execute a implantação azul/verde

Durante sua implantação, conclua as seguintes tarefas:

• Use Amazon CloudWatch Metrics, Amazon EventBridge e Logs para monitorar o progresso de upgrade.
• Se você fizer upgrade para uma versão secundária mais recente dentro da mesma versão principal, use o atributo de upgrade local no cluster verde. Esse atributo permite que você acesse a versão mais recente do patch antes de concluir o processo de modificação.
• Depois de validar se o ambiente verde está pronto e se o cluster verde não tem atraso na réplica, conclua a modificação durante uma janela de manutenção planejada.

Se a transição parar ou diminuir a velocidade durante a modificação, verifique os logs de erros em busca de mensagens de erro ou gargalos específicos. É possível especificar um tempo limite de transição entre 30 segundos e 3.600 segundos (1 hora). Se a transição demorar mais do que a duração especificada, o Aurora reverterá as alterações e não mudará nenhum dos ambientes.

Observação: o tempo limite padrão é de 300 segundos (5 minutos).

Use abordagens alternativas de upgrade

Para alguns upgrades, como do Aurora Sem Servidor v1 para o Aurora Sem Servidor v2, não é possível usar o processo de implantação azul/verde. Para solucionar esse problema, use um dos seguintes métodos:

Use réplicas de leitura

Realize as seguintes ações:

1. Crie uma réplica de leitura do seu cluster do Aurora Sem Servidor v1.
2. Faça upgrade da réplica de leitura do cluster para o Aurora Sem Servidor v2.
3. Atualize a réplica de leitura para ser o cluster primário.

Para obter mais informações, consulte Atualizar a partir de um cluster do Aurora Sem Servidor v1 para o Aurora Sem Servidor v2.

Use restauração de snapshot

Realize as seguintes ações:

1. Crie um snapshot do seu cluster do Aurora Sem Servidor v1.
2. Restaure o snapshot em um novo cluster do Aurora Sem Servidor v2.
3. Atualize sua aplicação para apontar para o novo cluster v2.

Revise as configurações após o upgrade

Depois de concluir o upgrade do cluster, verifique se todas as funções do banco de dados, procedimentos armazenados e consultas de aplicações funcionam conforme o esperado. Monitore as métricas de desempenho por 24 a 48 horas após o upgrade, incluindo horários de pico, para garantir que não haja efeitos inesperados no desempenho.

Outras etapas de solução de problemas

Erro de incompatibilidade

Se a configuração atual do seu banco de dados usa configurações ou atributos que não são compatíveis com o banco de dados de destino, você receberá a seguinte mensagem de erro:

"Failed to provision due to upgrade incompatibilities. See https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraMySQL.mysql80-upgrade-procedure.html#AuroraMySQL.mysql80-upgrade-troubleshooting to resolve these issues, then delete and recreate this Blue/Green Deployment."

Para solucionar esse erro, realize as etapas a seguir:

1. Examine o arquivo upgrade-prechecks.log em seu banco de dados do Aurora compatível com MySQL.
2. Resolva quaisquer problemas de compatibilidade que você identifique no arquivo de log. Para obter mais informações, consulte Resumo das pré-verificações de atualização do MySQL Community e Resumo das pré-verificações de atualização do Aurora MySQL.
3. Exclua a implantação azul/verde.
4. Recrie a implantação azul/verde.

Erro de compatibilidade de parâmetro

Se seu cluster verde estiver em um status incompatible-parameters e não estiver Disponível, os parâmetros existentes do cluster ou os valores dos parâmetros da instância não serão compatíveis com a versão de destino.

Para solucionar esse erro, realize as etapas a seguir:

1. Redefina os grupos de parâmetros do cluster e os valores dos parâmetros da instância.

2. Para promover o cluster verde a um cluster independente, execute o comando promote-read-replica-db-cluster:

   aws rds promote-read-replica-db-cluster --db-cluster-identifier <Green Cluster>

3. Exclua o cluster e a instância.

4. Analise a compatibilidade dos valores dos parâmetros do cluster existente com a versão de destino. Ou alterne para os valores padrão no cluster azul. Em seguida, altere os valores dos parâmetros um de cada vez durante a modificação para o cluster verde.

5. Depois de validar os parâmetros, crie um novo ambiente azul/verde.

Solucionar problemas de upgrade paralisado

Seu cluster verde pode parar durante o upgrade pelos seguintes motivos:

• Incompatibilidade da versão de destino
• Transações de longa duração no cluster azul bloqueiam o processo de upgrade no cluster verde

Para solucionar esse erro, conclua as seguintes tarefas:

1. Verifique se a versão com upgrade oferece suporte à versão de destino para upgrade direto.
2. Se a versão não for compatível, reverta suas alterações e exclua a implantação azul/verde.
3. Faça upgrade para a versão intermediária recomendada. Por fim, faça upgrade para a versão final.

Também é possível monitorar seu cluster azul em busca de transações que duram muito tempo. Se houver transações que durem muito tempo, conclua ou encerre as transações. Em seguida, tente novamente realizar o processo de upgrade.

Informações relacionadas

Como posso fazer upgrade do cluster de banco de dados do Amazon Aurora MySQL para uma nova versão?

Upgrade to Amazon Aurora MySQL version 3 (with MySQL 8.0 compatibility) (Upgrade para o Amazon Aurora MySQL versão 3 (compatível com MySQL 8.0))

Performing major version upgrades for Amazon Aurora MySQL with minimum downtime (Executar grandes upgrades de versão para o Amazon Aurora MySQL com o mínimo de tempo de inatividade)

Realizar a atualização da versão principal de um cluster de bancos de dados do Amazon Aurora MySQL