QuickStart: Déployer une application Node.js sur Elastic Beanstalk

Ce QuickStart didacticiel explique le processus de création d'une application Node.js et de son déploiement sur un AWS Elastic Beanstalk environnement.

Votre AWS compte

Si vous n'êtes pas déjà AWS client, vous devez créer un AWS . L'inscription vous permet d'accéder à Elastic Beanstalk et à d'autres AWS les services dont vous avez besoin.

Si vous possédez déjà un AWS compte, vous pouvez passer àPrérequis.

Prérequis

Pour suivre les procédures décrites dans ce guide, vous aurez besoin d'un shell ou d'un terminal de ligne de commande pour exécuter des commandes. Dans les listes, les commandes sont précédées d'un symbole d'invite ($) et du nom du répertoire actuel, le cas échéant.

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

Sous Linux et macOS, vous pouvez utiliser le shell et le gestionnaire de package de votre choix. Sur Windows, vous pouvez installer le sous-système Windows pour Linux afin d'obtenir une version intégrée à Windows d'Ubuntu et de Bash.

EB CLI

Ce didacticiel utilise l'interface de ligne de commande (EB) d'Elastic Beanstalk. CLI Pour plus de détails sur l'installation et la configuration de l'EBCLI, reportez-vous Installation de l'interface de ligne de commande Elastic Beanstalk aux sections etConfiguration de l'interface de ligne de commande EB.

Node.js

Installez Node.js sur votre ordinateur local en suivant la procédure d'installation de Node.js sur le site Web Node.js.

Vérifiez votre installation de Node.js en exécutant la commande suivante.

~$ node -v

Étape 1 : Création d'une application Node.js

Créez un répertoire de projet.

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

Créez ensuite une application qui vous allez déployer à l'aide d'Elastic Beanstalk. Nous allons créer un service 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}/`);
});

Cette application ouvre un écouteur sur le port 8080. Elastic Beanstalk transmet les demandes à votre application sur le port 8080 par défaut pour Node.js.

Étape 2 : Exécutez votre application localement

Exécutez la commande suivante pour exécuter votre application localement.

~/eb-nodejs$ node server.js

Vous devriez voir le texte suivant.

Server running at http://127.0.0.1:8080/

Entrez l'URLadresse http://127.0.0.1:8080/ dans votre navigateur Web. Le navigateur doit afficher « Hello Elastic Beanstalk ! ».

Étape 3 : Déployez votre application Node.js avec l'EB CLI

Exécutez les commandes suivantes pour créer un environnement Elastic Beanstalk pour cette application.

Étape 4 : Exécutez votre application sur Elastic Beanstalk

Lorsque le processus de création de votre environnement est terminé, ouvrez votre site Web aveceb open.

~/eb-nodejs$ eb open

Félicitations ! Vous avez déployé une application Node.js avec Elastic Beanstalk ! Celle-ci ouvre une fenêtre de navigation en utilisant le nom de domaine créé pour votre application.

Étape 5 : nettoyer

Vous pouvez mettre fin à votre environnement lorsque vous avez fini d'utiliser votre application. Elastic Beanstalk met fin à tout AWS ressources associées à votre environnement.

Pour mettre fin à votre environnement Elastic Beanstalk avec l'EB, exécutez CLI la commande suivante.

~/eb-nodejs$ eb terminate

AWS ressources pour votre application

Vous venez de créer une application à instance unique. Il s'agit d'un exemple d'application simple avec une seule EC2 instance, il ne nécessite donc pas d'équilibrage de charge ni de dimensionnement automatique. Pour les applications à instance unique, Elastic Beanstalk crée les éléments suivants : AWS ressources :

Elastic Beanstalk gère toutes ces ressources. Lorsque vous arrêtez votre environnement, Elastic Beanstalk arrête toutes les ressources qu'il contient.

Étapes suivantes

Dès que vous disposez d'un environnement exécutant une application, vous pouvez à tout moment déployer une nouvelle version de l'application ou une application totalement différente. Le déploiement d'une nouvelle version d'application est très rapide car il ne nécessite ni le provisionnement ni le redémarrage des instances. EC2 Vous pouvez également explorer votre nouvel environnement à l'aide de la console Elastic Beanstalk. Pour connaître les étapes détaillées, consultez la section Explorez votre environnement dans le chapitre Mise en route de ce guide.

Une fois que vous avez déployé un ou deux exemples d'applications et que vous êtes prêt à commencer à développer et à exécuter des applications Node.js localement, consultezConfiguration de votre environnement de développement Node.js pour Elastic Beanstalk.

Déployez avec la console Elastic Beanstalk

Vous pouvez également utiliser la console Elastic Beanstalk pour lancer l'exemple d'application. Pour connaître les étapes détaillées, voir Création d'un exemple d'application dans le chapitre Mise en route de ce guide.