QuickStart: implante um aplicativo Node.js no Elastic Beanstalk

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

Sua AWS conta

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

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

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 subsistema Windows para Linux para obter uma versão do Ubuntu e Bash integrada ao Windows.

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 interface de linha de comando do Elastic Beanstalk e Configurar a EB CLI.

Node.js

Instale o Node.js na máquina local seguindo Como instalar o Node.js no site do Node.js.

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

~$ node -v

Etapa 1: criar uma aplicação Node.js

Crie um diretório do projeto.

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

Depois, crie uma aplicação a ser implantada usando o Elastic Beanstalk. Criaremos um serviço RESTful web “Hello World”.

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 sua aplicação 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 a aplicação Node.js com a EB CLI

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

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 uma aplicação Node.js 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. Ele serve como um aplicativo de amostra simples com uma única EC2 instância, portanto, não requer balanceamento de carga ou escalonamento automático. Para aplicativos de instância única, o Elastic Beanstalk cria os seguintes recursos: AWS

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 porque não exige provisionamento ou reinicialização de instâncias. 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.

Depois de implantar uma ou duas aplicações de exemplo e quando estiver pronto para começar a desenvolver e executar aplicações Node.js localmente, consulte Configurar 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.