Commit ecfd3b1d authored by Bertrand Gauthier's avatar Bertrand Gauthier
Browse files

Mise à jour et amélioration des doc et scripts d'install.

parent c8b80ed6
Loading
Loading
Loading
Loading
Loading
+1 −1
Original line number Diff line number Diff line
@@ -5,7 +5,7 @@ Journal des modifications
-----
- Module Step-Star > Ligne de commande : améliorations des logs (affichage des critères appliqués, notamment) ; factorisation.
- Module Step-Star : suppression du paramètre de config 'clean_after_work', remplacé par un paramètre de ligne de commande ou de formulaire.
- Documentation : amélioration de la doc d'installation.
- Documentation : mise à jour et amélioration des script et doc d'installation.
- [FIX] Génération de la PDC : suppression de la mention 'Co-encadrant' ou 'Co-encadrante' en trop dans le tableau du jury.

8.2.0
+5 −5
Original line number Diff line number Diff line
###########################################################################################
#########################################################################################################
#
#                         Image Docker pour l'application SyGAL
#           traduite en script sh, pour configurer manuellement un serveur Debian
#
# Pré-requis :
#   - Copier le répertoire local ./docker dans le répertoire /tmp du serveur cible, ex
#     scp -r ./docker root@ksygal.univ.fr:/tmp/
#   - Etre root.
#   - Etre root sur le serveur
#   - Avoir récupéré les sources de l'application et être positionné dans leur répertoire
#   - Copier le répertoire ./docker dans le répertoire /tmp du serveur : cp -r ./docker /tmp/
#
###########################################################################################
#########################################################################################################

#FROM debian:bullseye AS distrib

+27 −7
Original line number Diff line number Diff line
@@ -132,16 +132,16 @@ Si vous êtes sur un serveur de PROD, corrigez les lignes suivantes du fichier d

Placez-vous dans le répertoire de l'application puis descendez dans le répertoire `config/autoload/`.

Supprimez l'extension `.dist` des fichiers suivants, et préfixez-les pour bien
signifier l'environnement de fonctionnement concerné (version de production, de test, de developement) :
Supprimez l'extension `.dist` des fichiers suivants, et préfixez-les par `prod.`, `test.` ou `dev.` pour bien signifier 
l'environnement de fonctionnement effectif :
  - [`local.php.dist`](../config/autoload/local.php.dist)
  - [`secret.local.php.dist`](../config/autoload/secret.local.php.dist)

Exemple :
```bash
APPLICATION_ENV="production"
cp -n local.php.dist        ${APPLICATION_ENV}.local.php 
cp -n secret.local.php.dist ${APPLICATION_ENV}.secret.local.php
APPLICATION_ENV="prod"
cp local.php.dist        ${APPLICATION_ENV}.local.php
cp secret.local.php.dist ${APPLICATION_ENV}.secret.local.php
```

Dans la suite, vous allez adapter le contenu de ces fichiers à votre situation.
@@ -177,6 +177,9 @@ Dans la suite, vous allez adapter le contenu de ces fichiers à votre situation.
```
*NB : ensuite créez le fichier `public/logo-etablissement.png` correspondant au logo de votre établissement.*


#### Fichier `${APPLICATION_ENV}.secret.local.php`

- Adaptez le chemin du répertoire où seront stockés les fichiers uploadés par les utilisateurs de l'application :

```php
@@ -192,8 +195,6 @@ Dans la suite, vous allez adapter le contenu de ces fichiers à votre situation.
```
*NB : ce répertoire doit être autorisé en écriture à l'utilisateur `www-data`.*

#### Fichier `${APPLICATION_ENV}.secret.local.php`

- Renseignez les infos de connexion à la base de données de l'application :

```php
@@ -228,6 +229,25 @@ Dans la suite, vous allez adapter le contenu de ces fichiers à votre situation.
```


### Accès à l'API exposée par l'application

ESUP-SyGAL expose une API permettant d'obtenir de Pégase les inscriptions en 3e cycle.
Un fichier `users.htpasswd` contient les comptes utilisateurs / mots de passe autorisés à interroger cette API
au regard de l'authentification HTTP Basic.

Placez-vous dans le répertoire [`config`](config) des sources et lancez la
commande suivante pour créer le fichier `users.htpasswd` contenant un utilisateur `sygal-app` dont le mot de passe
vous sera demandé :
```bash
htpasswd -c users.htpasswd sygal-app
```

Si vous manquez d'idée pour le mot de passe, utilsez la commande suivante :
```bash
pwgen 16 1 --symbols --secure
```


## Script d'install des dépendances et d'init de l'application

Lancez le script suivant :
+22 −7

File changed.

Preview size limit exceeded, changes collapsed.

+20 −0
Original line number Diff line number Diff line
# Version 8.3.0

## 1. Sur le serveur d'application

- Placez-vous dans le répertoire de l'application puis lancez la commande suivante
  pour installer la nouvelle version :

  ```bash
  git fetch --tags && git checkout --force 8.3.0 && bash ./install.sh
  ```

- Rechargez le moteur PHP, exemple :

  ```bash
  systemctl reload php8.0-fpm
  ```

## 2. Dans la base de données

RAS.
 No newline at end of file