Wishurgift Serveur

Serveur de l'application Wishurgift, dans le cadre du projet du second semestre de l'année 2019-2020 du M2 ILI à l'université d'Artois.

Les membres du groupe sont :

Arthur Brandao
Maxence Bacquet
Ouahab Fenniche
Aymeric Vandewoorde

Prérequis

Pour pouvoir compiler et lancer le serveur depuis les sources les logiciels suivants sont nécessaire :

Java (testé avec la version 13 d'Oracle et l'Open JDK 11, doit normalement fonctionner avec la version 8)
Docker (testé avec la version 18.09.7)
Docker-compose (testé avec la version 1.25.1 et 1.17.1)
Maven (testé avec la version 3.6.0)

Pour information le serveur et son installation on été testé sur les OS suivant : KDE Neon 5.17 et Ubuntu 18.04.4 LTS, tous deux basé sur Debian 10 (Buster)

Installation & Utilisation

Pour gérer le serveur des scripts bash ont été écrit, l'explication pour lancer le serveur seras donné avec et sans l'utilisation des scripts. L'utilité des différents scripts est expliquer à la fin de cette partie. De plus les commandes données sont toutes lancées depuis le dossier racine du serveur.

Avec les scripts

Pour un 1er lancement il est conseillé d'utiliser run plutot que start (pour voir ce qui ce passe), mais les deux fonctionnent. La différence est décrite plus bas dans la section sur les scripts.

# Lance les dockers
./script/run.sh

# Compile et deploie le serveur
mvn package

:warning: Le docker de base de données doit absolument être lancé lors de la compilation et du déploiement du war. Si la base de données n'est pas accessible le maven package va échouer. Ceci est provoqué par la vérification (et la mise à jour) de la base de données si besoins.

Normalement après ces étapes le serveur est disponible à l'adresse http://localhost:8080

Sans les scripts

# Création du dossier pour copier le war
mkdir ./web/apps

# Lancement des dockers
docker-compose up

# Compile et deploie le serveur
mvn package

La création du dossier apps n'est pas obligatoire, il seras de toute façon créer par le docker. Cependant en laissant le docker créer le dossier il possible que maven n'arrive pas à copier le war dedans (problème de droit), le créer avant de lancer le docker évite ce problème. De plus la remarque sur le docker de base de données (dans Avec les scripts) est toujours valable.

Normallement après ces étapes le serveur est disponible à l'adresse http://localhost:8080

Autres informations

Pour installer une nouvelle version de l'application à partir des sources quand une 1er installation à déjà eu lieu, il suffit de lancer un mvn package alors que les dockers sont lancés. Le nouveau war va automatiquement être deployé à la place de l'ancien.

Il se peut parfois que le redeployement à chaud de Tomee entraine l'apparition de bugs (comme le fait qu'il ne trouve plus les class de PostgreSQL). Dans ce cas il suffit de couper et relancer les dockers pour résoudre les problèmes.

Les scripts

Voici les différents scripts présent dans le projet, ce sont tous des scripts shell :

clear-docker : Reset docker
connect-db : Connexion à la base de données avec le client CLI postgres (doit être installé sur la machine)
init : Création des dossiers manquants pour l'application
postgres-cli : Connexion en mode CLI au docker PostgreSQL (le docker doit être lancé)
run : Initialise (voir init) et lance les dockers (docker-compose up)
server : Connexion SSH au serveur utilisé par l'application mobile
start : Initialise (voir init) et lance les dockers (docker-compose up) en tache de fond
stop : Stop les dockers (docker-compose stop)
tomee-cli : Connexion en mode CLI au docker Tomee (le docker doit être lancé)

Technologies

Voici les principales technologies et framework utilisé dans le projet :

Jave 8 : Langage de programmation
Maven : Outil de gestion et d'automatisation de production des projets logiciels Java
Docker & Docker-compose : Lanceur d'applications dans des conteneurs logiciels
Postgres 12.1 : SGBD
Liquibase : Suivi, gestion et application des changements de schéma de base de données indépendament du SGBD
OpenJPA : Implementation JPA (ORM)
JUnit 4 : Test unitaire en Java
Mockito : Framework pour les tests unitaires
Lombok : Simplification du code
JWT : Token pour l'authentification
Gitlab CI : Intégration continue
Tomee + : Serveur d'application
Bcrypt : Hash des mots de passe

Documenation

Les informations sur le fonctionnement et l'utilisation de l'API du serveur sont trouvable dans le dossier /doc du projet.

De plus quelques informations pour la configuration et la gestion du projet pour les développeur sont trouvable dans le fichier /doc/dev.md.

Autre projet Wishurgift

Voici la liste des differents projets Wishurgift :

readme.md 5.0 KB Vēsture Neapstrādāts