Docs

Applications frontend

À quoi sert cet écran

Frontend Apps déploie et suit spécifiquement les composants frontend — les sites statiques et applications monopage qui n’entrent pas dans le même moule qu’un déploiement de service. Il vous donne un tableau de bord de ce qui est déployé, de ce qui est en cours et de ce qui a échoué.

Avant de commencer

Pour faire ceci Il vous faut
Ouvrir la zone la permission d’accès Frontend Deployer (frontendDeployerAccessPermission)

Vos composants doivent exister dans le catalogue — voir Settings › Development › Projects.

Ouvrir l’écran

  1. Deploy › Frontend Apps dans la barre latérale.
Route Écran
/frontend-deployer Tableau de bord
/frontend-deployer/component/:id Une application
/frontend-deployer/settings Réglages

Un onglet Frontend Deployer existe aussi sur les entités du catalogue, pour un composant donné.

L’interface

📸 Capture d’écran : Le tableau de bord Frontend Apps. Repères : (1) les cartes de statistiques, (2) le filtre Filter by System, (3) la liste des composants, (4) l’icône de réglages.

# Élément Ce qu’il fait Quand l’utiliser
1 Cartes — Components, Deployed, In progress, Failed L’état d’ensemble d’un coup d’œil À l’ouverture de la page
2 Filter by System Restreint à un système Installations à nombreux frontends
3 Liste des composants Chaque application et son état Retrouver l’une d’elles
4 Réglages Valeurs par défaut de déploiement et rétention Mise en place, puis ajustements

Lisez les cartes comme un ensemble. Failed stagnant à une valeur non nulle pendant que Deployed augmente est le schéma à repérer : cela signifie que l’on contourne les échecs au lieu de les corriger.

Réglages

Réglage Ce qu’il contrôle
Deployment history (days) Durée de conservation de l’historique de déploiement
Poll interval (seconds) Fréquence de rafraîchissement du statut
Default pipeline mode Le mode dans lequel démarrent les nouveaux déploiements
Default deploy template Le modèle utilisé pour déployer
Default rollback template Le modèle utilisé pour revenir en arrière
Shared parameters Paramètres appliqués à tous les déploiements

Renseigner le modèle de retour arrière en même temps que celui de déploiement est la partie que l’on repousse. Vous voudrez l’avoir configuré avant d’en avoir besoin, pas pendant.

Procédures

Déployer une application frontend

  1. Deploy › Frontend Apps.
  2. Trouvez le composant, en utilisant Filter by System si la liste est longue.
  3. Déployez-le.
  4. Suivez le passage par In progress. La page se rafraîchit selon l’intervalle défini dans les réglages.

Enquêter sur un échec

  1. Depuis le tableau de bord, ouvrez le composant en échec.
  2. Lisez son historique de déploiement — sa durée de conservation est un réglage, un échec ancien peut donc simplement avoir été purgé.

Configurer les valeurs par défaut

  1. Deploy › Frontend Apps › Settings.
  2. Renseignez les modèles de déploiement et de retour arrière, le mode de pipeline et les paramètres partagés éventuels.
  3. Réglez la rétention et l’intervalle d’interrogation selon votre façon de travailler.

Scénario

Un déploiement frontend a échoué et personne ne l’a vu pendant deux jours.

  1. Deploy › Frontend Apps — la carte Failed est non nulle. Cette carte constitue tout le dispositif d’alerte précoce, d’où l’intérêt d’ouvrir le tableau de bord même sans signalement.
  2. Filtrez par le système propriétaire pour identifier le composant.
  3. Ouvrez-le et lisez l’historique de déploiement pour savoir quand les échecs ont commencé.
  4. Si l’historique ne remonte pas assez loin, vérifiez Settings › Deployment history (days). Une rétention plus courte que votre boucle de retour masque précisément les échecs que vous cherchez à analyser.
  5. Corrigez le déploiement, puis redéployez.
  6. Vérifiez que la carte Failed revient à zéro. Traitez un compteur Failed durablement non nul comme une vitre brisée : une fois qu’il devient normal, plus personne ne le regarde.

En cas de problème

Symptôme Cause Comment vérifier Solution
Frontend Apps n’est pas dans le sous-menu Il manque la permission d’accès Frontend Deployer Access Explorer Demandez un rôle qui l’accorde
Un composant manque dans la liste Il n’est pas dans le catalogue, ou il est filtré Le filtre Filter by System, puis Projets Retirez le filtre ; enregistrez le composant
Le statut semble lent à se mettre à jour L’intervalle d’interrogation est long Settings › Poll interval Réduisez-le
L’historique de déploiement est plus court que prévu La rétention est un réglage Settings › Deployment history (days) Augmentez-la
Le retour arrière est indisponible Aucun modèle de retour arrière configuré Settings › Default rollback template Configurez-le avant d’en avoir besoin
Le compteur Failed ne revient jamais à zéro Les échecs sont contournés, pas corrigés La liste des composants Traitez-les ; une carte durablement rouge cesse d’être lue

Pour aller plus loin