esup-multi

Arborescence des pages

Comparaison des versions

Ancienne version 64

changes.mady.by.user Antoine Contoux

Sauvegardée le

comparé à

Nouvelle version 65

changes.mady.by.user Antoine Contoux

Sauvegardée le

Légende

  • Ces lignes ont été ajoutées. Ce mot a été ajouté.
  • Ces lignes ont été supprimées. Ce mot a été supprimé.
  • La mise en forme a été modifiée.
Commentaire: maj installation back avec wordpress

...

Cloner les sources disponibles sous gitHub GitHub https://github.com/univlorraine/esup-multi

Bloc de code
git clone git@githubhttps://github.com:/univlorraine/esup-multi.git

...

Le CMS HeadLess va permettre de fournir du contenu dynamique au client mobile.

Plusieurs CMS sont possibles, celui par défaut est Wordpress.

Développer
titleInstallation QuickStart avec le CMS Directus (obsolète à partir de la version 1.2.0 d'Esup-multi)

Installation

Le CMS se lance avec Docker. Par défaut, la configuration proposée utilise MySQL

  1. Se rendre dans le dossier env/local/docker/directus, le déploiement est décrit dans le fichier docker-compose.yml
  2. Lancer Directus :
    Bloc de code
    languagebash
    $ docker compose up --build -d
  3. Le CMS sera accessible sur http://localhost:8055, connectez-vous avec les identifiants renseignés plus tôt (ADMIN_EMAIL et ADMIN_PASSWORD).
  4. Dans Settings > Project Settings, passez le CMS en français (optionnel, mais les explications suivantes se font avec l'interface en français).

Import

  1. Pour importer les collections :
    Bloc de code
    languagebash
    $ docker compose exec directus npx directus schema apply --yes ./snapshot/snapshot.yaml
  2. Redémarrez le conteneur Docker de Directus pour que l'import soit bien pris en compte.
  3. Dans Réglages > Modèles de données, pour la collection Languages, sélectionnez Voir le contenu.
  4. Sélectionnez le fichier des langues (languages.json) et importez-le.
  5. Pour chaque collection visible dans le panneau latéral (dans l'onglet Contenu), importez le contenu.
  6. Saisir les informations demandées dans Contact US et Login (pour plus d'explications, consultez la page suivante) 

Permissions

  1. Dans Réglages > Rôles et autorisations > Role Administrator > Membres avec ce rôle > Nouveau
  2. Indiquer uniquement un nom pour ce nouvel utilisateur 
  3. Générez un token pour cet utilisateur (on ne peut pas créer de token pour Admin User cela provoque une erreur à l'enregistrement du rôle)
  4. Gardez-le, vous en aurez besoin pour la configuration du backend.

Image Modified

pour plus d'explication consultez la page suivante 

Le Backend

Le backend doit disposer des briques suivantes (Voir l'installation des pré-requis) : 

  • Une base MongoDB 
  • Un serveur Nats
  • Une base Redis
  • Instance de Directus (cf. section Le CMS Headless)

Configuration des variables d'environnement

Esup-Multi s'accompagne d'un serveur de mocks visant à simuler les connecteurs qui devront être branchés sur le SI de l'établissement. Esup-multi est donc pré-paramétré pour fonctionner avec ces mocks et les paramètres par défaut des services à installer en pré-requis.

Dans dev/user-backend-nest copier et renommer chaque fichier .env.dist en .env pour :

  • la gateway dans /main
  • chaque µService dans /microservices/*

Dans chaque µService utilisant directus positionner la variable <MICRO_SERVICE_NAME>_DIRECTUS_API_BEARER_TOKEN avec le token obtenu pour le user directus (cf paragraphe précédent) dans le fichier .env

Exemple :


Installation du CMS

Pour la mise en place de WordPress, se référer à la documentation suivante : Installer et configurer Wordpress

Notes :

  • Le fichier docker-compose.yml est dans env/local/docker/wordpress
  • Pour se connecter, les identifiants par défaut sont :
    • Identifiant : admin
    • Mot de passe : password

Installation du connecteur CMS

Le choix du CMS n'étant pas imposé, un connecteur est nécessaire pour le relier au reste du projet.

Le code source du connecteur est fourni dans le projet Esup-Multi, au niveau de l'arborescence dev/connectors/multi-cms-connector

Commencez par installer les dépendances du connecteur : npm ci 

Pour plus d'informations sur l'installation et la configuration du connecteur, se référer à la documentation suivante : Connecteur CMS Headless

Pour lancer le connecteur : npm start 

Le Backend

Le backend doit disposer des briques suivantes (Voir l'installation des pré-requis) : 

  • Une base MongoDB 
  • Un serveur Nats
  • Une base Redis
  • Un CMS
  • Connecteur CMS

Configuration des variables d'environnement

Dans dev/user-backend-nest copier et renommer chaque fichier .env.dist en .env pour :

  • la gateway dans /main
  • chaque µService dans /microservices/*

Dans chaque µService utilisant le CMS positionner la variable <MICRO_SERVICE_NAME>_SERVICE_CMS_CONNECTOR_API_BEARER_TOKEN  avec le token généré précédemment (voir Connecteur CMS Headless) dans le fichier .env, ainsi que l'URL du connecteur CMS sur la variable <MICRO_SERVICE_NAME>_SERVICE_CMS_CONNECTOR_API_URL .

Exemple :

Bloc de code
SOCIAL_NETWORK_SERVICE_CMS_CONNECTOR_API_URL=http://localhost:4000
SOCIAL_NETWORK_SERVICE_CMS_CONNECTOR
Bloc de code
SOCIAL_NETWORK_SERVICE_DIRECTUS_API_BEARER_TOKEN=azertyqsdfg123456

Dans renseigner Renseigner dans /main/.env et dans /microservices/auth/.env un secret pour les JWT dans la variable  AUTH_SERVICE_JWT_SECRET

...

L'application multi est fournie avec un serveur de mock. Il s'agit d'API qui renvoient des données statiques qui vous permettent d'émuler ce que retourneraient des connecteurs branchés sur votre système d'information. Esup-multi est donc pré-paramétré pour fonctionner avec ces mocks et les paramètres par défaut des services à installer en prérequis.

L'URL de chaque mock est précisée par défaut dans le fichier .env du microservice sous la forme :

...