MaleusMaleus

Connecter git et configurer les cibles de déploiement

Branchez votre projet sur un remote git, puis ajoutez les targets de déploiement, hébergées par Maleus ou sur votre propre infrastructure, vers lesquelles promouvoir vos versions.

Dans l'appParamètres du projet
Sur cette page

Deux sections des réglages travaillent ensemble pour rendre une version livrable : Repository Git (où vit le code) et Déploiements (où va chaque version). Vous les configurez une fois, au début du projet.

Connecter un remote git

Cette étape est un prérequis pour tout ce qui touche aux déploiements.

  1. Ouvrez le projet, puis Réglages.
  2. Dans le drill Réglages de la sidebar, choisissez Repository Git.
  3. La page affiche l'un de quatre états.
    • Chargement pendant qu'on résout la configuration courante.
    • Vide si aucun remote n'est configuré. Utilisez le formulaire pour en connecter un.
    • Le formulaire de configuration, pour saisir l'URL du remote et les identifiants.
    • Configuré une fois branché. L'URL du remote est affichée avec une action de push.
  4. Enregistrez. Maleus peut désormais pousser des commits vers le remote.

Sans remote configuré, la section Déploiements est verrouillée : les versions promues n'auraient nulle part où aller.

Ajouter des targets de déploiement

Une target de déploiement désigne l'endroit où part une version quand vous la promouvez. À la création, le champ Hébergement propose deux modes.

ModeCe qui se passeQuand le choisir
Déploiement interneMaleus héberge et gère l'environnement. La target est un staging ou un production, avec sa branche et les URLs servies.Le cas le plus courant, recommandé par défaut.
Déploiement externeMaleus pousse la version sur une branche de votre dépôt, puis votre propre pipeline prend le relais, sur votre infrastructure.Quand la DSI garde la main sur l'hébergement et la chaîne de déploiement.

Une target interne, c'est un environnement, une branche et l'URL servie.

  1. Toujours dans le drill Réglages, choisissez Déploiements, puis Ajouter un déploiement.
  2. Choisissez l'Hébergement.
    • Déploiement interne : choisissez l'environnement (staging ou production) et la branche, puis complétez les URLs servies si besoin.
    • Déploiement externe : donnez un nom libre (par exemple « CI client ») et la branche que surveille votre pipeline.
  3. Enregistrez, puis répétez pour chaque environnement vers lequel vous voulez livrer.

Un projet a au plus une target interne staging et une production, et autant de targets externes que nécessaire. Chacune apparaît comme sa propre colonne sur la page Versions au moment de promouvoir.

La création et la modification des targets de déploiement sont réservées aux admins. Le type de déploiement ne peut pas être modifié après sa création.

Déploiement externe : les métiers livrent en autonomie

Une fois la target externe configurée par un admin, le responsable d'une application y promeut chaque nouvelle version depuis la liste des versions, exactement comme vers staging, sans passer par l'équipe infra. Votre pipeline se déclenche sur la branche et déploie selon vos propres règles.

  • Vos équipes peuvent aussi écrire sur la branche. Si quelqu'un y a poussé un commit entre-temps (un correctif, par exemple), Maleus rejoue la version par-dessus au lieu de l'écraser. Il n'y a jamais de force push.
  • La branche doit partager l'historique du projet. Si elle n'a aucun commit en commun avec lui, la promotion s'arrête et un message vous invite à vérifier la branche configurée sur la target.

Sur une target interne, la branche est réservée à Maleus : une promotion qui trouverait des commits poussés par quelqu'un d'autre est refusée, et la branche reste intacte.

Une fois que c'est fait

  • Marquez une version comme Terminé pour la faire passer dans la colonne Prête à déployer.
  • Promouvez-la vers n'importe quelle target depuis la liste des versions. Voir Promouvoir une version.

D'autres réglages qui méritent un coup d'œil

Pendant que vous êtes dans les Réglages, deux autres sections valent la peine d'être connues.

SectionCe qu'elle fait
EnvironnementsStatut de la sandbox de dev, des sandboxes d'agents et des sandboxes de workshop. Redémarrez depuis là si quelque chose se bloque.
SDK MaleusLe snippet d'installation du widget de tracing. Il alimente la page Revues d'app.

Zone dangereuse

La section Général porte une action Supprimer ce projet tout en bas. Destructrice et irréversible.