View a markdown version of this page

QuickStart: Implante um Node.js aplicativo no Elastic Beanstalk - AWS Elastic Beanstalk
Suas AWS accountPré-requisitosEtapa 1: criar um Node.js aplicativoEtapa 2: executar a aplicação localmenteEtapa 3: implantar seu Node.js aplicativo com o EB CLIEtapa 4: executar a aplicação no Elastic BeanstalkEtapa 5: limparAWS recursos para seu aplicativoPróximas etapasImplantar com o console

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

QuickStart: Implante um Node.js aplicativo no Elastic Beanstalk

Este QuickStart tutorial mostra o processo de criação de um Node.js aplicativo e sua implantação em um AWS Elastic Beanstalk ambiente.

Não é para uso em produção

Os exemplos são destinados apenas para demonstração. Não use aplicações de exemplo na produção.

Suas AWS account

Se você ainda não é AWS cliente, precisa criar uma AWS conta. A inscrição permite que você acesse o Elastic Beanstalk AWS e outros serviços de que você precisa.

Se você já tem uma AWS conta, você pode passar paraPré-requisitos.

Inscreva-se para um Conta da AWS

Para começar AWS, você precisa de um Conta da AWS. Para obter informações sobre como criar um Conta da AWS, consulte Introdução a um Conta da AWS no Guia de AWS Gerenciamento de contas referência.

Pré-requisitos

Para seguir os procedimentos neste manual, você precisa de um terminal de linha de comando ou de um shell para executar os comandos. Nas listagens, os comandos são mostrados precedidos por um símbolo de prompt ($) e pelo nome do diretório atual, quando apropriado.

~/eb-project$ this is a command
this is output

No Linux e no macOS, você pode usar seu gerenciador de pacotes e de shell preferido. No Windows, você pode instalar o Windows Subsystem for Linux para obter uma Windows-integrated versão do Ubuntu e do Bash.

EB CLI

Este tutorial também usa a Interface de Linhas de Comando do Elastic Beanstalk (CLI do EB). Para obter detalhes sobre a instalação e configuração da CLI do EB, consulte Instalar a EB CLI com script de configuração (recomendado) e Configurar a EB CLI.

Node.js

Instale Node.js em sua máquina local seguindo Como instalar Node.js no Node.js site.

Verifique sua Node.js instalação executando o comando a seguir.

~$ node -v

Etapa 1: criar um Node.js aplicativo

Crie um diretório do projeto.

~$ mkdir eb-nodejs
~$ cd eb-nodejs

Depois, crie uma aplicação a ser implantada usando o Elastic Beanstalk. Vamos criar um serviço Web RESTful "Hello World".

exemplo~/eb- .js nodejs/server
const http = require('node:http');

const hostname = '127.0.0.1';
const port = 8080;

const server = http.createServer((req, res) => {
  res.statusCode = 200;
  res.setHeader('Content-Type', 'text/plain');
  res.end('Hello Elastic Beanstalk!\n');
});

server.listen(port, hostname, () => {
  console.log(`Server running at http://${hostname}:${port}/`);
});

Esta aplicação abre um receptor na porta 8080. O Elastic Beanstalk encaminha solicitações para seu aplicativo na porta 8080 por padrão para. Node.js

Etapa 2: executar a aplicação localmente

Execute o seguinte comando para executar sua aplicação localmente.

~/eb-nodejs$ node server.js

Você deverá ver o seguinte texto.

Server running at http://127.0.0.1:8080/

Insira o endereço URL http://127.0.0.1:8080/ no navegador. O navegador deve exibir “Hello Elastic Beanstalk!”.

Etapa 3: implantar seu Node.js aplicativo com o EB CLI

Execute os seguintes comandos para criar um ambiente Elastic Beanstalk para essa aplicação.

Para criar um ambiente e implantar seu Node.js aplicativo

  1. Inicialize o repositório da EB CLI com o comando eb init:

    ~/eb-nodejs$ eb init -p node.js nodejs-tutorial --region us-east-2

    Esse comando cria um aplicativo chamado nodejs-tutorial e configura seu repositório local para criar ambientes com a versão mais recente da Node.js plataforma.

  2. (Opcional) Execute eb init novamente para configurar um par de chaves padrão para que você possa usar SSH para se conectar à instância do EC2 que está executando seu aplicativo:

    ~/eb-nodejs$ eb init
