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

Migrar entre versões principais da plataforma do Windows Server do Elastic Beanstalk

AWS Elastic BeanstalkO tem várias versões principais da plataforma do Windows Server. Esta página aborda as principais melhorias para cada versão principal e o que deve ser considerado antes de migrar para uma versão mais recente.

A plataforma do Windows Server está na versão 2 (v2) no momento. Se o aplicativo usar qualquer versão de plataforma do Windows Server anterior à v2, recomendamos migrar para a v2.

Novidades das versões principais da plataforma do Windows Server

Plataforma do Windows Server V2

A versão 2 (v2) da plataforma Windows Server do Elastic Beanstalk foi lançada em fevereiro de 2019. A V2 aproxima o comportamento da plataforma Windows Server das plataformas Linux do Elastic Beanstalk de várias maneiras importantes. A V2 é totalmente compatível com a v1, o que facilita a migração da v1.

Agora, a plataforma do Windows Server oferece suporte a:

Plataforma do Windows Server V1

A versão 1.0.0 (v1) da plataforma Windows Server do Elastic Beanstalk foi lançada em outubro de 2015. Essa versão altera a ordem na qual o Elastic Beanstalk processa comandos em arquivos de configuração durante a criação e as atualizações do ambiente.

As versões de plataformas anteriores não têm um número de versão no nome da pilha de soluções:

Em versões anteriores, a ordem de processamento dos arquivos de configuração é inconsistente. Durante a criação do ambiente, Container Commands executam depois que o código-fonte do aplicativo é implantado no IIS. Durante uma implantação em um ambiente em execução, os comandos de contêiner executam antes da implantação da nova versão. Durante uma expansão, os arquivos de configuração não são processados.

Além disso, o IIS inicia antes da execução dos comandos de contêiner. Esse comportamento levou alguns clientes a implementar soluções em comandos de contêiner, pausando o servidor IIS antes da execução dos comandos e reiniciando-o após a conclusão.

A versão 1 corrige a inconsistência e aproxima o comportamento da plataforma Windows Server ao das plataformas baseadas em Linux do Elastic Beanstalk. Na plataforma v1, o Elastic Beanstalk sempre executa comandos de contêiner antes de iniciar o servidor IIS.

As pilhas de soluções da plataforma v1 têm um v1 após a versão do Windows Server:

Além disso, a plataforma v1 extrai o conteúdo do pacote de origem do aplicativo em C:\staging\ antes da execução de comandos de contêiner. Após a conclusão dos comandos de contêiner, o conteúdo dessa pasta é compactado em um arquivo .zip e implantado no IIS. Esse fluxo de trabalho permite que você modifique o conteúdo do pacote de origem do aplicativo com comandos ou com um script antes da implantação.

Migrar de versões principais anteriores da plataforma do Windows Server

Leia esta seção sobre considerações de migração antes de atualizar seu ambiente. Para atualizar a plataforma de seu ambiente para uma versão mais recente, visite Atualizar a versão de plataforma do ambiente Elastic Beanstalk.

De V1 para V2

A plataforma v2 do Windows Server não oferece suporte a .NET Core 1.x e 2.0. Se você está migrando o aplicativo do Windows Server v1 para v2 e o aplicativo usa uma dessas versões do .NET Core, atualize o aplicativo para uma versão do .NET Core que ofereça suporte a v2. Para obter uma lista de versões compatíveis, consulte .NET no Windows Server com IIS nas Plataformas do AWS Elastic Beanstalk.

Se o aplicativo usar uma imagem de máquina da Amazon (AMI), crie uma nova AMI personalizada com base em uma AMI da plataforma Windows Server v2. Para saber mais, consulte Usar uma imagem de máquina Amazon personalizada (AMI) no ambiente Elastic Beanstalk.

Da pré-V1

Além das considerações sobre a migração de v1, se você estiver migrando o aplicativo de uma pilha de soluções do Windows Server anterior à v1 e estiver usando comandos de contêiner, remova todos os comandos adicionados para resolver as inconsistências de processamento ao migrar para uma versão mais recente. A partir da v1, é garantido que os comandos de contêiner sejam executados completamente antes da origem do aplicativo implantado e antes do início do IIS. Isso permite que você faça qualquer alteração na origem em C:\staging e modifique os arquivos de configuração do IIS durante esta etapa sem problemas.

Por exemplo, você pode usar a AWS CLI para fazer download de um arquivo DLL na fonte da aplicação do Amazon S3:

.ebextensions\copy-dll.config

container_commands:
  copy-dll:
    command: aws s3 cp s3://amzn-s3-demo-bucket/dlls/large-dll.dll .\lib\

Para obter mais informações sobre o uso de arquivos de configuração, consulte Personalização avançada de ambiente com arquivos de configuração (.ebextensions).