Go-Testeur - Correction des défis du lundi

Initié par Loïg Jezequel.
Développé par Paul Vernin, Matteo Ordrenneau, Thomas Peray et Antoine Gru.

GitLab : https://gitlab.univ-nantes.fr/E192543L/projet-s3/

Cette application web vise à simplifier le travail nécessaire à la réalisation des défis du lundi proposé aux premières années de l'IUT Informatique de Nantes, dans le module Introduction aux Systèmes Informatiques. Elle est utilisable d'une part par les étudiants de l'IUT mais il y a une partie administrateur pour les enseignants.

1. Installation

Il est nécessaire d'installer le projet dans un environnement ayant Go (1.15.2 recommandé), ainsi que GCC (9.2 recommandé) pour gérer la database SQLite3.

Une fois l'archive téléchargée, placez-vous à la racine. 3 possibilité d'execution sont disponibles :

• "init" : initialise l'application
• "reset" : supprimer les fichiers de ressource et remet la database a l'état initial
• "start" : lance l'application

Pour une première utilisation, il sera nécessaire de réaliser les 3. Exécutez donc ces 3 commandes :

go run main.go init
go run main.go start

Il permettra notamment d'installer les packages externes à Goland.
Par la suite, les exécution future nécessiteront uniquement la commande `go run main.go start`. Pour arrêter l'exécution de l'application, le raccourci Ctrl + C suffit.

Pour générer un nouvel exécutable à mettre sur le serveur, saisissez dans le terminal :

set GOOS=linux && set GOARCH=amd64 (sur windows)
export GOOS=linux && export GOARCH=amd64 (sur mac)
go build

2. Lancer l'application sur le serveur

1) Se connecter au serveur de l'IUT avec Pulse Secure

Pour la suite il est nécessaire de possèder un utilisateur enregistré sur le serveur.

2) Importer le projet

A l'aide de la commande scp, on va importer sur le serveur :

• l'exécutable généré par go build
• le fichier mailConf.json
• le répertoire web

En faisant scp file user@172.26.82.23: (ajouter -R pour le répertoire web)

3) Lancer l'application en continue

Se connecter au serveur avec ssh user@172.26.82.23 dans un terminal
Initialiser l'application avec go run main.go init
Ouvrir un screen en faisant screen , dans celui-ci exécuter l'application en mode root en faisant sudo ./projet-s3 start
Fermer le screen en faisant CTRL + D + A et vous pouvez fermer le terminal sans que cela arrête l'application

3. Utilisation

• Pour une utilisation en local :
  Suite au lancement (go run main.go start), connectez vous à l'adresse : http://localhost:8192
  L'application s'execute sur le port 8192

• Pour une utilisation sur serveur :
  Il faut en premier lieu se connecter au serveur de l'IUT soit en y étant soit avec Pulse Secure
  En suite on peut accéder à l'application par navigateur web à l'adresse : http://172.26.82.23:8192

Par défaut lorsqu'on initialise l'application, un compte admin (login : admin | password : admin) est créé afin de se connecter à l'interface admin du site