Usar a plataforma Node.js do Elastic Beanstalk

Este tópico descreve como configurar, criar e executar suas aplicações Node.js no Elastic Beanstalk.

O AWS Elastic Beanstalk suporta uma série de ramificações de plataforma para diferentes versões da linguagem de programação Node.js. Consulte Node.js no documento Plataformas do AWS Elastic Beanstalk para uma lista completa.

O Elastic Beanstalk fornece opções de configuração que podem ser usadas para personalizar o software que é executado nas instâncias do EC2 no ambiente Elastic Beanstalk. É possível configurar as variáveis de ambiente necessárias à aplicação, habilitar a alternância de logs para o Amazon S3 e mapear pastas da origem da aplicação que contenham arquivos estáticos para caminhos atendidos pelo servidor de proxy.

As opções de configuração estão disponíveis no console do Elastic Beanstalk para modificar a configuração de um ambiente em execução. Para evitar a perda da configuração do ambiente quando você terminá-la, você pode usar configurações salvas para salvar as configurações e depois aplicá-las a outro ambiente.

Para salvar as configurações no código-fonte, você pode incluir arquivos de configuração. As definições em arquivos de configuração são aplicadas sempre que você cria um ambiente ou implementa a aplicação. Você também pode usar arquivos de configuração para instalar pacotes, executar scripts e realizar outras operações de personalização da instância em implantações.

É possível incluir um arquivo Package.json no pacote de fontes para instalar pacotes durante a implantação, fornecer um comando iniciar e especificar a versão do Node.js que você deseja que a aplicação use. Você pode incluir um arquivo npm-shrinkwrap.json para bloquear versões de dependência.

A plataforma Node.js inclui um servidor proxy para servir ativos estáticos, encaminhar tráfego para a aplicação e compactar respostas. Você pode estender ou substituir a configuração de proxy padrão para cenários avançados.

Existem várias opções para iniciar seu aplicativo. Você pode adicionar um Procfile ao pacote de fontes para especificar o comando que inicia a aplicação. Quando você não fornece um Procfile, mas fornece um arquivo package.json, o Elastic Beanstalk executa npm start. Se você não fornecer nenhum dos dois, o Elastic Beanstalk procurará o arquivo app.js ou server.js, nessa ordem, e o executará.

As configurações aplicadas no console do Elastic Beanstalk substituem as mesmas configurações em arquivos de configuração, caso elas existam. Isso permite que você tenha configurações padrão em arquivos de configuração e as substitua por configurações específicas de ambiente no console. Para obter mais informações sobre precedência e outros métodos de alteração das configurações, consulte Opções de configuração.

Para obter detalhes sobre as várias maneiras de estender uma plataforma do Elastic Beanstalk baseada em Linux, consulte Estender as plataformas Linux do Elastic Beanstalk.

Configurar o ambiente Node.js

Você pode usar as configurações da plataforma Node.js para aprimorar ainda mais o comportamento das instâncias do Amazon EC2. É possível editar a configuração da instância do Amazon EC2 do ambiente do Elastic Beanstalk usando o console do Elastic Beanstalk.

Você pode usar o console do Elastic Beanstalk para habilitar a alternância de logs para o Amazon S3 e configurar variáveis que sua aplicação pode ler no ambiente.

Opções de contêiner

É possível definir estas opções específicas da plataforma:

Opções de log

A seção Log Options (Opções de log) tem duas configurações:

Arquivos estáticos

Para melhorar a performance, você pode usar a seção Static files (Arquivos estáticos) para configurar o servidor proxy para servir arquivos estáticos (por exemplo, HTML ou imagens) de um conjunto de diretórios dentro da aplicação Web. Defina, para cada diretório, o caminho virtual para mapeamento de diretórios. Quando o servidor de proxy recebe uma solicitação para um arquivo no caminho especificado, ele atende o arquivo diretamente em vez de rotear solicitação para seu aplicativo.

Para ver detalhes sobre como configurar arquivos estáticos usando arquivos de configuração ou o console do Elastic Beanstalk, consulte Fornecer arquivos estáticos.

Propriedades de ambiente

Use a seção Propriedades do Ambiente para especificar definições de configuração de ambientes nas instâncias do Amazon EC2 que estão executando sua aplicação. Essas definições são passadas para o aplicativo como pares de chave-valor.

Dentro do ambiente Node.js que é executado no AWS Elastic Beanstalk, você pode acessar as variáveis de ambiente executando process.env.ENV_VARIABLE.

var endpoint = process.env.API_ENDPOINT

A plataforma Node.js define a variável de ambiente PORT como a porta para a qual o servidor proxy direciona o tráfego. Para ter mais informações, consulte Configurar o servidor de proxy.

Consulte Propriedades de ambientes e outras configurações de software Para mais informações.

Namespace de configuração do Node.js

Você pode usar um arquivo de configuração para definir opções de configuração e executar outras tarefas de configuração de instância durante implantações. Opções de configuração podem ser específicas da plataforma ou aplicáveis a todas as plataformas no serviço Elastic Beanstalk como um todo. As opções de configuração são organizadas em namespaces.

É possível escolher o proxy a ser usado nas instâncias do seu ambiente usando o namespace aws:elasticbeanstalk:environment:proxy. O exemplo a seguir configura o ambiente para usar o servidor proxy Apache HTTPD.

option_settings:
  aws:elasticbeanstalk:environment:proxy:
    ProxyServer: apache

É possível configurar o proxy para servir arquivos estáticos usando o namespace aws:elasticbeanstalk:environment:proxy:staticfiles. Para obter mais informações e um exemplo, consulte Fornecer arquivos estáticos.

O Elastic Beanstalk oferece muitas opções de configuração para personalizar o ambiente. Além de arquivos de configuração, você também pode definir opções de configuração usando o console, configurações salvas, a EB CLI ou a AWS CLI. Consulte Opções de configuração para obter mais informações.

var port = process.env.PORT || 8080;

app.listen(port, function() {
  console.log('Server running at http://127.0.0.1:%s', port);
});

option_settings:
  aws:elasticbeanstalk:container:nodejs: 
    NodeCommand: "npm start"
    ProxyServer: apache
    GzipCompression: true
  aws:elasticbeanstalk:container:nodejs:staticfiles:
    /html: statichtml
    /images: staticimages