# 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.

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](/v1.0/page-de-connexion/preparer-un-theme).
- 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 `.jar` joint ;
- 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

::::steps
### 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

1. Ouvrez votre application sur son URL de dev, dans une fenêtre de navigation privée.
2. 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.
3. Testez aussi le parcours **mot de passe oublié** : si votre thème contient le type `email`, l'e-mail reçu porte votre habillage.
4. 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.

1. 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.
2. 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.
3. 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

1. 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.
2. 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.

## Voir aussi

- [Versions et environnements](/v1.0/page-de-connexion/versions-et-environnements)
- [Résoudre les problèmes de page de connexion](/v1.0/page-de-connexion/depannage)
