Docs

Dev

À quoi sert cet écran

Les environnements Dev sont temporaires et propres à un cluster. Vous en créez un pour une branche, vous l’utilisez, puis vous le laissez disparaître. Parce qu’ils sont éphémères, le dev est le palier où expérimenter ne coûte rien et où personne d’autre ne subit ce que vous cassez.

Avant de commencer

Pour faire ceci Il vous faut
Ouvrir la page env-by-branch.dev.access
Créer un environnement env-by-branch.dev.environment.create
Voir le flux d’événements env-by-branch.dev.event.read
Synchroniser une application env-by-branch.dev.application.sync
Redémarrer un deployment env-by-branch.dev.deployment.restart

Un cluster de développement enregistré et valide doit exister — voir Settings › Infrastructure › Clusters.

Ouvrir l’écran

  1. Deploy › Dev dans la barre latérale.

URL directe : /ebb/dev. /ebb seul y redirige.

L’interface

La mise en page est commune aux trois paliers et décrite dans Deploy. Ce qui est propre au dev :

📸 Capture d’écran : La page Dev Environments avec deux environnements éphémères. Repères : (1) le sélecteur de cluster réglé sur un cluster de développement, (2) le bouton de création, (3) une ligne d’environnement affichant son TTL.

Élément Comportement propre au dev
Sélecteur de cluster Ne propose que les clusters enregistrés comme clusters de développement
Créer Crée un environnement éphémère, doté d’une durée de vie (TTL)
Ligne d’environnement Affiche le TTL — les environnements de dev expirent volontairement

Procédures

Créer un environnement de dev pour une branche

Nécessite env-by-branch.dev.environment.create.

  1. Deploy › Dev.
  2. Sélectionnez le cluster de développement.
  3. Cliquez sur créer et renseignez l’environnement en choisissant la branche.
  4. Attendez qu’il soit prêt, puis ouvrez-le pour obtenir son URL — voir Détail d’un environnement.

Allonger ou raccourcir un TTL

Ouvrez l’environnement et utilisez la gestion du TTL — voir Détail d’un environnement. Un environnement de dev expiré est supprimé : c’est le principe du palier, pas un échec.

Diagnostiquer un déploiement qui ne démarre pas

  1. Passez à l’onglet Events. Lisez-le avant toute autre action : il nomme presque toujours la cause.
  2. Si les événements désignent l’application plutôt que la plateforme, ouvrez l’environnement et descendez jusqu’à la ressource en échec.

Scénario

Deux développeurs ont besoin du même service dans deux versions différentes, en même temps.

Sur un environnement partagé, c’est un conflit. En dev, non.

  1. Deploy › Dev, sélectionnez le cluster de développement.
  2. Chacun crée son propre environnement à partir de sa branche. Nommez-les d’après la branche, pas d’après la personne : c’est la branche que quelqu’un reconnaîtra une semaine plus tard.
  3. Chacun déploie indépendamment. Aucun ne peut gêner l’autre, les environnements étant distincts.
  4. Chacun vérifie son changement et lit l’onglet Events de son propre environnement.
  5. Quand une branche est fusionnée, son environnement ne sert plus. Laissez le TTL expirer plutôt que de le prolonger par habitude : un environnement éphémère que personne ne supprime n’est qu’un environnement de staging coûteux.

En cas de problème

Symptôme Cause Comment vérifier Solution
Aucun cluster dans le sélecteur Aucun cluster enregistré comme cluster de développement, ou aucun valide Clusters Enregistrez-en un et validez-le
Bouton de création absent Il manque env-by-branch.dev.environment.create Access Explorer Demandez la permission sur le palier dev
Avertissement sur ArgoCD ou Workflows L’intégration CI/CD est absente ou non testée Settings › Development › CI/CD Ajoutez-la et testez-la
Un environnement a disparu Son TTL a expiré — les environnements de dev sont éphémères par conception Le TTL avant expiration Recréez-le ; prolongez le TTL s’il est réellement nécessaire plus longtemps
Déploiement vert mais l’application ne marche pas Une synchronisation réussie n’est pas une application qui fonctionne L’onglet Events, puis le détail de la ressource Diagnostiquez l’application, pas la plateforme

Pour aller plus loin