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

Solução de problemas e diagnóstico

Esta seção fornece orientação para solucionar problemas comuns que podem surgir durante a migração de aplicações IIS para o Elastic Beanstalk.

Associando um EC2 par de chaves ao seu ambiente

Você pode fazer login com segurança nas instâncias do Amazon Elastic Compute Cloud (Amazon EC2) provisionadas para seu aplicativo Elastic Beanstalk com um par de chaves da Amazon. EC2 Para obter instruções sobre como criar um par de chaves, consulte Como criar um par de chaves usando a Amazon EC2 no Guia EC2 do usuário da Amazon.

Especificar um nome de chave para eb migrate tem o efeito de fazer seu ambiente Elastic Beanstalk estar associado ao par de chaves. Por motivos de segurança, isso não abrirá a porta 3389 no grupo de segurança de suas EC2 instâncias. Você pode associar grupos EC2 de segurança adicionais que permitam o tráfego na porta 3389 até eb config depois da migração inicial.

PS C:\migrations_workspace> eb migrate  `
    --keyname "my-keypair"  `
    --verbose

Quando você cria um par de chaves, a Amazon EC2 armazena uma cópia da sua chave pública. Se você não precisar mais usá-lo para se conectar a nenhuma instância do ambiente, poderá excluí-lo da Amazon EC2. Para obter detalhes, consulte Excluindo seu par de chaves no Guia do EC2 usuário da Amazon.

Para obter mais informações sobre como se conectar às EC2 instâncias do Windows Amazon, consulte Conectando-se à instância do Windows.

Acesso a logs

O EB CLI fornece um eb logs recurso que você pode usar para recuperar registros de um ambiente do Elastic Beanstalk sem fazer login em suas instâncias. EC2 Após a execução de eb migrate, você pode emitir o comando eb logs --zip que baixará e salvará os logs no diretório .elasticbeanstalk\logs.

Como alternativa, você pode visualizar os registros por meio do console do AWS Elastic Beanstalk. Para obter mais informações, consulte Visualizar logs de instâncias do Amazon EC2 no ambiente do Elastic Beanstalk.

Acessar artefatos no lado do cliente

O comando eb migrate armazena registros de aplicações e erros gerados por msdeploy dentro de diretórios de artefatos de migração internos.

./migrations/
├── latest -> migration_20240308_123456/
└── migration_20240308_123456/
    ├── application.log
    ├── error.log
    └── upload_target\

Monitorar a integridade do ambiente

O Elastic Beanstalk ajuda você a monitorar a integridade usando os recursos aprimorados de monitoramento da integridade. É um sistema automatizado de monitoramento de integridade que rastreia continuamente o status operacional de instâncias de aplicaçãos, aproveitando métricas integradas, como utilização da CPU, latência, contagem de solicitações e códigos de resposta.

O sistema de monitoramento de integridade utiliza uma abordagem baseada em agentes para coletar dados em nível de instância e se integra com logs e alertas em tempo real. O ELB (ELB) e o Auto Scaling respondem dinamicamente às mudanças no status de saúde, garantindo alta disponibilidade e tolerância a falhas. Os modos avançados de monitoramento, incluindo relatórios de integridade aprimorados, fornecem visibilidade granular do comportamento da aplicação, permitindo a solução proativa de problemas e mecanismos de recuperação automática.

Execute o comando eb health da EB CLI para exibir a integridade do ambiente. A informação a seguir será exibida.

EC2 otimização de desempenho

Por padrão, eb migrate seleciona o tipo de instância c5.2xlarge para fornecer uma ótima experiência inicial com o Elastic Beanstalk. É possível substituir esse comportamento pelo argumento --instance-type:

PS C:\migrations_workspace> eb migrate `
    --instance-type "t3.large"

Em ambientes de produção, considere os seguintes fatores ao selecionar um tipo de instância:

Configuração de volumes do EBS

Por padrão, o Elastic Beanstalk criará somente um volume de dispositivo de bloco raiz (C:\) para seu ambiente. Você pode transmitir volumes adicionais de snapshot do Amazon Elastic Block Store com a opção --ebs-snapshots:

PS C:\migrations_workspace> eb migrate `
    --ebs-snapshots "snap-123456789abc"

Para ver exemplos de como configurar mapeamentos de dispositivos de blocos com o Elastic Beanstalk, consulte o artigo do blog Personalizar volumes efêmeros e do EBS em ambientes do Elastic Beanstalk.

Para aplicações com altos requisitos de armazenamento, considere as seguintes opções:

Problemas e soluções comuns de

Evento: Instalação ausente do Web Deploy

Se você encontrar erros relacionados ao Web Deploy não ser encontrado, instale o Web Deploy 3.6 ou posterior a partir do Microsoft Web Platform Installer. O exemplo a seguir exibe uma possível mensagem de erro.

Couldn't find msdeploy.exe. Follow instructions here: https://learn.microsoft.com/en-us/iis/install/installing-publishing-technologies/installing-and-configuring-web-deploy

Evento: problemas de permissão durante a migração

Se você encontrar erros relacionados à permissão, verifique se está executando a EB CLI com privilégios administrativos. O exemplo a seguir exibe uma possível mensagem de erro.

[ERROR] Access to the path 'C:\inetpub\wwwroot\web.config' is denied.

Evento: problemas de identidade do grupo de aplicações

Se a aplicação falhar ao iniciar devido a problemas de identidade do grupo de aplicações, crie um script personalizado para configurar as identidades do grupo de aplicações, conforme mostrado em Configurações personalizadas do grupo de aplicações.

Evento: Erros de configuração do certificado SSL

Se associações HTTPS não funcionarem, certifique-se de ter especificado um ARN de certificado do ACM válido utilizando o parâmetro --ssl-certificates da opção eb mibrate.

Evento: Tempo limite para criação do ambiente

Se a criação do ambiente expirar, verifique se há falhas específicas na criação de recursos nos CloudFormation eventos no AWS Management Console. As causas comuns incluem problemas de configuração da VPC ou limites de serviços.

Obter suporte

Se você encontrar problemas que não consegue resolver, antes de entrar em contato, AWS Support reúna as seguintes informações:

Para obter mais informações sobre solução de problemas com o Elastic Beanstalk, consulte Solucionar problemas com o ambiente Elastic Beanstalk.