View a markdown version of this page

Práticas recomendas e solução de problemas - AWS Transformação

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Práticas recomendas e solução de problemas

Melhores práticas e problemas comuns e suas soluções durante o processo de modernização.

Registros de aplicativos do ECS

CloudWatch troncos

  • Todos os registros de contêineres do ECS são enviados automaticamente para CloudWatch Logs

  • Acesse os registros no CloudWatch console em Grupos de registros

  • Formato de nomenclatura do grupo de registros:/aws/ecs/{application-name}

  • Cada instância de contêiner cria um novo fluxo de log dentro do grupo.

Visualizar logs

Por meio AWS do console:

  • Navegue até CloudWatch > Grupos de registros

  • Selecione o grupo de registros do seu aplicativo

  • Escolha o fluxo de registros relevante para visualizar os registros do contêiner

Usando a AWS CLI:

aws logs get-log-events --log-group-name /aws/ecs/your-app-name --log-stream-name your-stream-name

Localizações comuns de registros

  • Registros do aplicativo: CloudWatch registros

  • Eventos do serviço ECS: Console do ECS > Cluster > Serviço > guia Eventos

  • Contêiner health/status: Console do ECS > Cluster > Serviço > guia Tarefas

Gerenciamento de conexões de banco de dados

Os aplicativos usam variáveis de ambiente para configurações de conexão do banco de dados

Se você tiver problemas de conectividade:

  • Verifique as configurações de conexão atuais em suas variáveis de ambiente

  • Atualize as variáveis de ambiente para modificar as cadeias de conexão do banco de dados conforme necessário

  • Alterações na cadeia de conexão podem ser feitas por meio de atualizações de variáveis de ambiente sem a reimplantação do aplicativo

Problemas de conexão de banco de dados

Problema: Não é possível conectar o AWS Transform ao SQL Server

Soluções:

  • Verifique a conectividade de rede entre o AWS Transform e o SQL Server

  • Verifique as regras do grupo de segurança para acesso adequado à porta (1433)

  • Confirme as credenciais do banco de dados no Secrets Manager

  • Teste as permissões do banco de dados com o usuário criado

  • Verifique se o SQL Server está configurado para autenticação em modo misto

  • Verifique se o segredo tem as tags necessárias (Projeto: atx-db-modernization, proprietário: database-connector)

Problemas de firewall e grupos de segurança

Problema: tempo limite de conexão ou erros de “não é possível acessar o banco de dados”

Causa raiz: grupos de segurança ou ACLs de rede bloqueando o tráfego

Soluções:

  1. Verifique a configuração do grupo de segurança:

    • Confirme se seu grupo de segurança do SQL Server tem uma regra de entrada que permite a porta 1433 do grupo de segurança DMS Schema Conversion

    • Verifique se a origem é o ID do grupo de segurança (por exemplo, sg-0123456789abcdef0), não um endereço IP

    • Verifique se o grupo de segurança DMS Schema Conversion está especificado corretamente no Perfil da Instância

    • Certifique-se de que não haja regras de negação conflitantes

  2. Verifique as ACLs de rede:

    • Verifique se as ACLs de rede no nível da sub-rede permitem tráfego de entrada na porta 1433

    • Certifique-se de que as ACLs de rede permitam portas efêmeras de saída para tráfego de retorno

    • Verifique as ACLs de rede da sub-rede do banco de dados e da sub-rede do DMS

  3. Verifique a configuração da VPC:

    • Confirme se a instância de conversão do esquema DMS e o SQL Server estão na mesma VPC ou têm o emparelhamento de VPC adequado

    • Verifique se as tabelas de rotas permitem o tráfego entre sub-redes

    • Verifique se nenhum dispositivo de firewall está bloqueando o tráfego

  4. Teste a conectividade:

    • Execute uma instância EC2 de teste na mesma sub-rede do DMS Schema Conversion

    • Anexe o mesmo grupo de segurança que o DMS Schema Conversion

    • Teste a conexão com o SQL Server usando telnet ou SQL Server Management Studio

    • Se o teste for bem-sucedido, o problema é com a configuração do AWS Transform; se falhar, o problema é network/firewall

Erro comum: abrir a porta 1433 para 0.0.0. 0/0 (todas as fontes) é um risco de segurança. Sempre use o controle de acesso baseado em grupos de segurança para limitar o acesso somente ao grupo de segurança DMS Schema Conversion.

Problemas de conversão de esquema

Problema: a conversão do esquema mostra muitos itens de ação

Soluções:

  • Revise os itens de ação no relatório de conversão

  • Priorize com base no impacto

  • Use o Amazon Q Developer para conversões complexas de SQL

  • Consulte o AWS Support para obter orientação

  • Considere a abordagem em fases para bancos de dados complexos

Problemas de transformação de aplicativos

Problema: falha na construção da transformação do aplicativo

Soluções:

  • Analise os erros de construção no relatório de transformação

  • Configure NuGet feeds privados, se necessário

  • Atualize as referências do pacote, se necessário

  • Verifique as Windows-specific dependências

  • Analise os registros de transformação para ver erros detalhados

Problemas de migração de dados

Problema: falha na validação da migração de dados

Soluções:

  • Revise o relatório de validação para falhas específicas

  • Verifique os mapeamentos de tipos de dados

  • Verifique a configuração da coluna de identidade (GERADA POR PADRÃO versus GERADA SEMPRE)

  • Revise as expressões de coluna computadas

  • Entre em contato com o AWS Support para problemas complexos de dados

Problemas de limpeza de recursos

Problema: falha na tarefa de transformação com erros de recursos

Soluções:

  • Verifique os recursos existentes do DMS (projetos de migração, provedores de dados, perfis de instância)

  • Limpe recursos falhados ou incompletos de tentativas anteriores

  • Verifique se os segredos não estão programados para exclusão

  • Verifique as cotas de serviço para DMS e Aurora PostgreSQL

  • Entre em contato com o AWS Support se a limpeza não resolver o problema

Problemas de implantação

Problema: o aplicativo transformado não consegue se conectar ao Aurora PostgreSQL

Soluções:

  • Verifique o formato da cadeia de conexão para o PostgreSQL

  • Verifique as regras do grupo de segurança

  • Verifique as credenciais do banco de dados no Secrets Manager

  • Verifique SSL/TLS se está configurado corretamente

  • Teste a conexão usando psql ou pgAdmin

Obter ajuda adicional

Ao entrar em contato com o AWS Support, forneça:

  • ID do trabalho de transformação

  • AWS ID da conta

  • Região

  • Mensagens de erro e capturas de tela

  • Registros de transformação (disponíveis no console do AWS Transform)