Docs

Détail d'un environnement

À quoi sert cet écran

Ouvrir un environnement vous amène à sa page de détail — l’écran le plus riche de Fenwave. C’est là que vous découvrez ce que fait réellement une application : ses logs, ses événements, ses métriques, les étapes de son pipeline, ses ressources Kubernetes, ses résultats de tests et ses constats de sécurité, ainsi que les actions exécutables contre elle.

Avant de commencer

Tout ici est contrôlé par le palier auquel appartient l’environnement, selon env-by-branch.<env>.<ressource>.<action> :

Groupe d’onglets Permission typique
Observe env-by-branch.<env>.event.read, .pod.read, .deployment.read
Operate .configmap.write, .deployment.restart, .resource.delete
Test les permissions de lecture du palier

Un onglet que vous ne pouvez pas lire n’est pas affiché. Voir moins d’onglets qu’un collègue relève d’une différence de permissions, pas d’une page cassée.

Ouvrir l’écran

Depuis Dev, Staging ou Production, cliquez sur un environnement.

  • /ebb/environement/:appName
  • /ebb/cluster/:clusterName/environement/:appName — la forme cantonnée au cluster
  • /ebb/environement/:appName/resource/:resourceName/details — une ressource

L’interface

📸 Capture d’écran : Une page de détail d’environnement sur l’onglet Overview. Repères : (1) l’en-tête avec le nom de l’environnement, (2) le contrôle de TTL, (3) le contrôle de verrouillage, (4) les quatre groupes d’onglets, (5) les actions d’environnement à droite de la barre d’onglets.

Les onglets sont organisés en quatre groupes :

Groupe Onglets À quoi il sert
Observe Overview · Deployment Info · Application Logs · Jobs Logs · Events · Metrics · CronJobs · Activity Logs Comprendre ce qui se passe. Commencez ici
Build Pipeline Steps Ce que le pipeline a fait, étape par étape
Operate Configuration · Resources · Edit ArgoCD · Actions Modifier quelque chose
Test Security · Testing · Performance · Quality Résultats des outils de test et d’analyse

Deux contrôles se trouvent dans l’en-tête plutôt que dans un onglet :

Élément Ce qu’il fait
Gestion du TTL Allonge ou raccourcit la durée de vie d’un environnement éphémère
Verrouillage Verrouille l’environnement avec un motif, pour qu’il ne soit pas modifié sous vos pieds

Quel onglet Observe utiliser

Question Onglet
Quelle version tourne, et est-elle saine ? Overview
Que vient de faire la plateforme ? Events
Que dit l’application ? Application Logs
Qu’a fait un job planifié ? Jobs Logs, CronJobs
Est-elle sous charge ou à court de ressources ? Metrics
Qui a changé quoi, et quand ? Activity Logs

Se précipiter sur Application Logs est le réflexe courant, et généralement le mauvais. Events vous dit si la plateforme a réussi avant que vous ne passiez du temps à lire la sortie de l’application.

Procédures

Verrouiller un environnement

  1. Ouvrez l’environnement.
  2. Utilisez le contrôle de verrouillage dans l’en-tête et indiquez un motif. Le motif est tout l’intérêt : un verrou sans explication finit par être retiré par la personne qu’il bloque.
  3. Déverrouillez quand vous avez terminé.

Prolonger le TTL d’un environnement de dev

  1. Ouvrez l’environnement et utilisez la gestion du TTL.
  2. Prolongez-le.

La boîte de dialogue propose un lien Advanced Settings, qui ouvre la page de configuration de l’environnement sur /ebb/environement/configuration.

Inspecter une ressource Kubernetes

  1. Allez dans Operate › Resources.
  2. Sélectionnez la ressource. Le tiroir de détail affiche son état.
  3. Pour une vue plus complète, ou pour agir dessus, utilisez Cluster Console.

Exécuter une action

  1. Allez dans Operate › Actions.
  2. Choisissez l’action et lancez-la. L’exécution diffuse sa sortie en direct, et les exécutions passées sont conservées dans l’historique.

Scénario

Une application s’est déployée avec succès mais renvoie des 502.

  1. Ouvrez l’environnement. Restez sur Overview assez longtemps pour confirmer que la version est bien celle attendue — sinon, c’est un problème de déploiement, pas d’application.
  2. Observe › Events. Cherchez des pods qui ne démarrent pas, des échecs de pull d’image ou de probes. Si la plateforme n’est pas contente, arrêtez-vous là et corrigez cela.
  3. Si les événements sont propres, la plateforme a fait son travail et l’application est en cause. Allez dans Observe › Application Logs.
  4. Observe › Metrics — un 502 qui coïncide avec les limites mémoire est un OOM kill, et aucune lecture de logs ne rendra cela évident.
  5. Operate › Resources — vérifiez le service et ses endpoints. Un 502 avec des pods sains et aucun endpoint est une erreur de selector, donc un problème de configuration et non de code.
  6. Si vous devez modifier quelque chose, utilisez Operate › Configuration pour la configuration, ou Operate › Actions pour une opération définie. Préférez l’un ou l’autre à une action directe sur le cluster : les deux sont consignés dans Activity Logs.

L’ordre compte : plateforme, puis application, puis configuration. Dans l’autre sens, on y passe l’après-midi.

En cas de problème

Symptôme Cause Comment vérifier Solution
Moins d’onglets que chez un collègue Les onglets sont contrôlés par les permissions du palier Access Explorer Demandez la permission précise sur ce palier
Impossible de modifier la configuration Il manque env-by-branch.<env>.configmap.write Access Explorer Demandez-la sur ce palier
L’environnement a disparu pendant votre travail TTL expiré (dev uniquement) Le TTL avant expiration Prolongez le TTL, ou verrouillez l’environnement
Une action échoue immédiatement Les prérequis de l’action ne sont pas réunis La sortie dans le panneau de flux Lisez le flux : il nomme la cause
L’onglet Metrics est vide La supervision n’est pas activée sur cette installation — La supervision est un réglage au niveau de la plateforme

Pour aller plus loin