Do you want to set up SSH for your instances?
(y/n): y
Select a keypair.
1) my-keypair
2) [ Create new KeyPair ]

    Selecione um par de chaves se você já tiver um, ou siga os as instruções na tela para criar um. Se nenhum prompt aparecer ou se for necessário alterar as configurações posteriormente, execute eb init -i.

  3. Crie um ambiente e implante o aplicativo nele com eb create. O Elastic Beanstalk cria automaticamente um arquivo zip para sua aplicação e o implanta em uma instância do EC2 no ambiente. Após implantar sua aplicação, o Elastic Beanstalk o inicia na porta 8080.

    ~/eb-nodejs$ eb create nodejs-env

    O Elastic Beanstalk leva cerca de cinco minutos para criar seu ambiente.

Etapa 4: executar a aplicação no Elastic Beanstalk

Quando o processo de criação de seu ambiente for concluído, abra seu site com eb open.

~/eb-nodejs$ eb open

Parabéns! Você implantou um Node.js aplicativo com o Elastic Beanstalk! Isso abre uma janela do navegador usando o nome de domínio criado para o seu aplicativo.

Etapa 5: limpar

Você pode encerrar o ambiente quando terminar de trabalhar com a aplicação. O Elastic Beanstalk AWS encerra todos os recursos associados ao seu ambiente.

Para encerrar seu ambiente do Elastic Beanstalk com a CLI do EB, execute o seguinte comando.

~/eb-nodejs$ eb terminate

AWS recursos para seu aplicativo

Você acabou de criar uma aplicação de instância única. Ela serve como uma aplicação de exemplo simples com uma única instância do EC2 e, portanto, não requer balanceamento de carga ou ajuste de escala automático. Para aplicativos de instância única, o Elastic Beanstalk cria os seguintes recursos: AWS

  • Instância do EC2: uma máquina virtual do Amazon EC2 configurada para executar aplicações Web na plataforma de sua escolha.

    Cada plataforma executa um conjunto diferente de software, arquivos de configuração e scripts para oferecer suporte a uma versão de linguagem, framework, contêiner da Web específicos ou a uma combinação deles. A maioria das plataformas usa o Apache ou nginx como um proxy reverso que processa tráfego da web na frente do aplicativo web, encaminha solicitações para ele, atende ativos estáticos e gera logs de acesso e de erro.

  • Grupo de segurança de instância: um grupo de segurança do Amazon EC2 configurado para permitir tráfego de entrada na porta 80. Esse recurso permite que o tráfego HTTP do load balancer chegue à instância do EC2 que executa seu aplicativo Web. Por padrão, o tráfego não é permitido em outras portas.

  • Bucket do Amazon S3: um local de armazenamento do seu código-fonte, logs e outros artefatos criados quando o Elastic Beanstalk é utilizado.

  • CloudWatch Alarmes da Amazon — Dois CloudWatch alarmes que monitoram a carga nas instâncias em seu ambiente e são acionados se a carga for muito alta ou muito baixa. Quando um alarme é acionado, o seu grupo de Auto Scaling pode aumentar ou diminuir.

  • CloudFormation stack — O Elastic CloudFormation Beanstalk usa para lançar os recursos em seu ambiente e propagar as alterações de configuração. Os recursos são definidos em um modelo que você pode visualizar no console do CloudFormation.

  • Nome de domínio — Um nome de domínio que é direcionado para seu aplicativo da web no formulário subdomain. region.elasticbeanstalk.com.

O Elastic Beanstalk gerencia todos esses recursos. Quando você encerra o ambiente, o Elastic Beanstalk encerra todos os recursos dele.

Próximas etapas

Depois que um ambiente estiver executando um aplicativo, você poderá implantar uma nova versão do aplicativo ou um aplicativo diferente a qualquer momento. A implantação de uma nova versão do aplicativo é muito rápida, pois não é necessário provisionar ou reiniciar as instâncias do EC2. Também é possível explorar o novo ambiente usando o console do Elastic Beanstalk. Para conhecer as etapas detalhadas, consulte Explore seu ambiente, no capítulo Primeiros passos deste guia.

Explore mais tutoriais

Se quiser experimentar outros tutoriais com diferentes aplicações de exemplo, consulte Mais aplicações de exemplo e tutoriais do Elastic Beanstalk para Node.js.

Depois de implantar um ou dois aplicativos de amostra e estar pronto para começar a desenvolver e executar Node.js aplicativos localmente, consulteConfigurar seu ambiente de desenvolvimento Node.js para o Elastic Beanstalk.

Implantar com o console do Elastic Beanstalk

Você também pode usar o console do Elastic Beanstalk para iniciar a aplicação de exemplo. Para conhecer as etapas detalhadas, consulte Criar uma aplicação de exemplo, no capítulo Primeiros passos deste guia.