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á.
Migração do Amazon Linux AMI (AL1) para AL2 ou AL2 023
Se seu aplicativo Elastic Beanstalk for baseado em uma ramificação da plataforma AMI Amazon Linux, use esta seção para aprender como migrar os ambientes do seu aplicativo para o Amazon Linux 2 ou Amazon Linux 2023. As filiais da plataforma da geração anterior baseadas no Amazon Linux
É altamente recomendável migrar para o Amazon Linux 2023, já que ele é mais recente do que o Amazon Linux 2. O encerramento do suporte ao sistema operacional Amazon Linux 2 ocorrerá antes do encerramento do suporte ao Amazon Linux 2023. Consequentemente, você se beneficiará de um período de suporte mais longo se migrar para o Amazon Linux 2023.
Há um alto grau de compatibilidade entre as plataformas Amazon Linux 2 e Amazon Linux 2023 do Elastic Beanstalk. Embora algumas áreas tenham diferenças: a opção padrão do Instance Metadata Service Version 1 (IMDSv1), o suporte para a ferramenta de instância pkg-repo e algumas configurações do Apache. HTTPd Para ter mais informações, consulte Amazon Linux 2023
Diferenças e compatibilidade
Não é garantido que as ramificações da plataforma AL2 baseadas em AL2 023/ sejam compatíveis com versões anteriores de seu aplicativo existente. É importante ter em mente que, mesmo que o código da aplicação seja implantado com sucesso na nova versão da plataforma, ele poderá se comportar ou ser executado de forma diferente devido às diferenças de runtime e sistema operacional.
Embora o Amazon Linux AMI e o AL2 023/ AL2 compartilhem o mesmo kernel Linux, eles diferem nos seguintes aspectos: o sistema de inicialização, libc
as versões, a cadeia de ferramentas do compilador e vários pacotes. Para obter mais informações, consulte Amazon Linux 2 FAQs
O serviço Elastic Beanstalk também atualizou as versões de runtime, ferramentas de compilação e outras dependências específicas de cada plataforma.
Portanto, recomendamos que você reserve um tempo para testar seu aplicativo minuciosamente em um ambiente de desenvolvimento e faça os ajustes necessários.
Processo geral de migração
Quando você estiver pronto para ir para produção, o Elastic Beanstalk exigirá uma implantação azul/verde para executar a atualização. As etapas gerais de práticas recomendadas para a migração com um procedimento de implantação azul/verde são descritas a seguir.
Preparar para testar a migração
Antes de a aplicação e começar a testá-la, revise as informações em Considerações para todas as plataformas Linux que serão apresentadas posteriormente neste tópico. Além disso, revise as informações aplicáveis à sua plataforma na seção Considerações específicas da plataforma a seguir. Anote as informações específicas desse conteúdo que podem ser usadas na aplicação e na configuração definida.
Etapas de migração de alto nível
-
Crie um novo ambiente baseado em uma ramificação da plataforma AL2 ou AL2 023. Recomendamos que você migre para uma ramificação da plataforma AL2 023.
-
Implante seu aplicativo no ambiente AL2 023/ AL2 de destino.
O ambiente de produção existente permanecerá ativo e não será afetado, enquanto você estiver fazendo interações por meio de testes e ajustes no novo ambiente.
-
Teste a aplicação minuciosamente no novo ambiente.
-
Quando seu AL2 ambiente AL2 023/ de destino estiver pronto para ser produzido, troque um CNAMEs dos dois ambientes para redirecionar o tráfego para o novo ambiente.
Etapas de migração mais detalhadas e práticas recomendadas
Para obter um procedimento de implantação azul/verde mais detalhado, consulte. Implantações azuis/verdes com o Elastic Beanstalk
Para obter orientações mais específicas e etapas detalhadas de práticas recomendadas, consulte Método azul/verde.
Mais referências para ajudar a planejar a migração
As referências a seguir podem oferecer informações adicionais para planejar sua migração.
-
Comparação entre o Amazon Linux 2 e o Amazon Linux 2023 no Guia do usuário do Amazon Linux 2023.
-
O que é o Amazon Linux 2023? no Guia do usuário Amazon Linux 2023.
-
Plataformas compatíveis com Elastic Beanstalk em Plataformas AWS Elastic Beanstalk
Considerações para todas as plataformas Linux
A tabela a seguir discute as considerações que você deve conhecer ao planejar a migração de um aplicativo para AL2 023/. AL2 Essas considerações se aplicam a qualquer uma das plataformas Linux do Elastic Beanstalk, independentemente de linguagens de programação específicas ou servidores de aplicações.
Área | Alterações e informações |
---|---|
Arquivos de configuração |
Nas AL2 plataformas AL2 023/, você pode usar arquivos de configuração como antes, e todas as seções funcionam da mesma maneira. No entanto, configurações específicas podem não funcionar da mesma forma que funcionavam nas AMI plataformas Amazon Linux anteriores. Por exemplo:
Recomendamos o uso de hooks de plataforma para executar o código personalizado em instâncias do seu ambiente. Você ainda pode usar comandos e os comandos de contêiner em arquivos de configuração Você ainda precisa usar arquivos de configuração |
Hooks de plataforma |
AL2as plataformas introduziram uma nova maneira de estender a plataforma do seu ambiente adicionando arquivos executáveis aos diretórios de conexão nas instâncias do ambiente. É possível que você possa ter usado hooks de plataforma personalizada com versões anteriores da plataforma Linux. Esses hooks não foram projetados para plataformas gerenciadas e não eram compatíveis, mas podiam funcionar de maneira útil em alguns casos. Nas versões AL2 AL2 023/plataforma, os ganchos de plataforma personalizados não funcionam. Você deve migrar todos os hooks para os novos hooks de plataforma. Para obter detalhes, expanda a seção Platform Hooks (Hooks de plataforma) em Estender as plataformas Linux do Elastic Beanstalk. |
Servidores de proxy compatíveis |
AL2As versões da AL2 plataforma 023/ suportam os mesmos servidores proxy reversos de cada plataforma suportada nas versões da AMI plataforma Amazon Linux. Todas as versões da plataforma AL2 023/AL2; usam o nginx como seu servidor proxy reverso padrão, com exceção das plataformas the e Docker. ECS As plataformas TomcatPHP, Node.js e Python também oferecem suporte ao HTTPD Apache como alternativa. Todas as plataformas habilitam a configuração do servidor de proxy de forma uniforme, conforme descrito nesta seção. No entanto, a configuração do servidor proxy é um pouco diferente do que era no Amazon Linux. AMI Estas são as diferenças para todas as plataformas:
Para ver as alterações de configuração de proxy específicas da plataforma, consulte Considerações específicas da plataforma. Para obter informações sobre a configuração de proxy nas AL2 plataformas AL2 023/, expanda a seção Configuração de proxy reverso em. Estender as plataformas Linux do Elastic Beanstalk |
Alterações de configuração de proxy |
Algumas alterações de configuração de proxy se aplicam uniformemente a todas as plataformas, mas há também alterações de configuração de proxy específicas de cada plataforma. É importante consultar ambas para configurar os ambientes com precisão.
|
Perfil de instância |
AL2AL2As plataformas 023/ exigem que um perfil de instância seja configurado. A criação do ambiente pode ser bem-sucedida temporariamente sem um perfil, mas o ambiente poderá mostrar erros logo após a criação, quando as ações que exigem um perfil de instância começarem a falhar. Para obter detalhes, consulte Gerenciar perfis de instância do Elastic Beanstalk. |
Integridade avançada |
AL2As versões da AL2 plataforma 023/ habilitam a integridade aprimorada por padrão. Trata-se de uma alteração, se você não usa o console do Elastic Beanstalk para criar seus ambientes. O console permite a integridade aprimorada por padrão sempre que possível, independentemente da versão da plataforma. Para obter detalhes, consulte Relatórios e monitoramento de saúde aprimorados do Elastic Beanstalk. |
Personalizado AMI |
Se seu ambiente usa um personalizado AMI, crie um novo AMI baseado em AL2 023/ AL2 para seu novo ambiente usando uma plataforma Elastic Beanstalk 023/. AL2 AL2 |
Plataformas personalizadas |
As versões gerenciadas AMIs da AL2 plataforma AL2 023/ não oferecem suporte a plataformas personalizadas. |
Considerações específicas da plataforma
Esta seção aborda considerações de migração específicas para determinadas plataformas Linux do Elastic Beanstalk.
A família de filiais da plataforma Docker baseada no Amazon Linux AMI (AL1) inclui três ramificações da plataforma. Recomendamos um caminho de migração específico para cada.
AL1Filial da plataforma | Caminho de migração para AL2 023/ AL2 | ||||||||
---|---|---|---|---|---|---|---|---|---|
Docker de vários contêineres gerenciado pela Amazon ECS em execução no Amazon Linux AMI () AL1 |
ECSfiliais da plataforma Docker AL2 AL2 023/baseadas na plataformaAs ramificações ECSbaseadas na AL2 plataforma Docker AL2 023/ oferecem um caminho de migração simples para ambientes executados na ramificação da plataforma Docker de vários contêineres. AL1
Para obter mais informações sobre como migrar seus aplicativos executados na ramificação da plataforma Docker Amazon Linux de vários contêineres para uma ECSAmazon executada AL2 na ramificação da plataforma AL2 023/, consulte. Migrando seu ECS aplicativo Elastic Beanstalk do Docker gerenciado de vários contêineres para o Amazon Linux 2023 AL1 ECS |
||||||||
Docker em execução no Amazon Linux AMI () AL1 Docker pré-configurado (Glassfish 5.0) executando Amazon Linux () AMI AL1 |
Docker em execução na ramificação da plataforma AL2 023/ AL2Recomendamos que você migre seus aplicativos executados em ambientes baseados no Docker pré-configurado (Glassfish 5.0) ou no Docker em execução no Amazon Linux AMI (AL1) para ambientes baseados no Docker Running no Amazon Linux 2 ou no Docker Running nas ramificações da plataforma 023. AL2 Se o ambiente for baseado na ramificação de plataforma Docker pré-configurado (Glassfish 5.0), consulte Implantação de um GlassFish aplicativo na plataforma Docker: um caminho de migração para o Amazon Linux 2023. A tabela a seguir lista as informações de migração específicas para a ramificação da plataforma Docker em execução em AL2 AL2 023/.
|
A tabela a seguir lista as informações de migração para as versões da AL2 plataforma AL2 023/ na plataforma Go.
Área | Alterações e informações |
---|---|
Transmissão de porta |
Nas AL2 plataformas AL2 023/, o Elastic Beanstalk não passa um valor de porta para seu processo de aplicação por meio da variável de ambiente. |
A tabela a seguir lista as informações de migração para as ramificações de plataforma do Corretto na plataforma Java SE.
Área | Alterações e informações |
---|---|
Corretto x Open JDK |
Para implementar a Plataforma Java, Standard Edition (Java SE), as ramificações da AL2 plataforma AL2 023/ usam o Amazon Corretto |
Ferramentas de compilação |
AL2AL2As plataformas 023/ têm versões mais recentes das ferramentas de construção: |
JARmanipulação de arquivos |
Nas AL2 plataformas AL2 023/, se seu pacote de origem (ZIParquivo) contiver um único arquivo e nenhum outro JAR arquivo, o Elastic Beanstalk não renomeia mais o arquivo para. JAR |
Transmissão de porta |
Nas AL2 plataformas AL2 023/, o Elastic Beanstalk não passa um valor de porta para seu processo de aplicação por meio da variável de ambiente. |
Java 7 |
O Elastic Beanstalk não é AL2 compatível com AL2 uma ramificação da plataforma 023/Java 7. Se você tiver uma aplicação Java 7, migre-a para Corretto 8 ou Corretto 11. |
A tabela a seguir lista as informações de migração para as versões da AL2 plataforma AL2 023/ na plataforma Tomcat.
Área | Alterações e informações | ||||||
---|---|---|---|---|---|---|---|
Opções de configuração |
Nas versões da AL2 plataforma AL2 023/, o Elastic Beanstalk suporta somente um subconjunto das opções de configuração e dos valores das opções no namespace.
A |
||||||
Caminho do aplicativo |
Nas AL2 plataformas AL2 023/, o caminho para o diretório do aplicativo nas EC2 instâncias Amazon do seu ambiente é. |
A tabela a seguir lista as informações de migração para as versões da AL2 plataforma AL2 023/ na plataforma Node.js.
Área | Alterações e informações | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Versões Node.js instaladas |
Nas AL2 plataformas AL2 023/, o Elastic Beanstalk mantém várias ramificações da plataforma Node.js e instala somente a versão mais recente da versão principal do Node.js correspondente à ramificação da plataforma em cada versão da plataforma. Por exemplo, cada versão da plataforma na ramificação da plataforma Node.js 12 tem somente o Node.js 12.x.y instalado por padrão. Nas versões da AMI plataforma Amazon Linux, instalamos as várias versões de várias versões do Node.js em cada versão da plataforma e mantivemos apenas uma única ramificação da plataforma. Escolha a ramificação da plataforma Node.js que corresponde à versão principal do Node.js de que seu aplicativo precisa. |
||||||||||
Nomes dos arquivos de HTTPD log do Apache |
Nas AL2 plataformas AL2 023/, se você usa o servidor HTTPD proxy Apache, os nomes dos arquivos de HTTPD log são Para obter detalhes sobre nomes de arquivos de log e locais de todas as plataformas, consulte Como o Elastic Beanstalk configura os registros CloudWatch . |
||||||||||
Opções de configuração |
Nas AL2 plataformas AL2 023/, o Elastic Beanstalk não oferece suporte às opções de configuração no namespace.
|
Área | Alterações e informações |
---|---|
PHPprocessamento de arquivos |
Nas AL2 plataformas AL2 023/, PHP os arquivos são processados usando PHP - FPM (um gerenciador de CGI processos). Nas AMI plataformas Amazon Linux, usamos o mod_php (um módulo Apache). |
Servidor de proxy |
AL2As versões da AL2 PHP plataforma 023/ suportam os servidores proxy nginx e Apache. HTTPD O padrão é nginx. As versões da AMI PHP plataforma Amazon Linux eram compatíveis somente com o ApacheHTTPD. Se você adicionou arquivos de configuração personalizados do Apache, poderá definir a opção |
Área | Alterações e informações |
---|---|
WSGIservidor |
Nas AL2 plataformas AL2 023/, o Gunicorn Como alternativa, você pode usar a |
Caminho do aplicativo |
Nas AL2 plataformas AL2 023/, o caminho para o diretório do aplicativo nas EC2 instâncias Amazon do seu ambiente é. |
Servidor de proxy |
AL2023/ As versões da plataforma AL2 Python suportam os servidores proxy nginx e Apache. HTTPD O padrão é nginx. As versões da plataforma Amazon Linux AMI Python suportavam somente o Apache. HTTPD Se você adicionou arquivos de configuração personalizados do Apache, poderá definir a opção |
A tabela a seguir lista as informações de migração para as versões da AL2 plataforma AL2 023/ na plataforma Ruby.
Área | Alterações e informações |
---|---|
Versões Ruby instaladas |
Nas AL2 plataformas AL2 023/, o Elastic Beanstalk instala somente a versão mais recente de uma única versão do Ruby, correspondente à ramificação da plataforma, em cada versão da plataforma. Por exemplo, cada versão da plataforma na ramificação da plataforma Ruby 2.6 tem somente o Ruby 2.6.x instalado. Nas versões da AMI plataforma Amazon Linux, instalamos as versões mais recentes de várias versões do Ruby, por exemplo, 2.4.x, 2.5.x e 2.6.x. Se seu aplicativo usar uma versão do Ruby que não corresponda à ramificação da plataforma que você está usando, recomendamos mudar para uma ramificação de plataforma que tenha a versão do Ruby correta para seu aplicativo. |
Servidor de aplicativos |
Nas AL2 plataformas AL2 023/, o Elastic Beanstalk só instala o servidor de aplicativos Puma em todas as versões da plataforma Ruby. É possível usar um Na AMI plataforma Amazon Linux, oferecemos suporte a dois tipos de ramificações de plataforma para cada versão do Ruby — uma com o servidor de aplicativos Puma e outra com o servidor de aplicativos Passenger. Se o seu aplicativo usar o Passenger, é possível configurar seu ambiente Ruby para instalar e usar o Passenger. Para ter mais informações e exemplos, consulte Usar a plataforma Ruby do Elastic Beanstalk. |