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:

• Versionamento: cada versão obtém um novo número de versão, e você pode fazer referência às versões anteriores (que ainda estão disponíveis para você) ao criar e gerenciar ambientes.

• Integridade aprimorada: para obter detalhes, consulte Monitoramento e relatório de integridade aprimorada.

• Implantações imutáveis e contínuas com um lote adicional: para obter detalhes sobre as políticas de implantação, consulte Implantar aplicações em ambientes do Elastic Beanstalk.

• Atualizações imutáveis: para obter detalhes sobre os tipos de atualização, consulte Alterações de configuração.

• Atualizações gerenciadas de plataforma: para obter detalhes, consulte Atualizações gerenciadas de plataforma.

nota

Os novos recursos de implantação e atualização dependem da integridade aprimorada. Habilite a integridade aprimorada para usá-los. Para obter mais detalhes, consulte Habilitar relatórios de integridade aprimorada do Elastic Beanstalk.

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:

• Windows Server 2012 R2 de 64 bits executando IIS 8.5

• Windows Server Core 2012 R2 de 64 bits executando IIS 8.5

• Windows Server 2012 de 64 bits executando IIS 8

• Windows Server 2008 R2 de 64 bits executando IIS 7.5

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:

• Windows Server 2012 R2 v1.1.0 de 64 bits executando IIS 8.5

• Windows Server Core 2012 R2 v1.1.0 de 64 bits executando IIS 8.5

• Windows Server 2012 v1.1.0 de 64 bits executando IIS 8

• Windows Server 2008 R2 v1.1.0 de 64 bits executando IIS 7.5

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 da Amazon (AMI) personalizada.

nota

Os recursos de implantação e atualização que são novos no Windows Server v2 dependem da integridade aprimorada. Ao migrar um ambiente para v2, a integridade aprimorada é desabilitada. Habilite-a para usar esses recursos. Para obter mais detalhes, consulte Habilitar relatórios de integridade aprimorada do 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://DOC-EXAMPLE-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).