Skip to content

1. How to install frontend Aero-Webb on Ubuntu WSL

Cette note décrit la mise en œuvre du frontend Aero-Webb dans une distribution Ubuntu tournant sous WSL.

Prerequisites

1.1 Mise en œuvre

1.1.1 Récupérer des sources d'Aero-Webb

Pour récupérer une copie locale des sources du dépôt frontend_aerowebb, exécuter les commandes suivantes dans un terminal WSL :

cd ~/Workspaces/Aero-Webb/Frontend/
git clone https://innersource.soprasteria.com/2moro/aero-webb/frontend_aerowebb.git

1.1.2 Récupération des sources d'une version spécifique d'Aero-Webb

Pour récupérer une branche spécifique du dépôt frontend_aerowebb, exécuter les commandes suivantes dans un terminal WSL :

cd ~/Workspaces/Aero-Webb/Frontend/frontend_aerowebb
git fetch https://innersource.soprasteria.com/2moro/aero-webb/frontend_aerowebb.git version/7.6.0-SNAPSHOT:version/7.6.0-SNAPSHOT
git checkout --track version/7.6.0-SNAPSHOT

Une fois le checkout réalisé vous pouvez vérifier que git est positionné sur la bonne branche à l'aide de la commande git branch

Dans l'exemple ci-dessus, la branche récupérée est version/7.6.0-SNAPSHOT, adaptez le nom de la branche au besoin.

Le dépôt front_aerowebb est hébergé à l'adresse : [[https://innersource.soprasteria.com/2moro/aero-webb/frontend_aerowebb]]

1.1.3 Installer l'application

cd ~/Workspaces/Aero-Webb/Frontend/frontend_aerowebb
npm install

1.1.4 Lancer l'application en mode développement

cd ~/Workspaces/Aero-Webb/Frontend/frontend_aerowebb
npm run start

Rechargement automatique En mode développement l'application est rechargée automatiquement dans le navigateur lorsqu'une modification intervient dans le code source.

1.1.5 Vérifier que l'application fonctionne

Un fois l'application lancée en mode développement, pour vérifier que tout fonctionne il suffit d'ouvrir un navigateur à l'adresse [[http://localhost:4200/]].

L'écran d'authentification de l'application doit s'afficher :

Ecran authentification Aero-Webb

Identifiants de connexion Les identifiants de connexion à l'interface de l'application sont les suivants :

  • Identifiant : admin
  • Mot de passe : initial

Keycloak

Lorsque le système d'authentification Keycloak est installé sur le système, l'interface de connexion diffère légèrement. Il suffit dans ce cas de cliquer sur le bouton Connexion avec Open ID proposé par l'interface, puis de saisir les identifiants.

Une fois authentifié, l'écran d'accueil d'Aero-Webb s'affiche :

Ecran accueil Aero-Webb

1.2 Construction

La construction (build) permet d'avoir une version livrable du frontend du produit.

Pour réaliser la construction, exécuter les commandes suivantes dans un terminal WSL :

cd ~/Workspaces/Aero-Webb/Frontend/frontend_aerowebb
npm run build-aot

Les artefacts de construction sont stockés dans le dossier dist/


Last update: 2025-03-03
Created: 2024-01-30