Dans la section 5.13 de notre cours en e-book, nous aborderons l'un des sujets les plus importants dans la création d'API dans NodeJS : la création d'un serveur de base et le déploiement et l'hébergement de l'API. Dans ce chapitre, vous apprendrez comment créer un serveur de base dans NodeJS et comment déployer et héberger votre API afin qu'elle soit accessible depuis n'importe où dans le monde.
Créer un serveur basique avec NodeJS
Pour créer un serveur NodeJS de base, nous devons d'abord installer NodeJS et npm, qui est le gestionnaire de packages de Node. Une fois installé, nous pouvons commencer à créer notre serveur. La première étape consiste à créer un nouveau fichier JavaScript. Dans cet exemple, appelons-le « server.js ».
Dans notre fichier 'server.js', commençons par importer le module HTTP NodeJS, qui nous permet de créer des serveurs HTTP. Pour ce faire, nous ajoutons la ligne de code suivante en haut de notre fichier :
const http = exiger('http');
Maintenant, nous pouvons créer notre serveur. Pour cela, nous utilisons la fonction 'createServer' du module HTTP. Cette fonction reçoit un rappel qui est appelé chaque fois qu'une requête est adressée à notre serveur. Le rappel prend deux arguments : un objet de requête, qui contient des informations sur la requête effectuée, et un objet de réponse, que nous utilisons pour envoyer une réponse au client. Voici un exemple de la façon dont nous pouvons créer notre serveur :
const serveur = http.createServer((req, res) => {
res.statusCode = 200 ;
res.setHeader('Content-Type', 'text/plain');
res.end('Bonjour tout le monde\n');
});
Enfin, nous devons faire en sorte que notre serveur commence à écouter les requêtes. Pour cela, nous utilisons la fonction 'écouter' de notre serveur, en passant le port où nous voulons que notre serveur écoute. Par exemple, pour faire écouter notre serveur sur le port 3000, nous ajoutons la ligne de code suivante :
serveur.écouter(3000, () => {
console.log('Serveur exécuté sur http://localhost:3000/');
});
Déploiement et hébergement d'API
Une fois notre serveur de base configuré, l'étape suivante consiste à déployer et à héberger notre API. Il existe plusieurs options pour héberger notre API, comme AWS, Google Cloud, Heroku, entre autres. Dans cet exemple, nous allons utiliser Heroku, qui est une plateforme d'hébergement cloud prenant en charge NodeJS.
Pour déployer notre API sur Heroku, nous devons d'abord créer un compte Heroku et installer la CLI Heroku. Une fois la CLI Heroku installée, nous pouvons utiliser la commande « heroku create » pour créer une nouvelle application sur Heroku. Cette commande crée un nouveau référentiel Git distant que nous pouvons utiliser pour déployer notre API.
Avant de pouvoir déployer notre API, nous devons apporter quelques modifications à notre fichier « server.js ». Tout d’abord, nous devons modifier le port sur lequel notre serveur écoute pour utiliser le port fourni par Heroku. Pour cela, nous modifions la ligne de code où nous appelons la fonction 'écouter' par la suivante :
serveur.écouter(process.env.PORT || 3000, () => {
console.log(`Serveur exécuté sur http://localhost:${process.env.PORT || 3000}/`);
});
Ensuite, nous devons ajouter un fichier appelé « Procfile » à notre projet. Ce fichier indique à Heroku comment démarrer notre application. Pour notre API, le contenu du 'Procfile' doit être le suivant :
Web : nœud serveur.js
Maintenant, nous pouvons déployer notre API. Pour cela, nous utilisons les commandes 'git add', 'git commit' et 'git push' pour ajouter nos modifications au référentiel Git et les transmettre à Heroku. Heroku installe ensuite toutes les dépendances de notre projet et démarre notre application.
Une fois déployée, notre API est accessible à l'URL fournie par Heroku. Pour découvrir cette URL, nous pouvons utiliser la commande 'heroku open'.
C'est ainsi que nous concluons la section 5.13 de notre cours en e-book. Vous savez maintenant comment créer un serveur NodeJS de base et comment déployer et héberger votre API. Dans le chapitre suivant, nous explorerons les fonctionnalités plus avancées de NodeJS et comment nous pouvons les utiliser pour créer des API plus puissantes et plus flexibles.
