MaleusMaleus

Connecter un repository Git à un projet

Reliez un projet Maleus à son repository Git avec une URL HTTPS, une branche et un personal access token.

Dans l'appRéglages du projet · Repository GitAdrien Maret, CTOMis à jour 10 novembre 2026
Sur cette page

Chaque projet peut être relié individuellement à un repository Git existant. Maleus peut alors y pousser le code du projet et utiliser sa branche comme point de départ des déploiements.

Cette configuration est indépendante de la connexion GitLab du workspace, qui automatise la création ou l'import d'un repository au moment de créer un projet.

Avant de commencer

La configuration est réservée aux admins. Préparez :

  • l'URL HTTPS du repository ;
  • la branche sur laquelle Maleus doit pousser, maleus par défaut ;
  • un personal access token autorisé à lire et écrire dans ce repository.

Le formulaire prend en charge GitHub, GitLab, Bitbucket et Azure DevOps. Les droits précis du token dépendent du fournisseur, mais il doit permettre l'accès au repository ciblé.

Utilisez un token dédié avec les droits strictement nécessaires. Maleus le chiffre à l'enregistrement et ne l'affiche plus ensuite.

Ouvrir le réglage Repository Git

  1. Ouvrez le projet concerné.
  2. Entrez dans Réglages.
  3. Dans la sidebar, choisissez Repository Git.

Sans configuration, la page affiche No Git repository configured. Cliquez sur Configure.

Le repository se configure projet par projet depuis les réglages.

Renseigner le repository

Complétez le formulaire Connect a repository :

  1. Choisissez le Provider.
  2. Saisissez la Branch que Maleus doit utiliser.
  3. Collez la Repository URL en HTTPS.
  4. Collez le Personal Access Token.
  5. Cliquez sur Save.

Le token reste vide à l'écran et doit être saisi de nouveau lors d'une modification.

Si l'enregistrement échoue, le formulaire conserve le message remonté par le fournisseur avec une référence de support. Vérifiez en priorité l'URL, les droits du token et l'existence de la branche.

Vérifier la connexion et pousser

Une fois la configuration enregistrée, la carte affiche le fournisseur, l'URL, la branche et le statut Connected.

Le bouton Push to branch pousse l'état courant du projet vers la branche configurée. Il nécessite un environnement de développement disponible. Le résultat du push s'affiche directement dans la carte.

La carte connectée confirme le remote et la branche utilisés par le projet.

Modifier ou retirer la connexion

Le menu de la carte propose :

  • Edit pour changer le fournisseur, l'URL ou la branche. Le token doit être saisi de nouveau ;
  • Copy URL pour copier l'URL du remote ;
  • Remove pour déconnecter le projet du repository.

Retirer la configuration ne supprime pas le repository chez le fournisseur. Le projet reste dans Maleus, mais les pushes et les déploiements qui dépendent du remote ne peuvent plus partir tant qu'un repository n'est pas reconnecté.

Ensuite

Une fois le repository connecté, configurez les environnements vers lesquels promouvoir vos versions dans Configurer les cibles de déploiement.