Publier un thème de connexion
Faire ajouter et appliquer votre thème dans chaque environnement, suivre sa publication dans la console, le valider sur dev puis le reprendre en prod.
- Accès requis
- Consultation : accès au paramétrage de l'application (Administrateur d'applications, Propriétaire ou droit apps.read)
- Durée
- 15 min
L'ajout d'une version dans la bibliothèque d'un environnement, puis son application dans cet environnement, sont réalisés par l'équipe Wakastart, à votre demande. Chaque environnement a sa propre bibliothèque : la même version est ajoutée séparément en dev, en staging et en prod. Vous suivez la publication dans la console, puis vous validez la page de connexion avant de passer à l'environnement suivant.
Avant de commencer
- Votre thème est prêt : voir Préparer un thème de connexion.
- Il est poussé sur une branche d'un dépôt GitHub de l'application, ou empaqueté dans un fichier
.jar. - Commencez toujours par l'environnement dev.
Demander la publication sur dev
Contactez l'équipe Wakastart en indiquant :
- le WID de votre application ;
- la source : le dépôt et la branche, ou le fichier
.jarjoint ; - l'environnement visé :
dev.
Wakastart ajoute la version dans la bibliothèque Thèmes de l'app de dev, puis l'applique sur dev. Le nom de la version vous est communiqué ; vous le retrouvez dans la console.
Suivre la publication dans la console
Ouvrir la section
Dans la barre latérale, ouvrez Mes Apps, choisissez votre application, puis Paramétrage. Ouvrez l'onglet Thèmes, puis la section Thème Keycloak.
Choisir l'environnement
Tant qu'aucun environnement n'est choisi, la section affiche seulement Choisissez un environnement et rien n'est chargé. Choisissez dev dans le sélecteur Environnement. Le sélecteur reste affiché au-dessus de la section pour changer d'environnement ensuite.
Repérer la version
Dans la liste Thèmes de l'app, qui ne montre que la bibliothèque de l'environnement choisi, retrouvez la nouvelle version. Sa provenance s'affiche à côté du nom : Importé d'un repo avec le dépôt, la branche et le commit, ou Fichier .jar.
Suivre l'environnement
Tant que la publication dure, un bandeau « Publication en cours sur Dev (…) » s'affiche au-dessus de la liste. Cliquez sur Rafraîchir pour mettre à jour l'affichage.
Résultat : le bandeau disparaît quand le thème est appliqué.
Comptez 1 à 3 minutes quand Keycloak doit redémarrer pour charger une nouvelle version.
Tester sur dev
- Ouvrez votre application sur son URL de dev, dans une fenêtre de navigation privée.
- Déclenchez la connexion : la page Keycloak affiche votre thème. Le bandeau de test, si vous en avez ajouté un, indique la version servie.
- Testez aussi le parcours mot de passe oublié : si votre thème contient le type
email, l'e-mail reçu porte votre habillage. - Vérifiez l'affichage sur un téléphone.
Reprendre le thème en staging puis en prod
Il n'existe pas de promotion d'un environnement à l'autre : la version validée sur dev doit être ajoutée dans la bibliothèque de staging, puis de prod, avant d'y être appliquée.
- Demandez à Wakastart de l'ajouter et de l'appliquer en
staging, depuis la même source que pour dev (même dépôt, branche et commit, ou même fichier.jar), en citant le nom exact de la version affiché dans la console. - Dans la section Thème Keycloak, choisissez staging et vérifiez que la version porte le même nom qu'en dev. Le nom dérivant du contenu, un nom identique garantit un contenu identique.
- Testez, puis répétez pour
prod.
Ce que vous avez validé est ainsi ce qui part en production.
Important
Une version appliquée en prod s'affiche pour tous les utilisateurs de tous les réseaux de l'application. Validez-la d'abord sur staging avec quelques utilisateurs de test.
Revenir à une version précédente
- Choisissez l'environnement concerné, puis repérez la version précédente dans la liste Thèmes de l'app. Wakastart conserve au moins les deux versions les plus récentes en plus de celles en service, dans la bibliothèque de chaque environnement.
- Demandez à Wakastart d'appliquer cette version dans cet environnement, en citant son nom. Si elle n'est plus dans la bibliothèque de cet environnement, elle doit d'abord y être ajoutée de nouveau.
Résultat : la page de connexion retrouve l'ancienne apparence, dans le même délai qu'une publication.
Vérifier le résultat
- Aucun bandeau de publication n'est affiché pour l'environnement.
- La page de connexion de l'environnement affiche le thème attendu.