Gitlab - 4.1 Création d’une application NodeJs

Nous allons maintenant en apprendre davantage sur les artefacts dans GitLab. Pour cela, partons directement d'un exemple concret avec un nouveau projet baptisé artefact-demo que vous savez déjà créer. Clonez-le en HTTPS sur votre poste, basculez sur la branche dev et ouvrez le projet dans Visual Studio Code. Cette fois, nous allons créer une application Node.js très basique pour servir de support à notre pipeline.

Node.js, npm et Express

Node.js est un environnement d'exécution JavaScript open source et multiplateforme qui permet d'exécuter du code JavaScript en dehors d'un navigateur. Il est principalement utilisé pour développer des applications côté serveur et réseau qui nécessitent une connexion persistante, comme les applications de chat, les flux d'actualités ou les notifications web. npm (Node Package Manager) est le gestionnaire de paquets par défaut de Node.js : il permet d'installer des bibliothèques, plugins et frameworks tiers en ligne de commande, par exemple via npm install express.

Créons un fichier index.js et collons-y le code de l'application. Celle-ci utilise le framework Express, le standard pour créer des serveurs web Node.js. La première ligne déclare une variable express qui contient le module Express via require. Une variable app reçoit ensuite l'instance Express. Une variable port définit le numéro de port (80). Le bloc suivant définit les endpoints : sur une requête GET, l'application renvoie un message en réponse. Enfin, la méthode listen démarre le serveur sur le port défini.

  • index.js : code applicatif avec Express et endpoint GET
  • package.json : métadonnées et liste des dépendances
  • apt install nodejs : installation de Node
  • apt install npm : installation de npm
  • npm install : installation des dépendances du projet
  • node index.js : exécution de l'application

Notre application nécessite Express comme dépendance. Pour la gérer, on crée un fichier package.json à la racine du projet : ce fichier contient toutes les métadonnées (version, scripts, dépendances). On y déclare express avec sa version minimale. Si vous avez plusieurs dépendances, listez-les ici. Sauvegardez les deux fichiers index.js et package.json.

Exécutons maintenant l'application localement pour comprendre les commandes à écrire dans notre futur pipeline. On installe d'abord Node.js avec apt install nodejs. Premier essai de node index.js : erreur, le module Express est introuvable. Solution : npm install qui lit package.json et installe automatiquement les dépendances dans node_modules. Mais npm n'est pas encore installé : apt install npm, puis npm install. Enfin, node index.js démarre le serveur sur http://localhost:80 : on ouvre le lien et le message de succès s'affiche. Il ne reste plus qu'à pousser ce projet vers GitLab et à écrire le pipeline .gitlab-ci.yml.

En résumé

Cette leçon enseigne comment créer une application Node.js basique en utilisant le framework Express. Elle explique d'abord les concepts fondamentaux de Node.js (un environnement d'exécution JavaScript multiplateforme permettant d'exécuter du code en dehors d'un navigateur) et NPM (Node Package Manager), gestionnaire de packages par défaut. La leçon présente ensuite un exemple pratique : création d'un fichier index.js avec Express, définition des dépendances dans package.json, et exécution locale de l'application pour identifier les dépendances manquantes.

Points clés

  • Node.js est un environnement d'exécution JavaScript multiplateforme open source utilisé pour les applications côté serveur et les applications en temps réel (chat, notifications, flux d'actualité)
  • NPM (Node Package Manager) permet d'installer des bibliothèques, plugins et frameworks tierces via la ligne de commande
  • Express est un framework web standard pour Node.js qui permet de gérer les requêtes HTTP et renvoyer des réponses
  • Le fichier package.json est obligatoire dans tout projet Node.js pour déclarer et gérer les dépendances du projet
  • La structure minimale d'une application Express inclut : déclaration du module express, création d'une instance app, définition d'un port, et démarrage du serveur avec la méthode listen()
  • L'installation des dépendances se fait avec la commande 'npm install' qui lit automatiquement le fichier package.json sans avoir à spécifier le nom du fichier

Questions fréquentes

Pourquoi Node.js est-il utilisé pour les applications en temps réel ?

Node.js nécessite une connexion persistante entre le navigateur et le serveur, ce qui le rend idéal pour les applications comme le chat, les flux d'actualité et les notifications qui demandent des mises à jour instantanées.

Comment installer une dépendance comme Express dans un projet Node.js ?

Après avoir ajouté la dépendance dans le fichier package.json (par exemple 'express: "^4.x"'), il suffit d'exécuter la commande 'npm install' qui lit automatiquement le fichier et installe tous les packages listés.

Que contient le fichier package.json et pourquoi est-il essentiel ?

Le fichier package.json contient toutes les métadonnées du projet, notamment les dépendances NPM, les scripts, la version et d'autres configurations. Il est obligatoire dans tout projet Node.js pour gérer et documenter les dépendances du projet.