MaleusMaleus

Connecter GitLab au workspace

Connectez GitLab une fois au workspace pour créer ou importer un repository à chaque création de projet.

Dans l'appRéglages · Version ControlAdrien Maret, CTOMis à jour 10 novembre 2026
Sur cette page

La connexion GitLab du workspace évite de configurer chaque nouveau projet à la main. Une fois l'autorisation OAuth enregistrée, Maleus peut créer un repository dans un namespace GitLab choisi ou relier un repository existant directement depuis le formulaire de création d'un projet.

Cette intégration est disponible pour GitLab.com et les instances GitLab self-managed. GitHub apparaît dans le catalogue avec le statut Coming soon, mais ne peut pas encore être connecté à ce niveau.

Il s'agit d'une connexion GitLab au niveau du workspace Maleus, pas d'une connexion stricte à une « organisation GitLab ». Le namespace par défaut peut être un groupe ou un sous-groupe auquel le compte autorisé a accès.

Avant de commencer

Vous devez être admin du workspace. Dans GitLab, préparez une application OAuth avec :

  • l'URL de base de l'instance, par exemple https://gitlab.com, sans chemin final ;
  • la Redirect URI fournie par Maleus ;
  • le scope api ;
  • l'Application ID et l'Application secret.

L'application OAuth peut être créée depuis les réglages d'un utilisateur, d'un groupe ou de l'administration GitLab, selon votre installation et votre gouvernance.

Le compte GitLab qui autorise la connexion agit pour tout le workspace. Utilisez de préférence un compte de service dédié, avec uniquement l'accès nécessaire aux namespaces et repositories concernés.

Connecter GitLab

  1. Ouvrez Réglages → Version Control.
  2. Choisissez GitLab dans Your providers.
  3. Copiez la Redirect URI affichée par Maleus dans l'application OAuth GitLab et activez le scope api.
  4. Dans Maleus, renseignez l'Instance URL, l'Application ID et l'Application secret.
  5. Cliquez sur Save & authorize.
  6. Dans la fenêtre GitLab qui s'ouvre, connectez-vous avec le compte prévu et acceptez l'autorisation.

Autorisez les pop-ups pour Maleus si le navigateur bloque la fenêtre OAuth. Les identifiants sont chiffrés par workspace et l'Application secret n'est plus affiché après l'enregistrement.

La page Version Control centralise les fournisseurs Git du workspace.

Définir la création automatique

Une connexion active ouvre la section Repository defaults.

  1. Activez Create a repository with every new project.
  2. Choisissez le Default namespace dans lequel les repositories seront créés.
  3. Choisissez la Default visibility proposée par votre instance GitLab, par exemple Private.

Les changements sont enregistrés immédiatement. Il n'y a pas de bouton Save dans cette section.

Le namespace et la visibilité deviennent les valeurs par défaut de chaque nouveau repository.

Ce que voit le créateur d'un projet

Quand GitLab est connecté, le formulaire New project affiche un bloc Source control avec trois choix :

ChoixEffet
Create a new repositoryCrée un repository vide dans le namespace sélectionné et le relie au projet.
Import an existing repositoryRecherche un repository GitLab accessible et le relie. Un repository déjà utilisé par un autre projet est marqué In use.
No repository for nowCrée le projet sans repository. Il pourra être connecté plus tard dans Réglages → Repository Git.

Même si la création automatique est activée, le créateur peut choisir une autre option avant de valider le projet.

Le chemin du repository, sa disponibilité et sa visibilité sont vérifiés avant la création du projet.

La création du repository est une étape au mieux : le projet Maleus reste créé si GitLab refuse l'opération. Un toast signale alors l'échec et la connexion peut être terminée ensuite depuis les réglages Git du projet.

Réautoriser ou déconnecter

Si GitLab révoque ou expire l'autorisation, la page affiche Needs re-authorization. La création de repositories est alors suspendue pour les nouveaux projets, sans toucher aux repositories déjà créés.

  • Utilisez Re-authorize pour renouveler l'autorisation avec le compte GitLab prévu.
  • Utilisez Disconnect dans le menu de la page pour retirer la connexion du workspace.

Déconnecter GitLab ne supprime aucun repository existant. Les remotes déjà enregistrés restent attachés aux projets, mais les opérations qui dépendaient de l'autorisation OAuth du workspace peuvent échouer jusqu'à la reconnexion. Le workflow automatisé n'est plus proposé aux nouveaux projets.