installation et configuration du projet

dependences requises :

• Git
• Docker Desktop
• assurez vous que la virtualisation est bien activée dans votre BIOS

dependences supplémentaires pour Windows

• WSL2

Sur Windows :

1. Exécutez la commande suivante dans PowerShell en tant qu'administrateur wsl --install et redémarrez votre ordinateur. Assurez vous que les fonctionnalités suivantes ont bien été installées(dans menu démarrer : fonctionnalités).

• Plateforme de virtualisation Windows (Virtual Machine Platform)
• Sous système linux pour Windows (Windows Subsystem for Linux) (WLS)

2. installer une distribution linux en utilisant la commande wsl --install [Distro] où [Distro] en est le nom (debian est recommandé). Pour voir toute les distributions disponibles entrez : wsl --list --online.
3. configurez la distribution linux que vous avez choisi avec un utilisateur et mettez la distribution à jour.

Installation de Docker Desktop

1. (WINDOWS) Téléchargez et installez le logiciel depuis le site officiel Docker website ou utilisez winget (Windows Package Manager) avec PowerShell winget install Docker.DockerDesktop.

2. (AUTRE) Téléchargez et installez le logiciel depuis le site officiel Docker website ou utilisez votre gestionnaire de packet.

3. (WINDOWS) Sur l'écran d'acceuil dans les paramètres, assurez vous de selectionner WSL 2 plutot que Hyper-V

4. quand vous démarrez Docker pour la première fois, acceptez les conditions d'utilisation. Vous n'avez pas besoin d'utiliser un compte (appuyez sur skip), travailler en local est suffisant.

5. Docker s'initialisera. Cela peut prendre un moment lors du premier lancement.

Installation de Git

Trivial

Configuration du projet

1. Clonez le repo: git clone https://github.com/Aonfu/WE4A.git et ouvrez le dans votre éditeur préféré
2. Copié le fichier de variable d'environnement .env.example sur un .env que vous créez et remplissez le avec vos propres valeurs

Caution

ce fichier est strictement personnel et ne doit JAMAIS être publié sur GitHub

3. Démarrez les conteneurs en exécutant la commande suivante depuis le dossier du projet docker compose up --build -d. Cela peut prendre un certain temps la première fois.

Tip

pour les prochaines fois --build ne sera pas necessaire, il sert à utiliser le fichier Dockefile pour installer les dépendances php. Pour les prochains lancement préférez docker compose up -d [!TIP] Une fois la première commande lancée, vos conteneurs serons démarables depuis votre application Docker Desktop. Vous n'êtes donc pas obligé d'utiliser les commandes docker

Database Link Configuration

1. Dans le panneau de droite, cliquez sur l'icône Database
2. Cliquez sur l'icone + et selectionnez MySQL
3. mettez host à localhost, port à 3306, et fournissez les données de login ainsi que le nom de la base de données
4. Installez les drivers si proposés
5. Testez la connexion et sauvegardez
6. Dans Phpmyadmin, appliquez successivement les migrations sotckées dans database/migrations/ via la catégorie "importer"

Angular et node app.js

Angular

dans un terminal

npm install 
ng serve --proxy-config proxy.conf.json

Node app.js

créez un autre fichier .env dans backend-node comme ceci :

MONGODB_URI=votre_URL_mongo_db

dans un autre terminal

cd backend-node
npm install 
node app.js