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ósticos

Esta seção fornece orientação para solucionar problemas comuns que podem surgir durante a migração de aplicativos 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 eb migrate tem o efeito de associar seu ambiente do Elastic Beanstalk 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.

Acessando registros

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 doeb migrate, você pode emitir o eb logs --zip comando que baixará e salvará os registros no .elasticbeanstalk\logs diretório.

Como alternativa, você pode visualizar os registros por meio do console do AWS Elastic Beanstalk. Para obter mais informações, consulte Visualização de registros de EC2 instâncias da Amazon em seu ambiente do Elastic Beanstalk.

Acessando artefatos do lado do cliente

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

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

Monitorando a saúde do ambiente

O Elastic Beanstalk ajuda você a monitorar a saúde usando os recursos aprimorados de monitoramento da saúde. É um sistema automatizado de monitoramento de integridade que rastreia continuamente o status operacional das instâncias do aplicativo, 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 registros e alertas em tempo real. O Elastic Load Balancing (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 do aplicativo, permitindo a solução proativa de problemas e mecanismos de recuperação automática.

Execute o eb health comando 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. Você pode substituir esse comportamento com o --instance-type argumento:

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

Para ambientes de produção, considere esses fatores ao selecionar um tipo de instância:

Configuração de volume do EBS

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

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

Para ver exemplos de como você pode 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 aplicativos com altos requisitos de armazenamento, considere as seguintes opções:

Problemas e soluções comuns de

Evento: Falta a instalação do Web Deploy

Se você encontrar erros relacionados ao fato de o Web Deploy não ter sido 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 CLI do EB 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 pool de aplicativos

Se o aplicativo falhar ao iniciar devido a problemas de identidade do pool de aplicativos, crie um script personalizado para configurar as identidades do pool de aplicativos, conforme mostrado emConfigurações personalizadas do pool de aplicativos.

Evento: erros de configuração do certificado SSL

Se as associações HTTPS não funcionarem, verifique se você especificou um ARN de certificado ACM válido usando o parâmetro option. eb mibrate --ssl-certificates

Evento: Tempo limite de criação do ambiente

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

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 a solução de problemas do Elastic Beanstalk, consulte. Solucionar problemas com o ambiente Elastic Beanstalk