Fournisseurs Git auto-hébergés

Clowld Space se connecte à un fournisseur Git auto-hébergé par espace de travail : Forgejo, Gitea ou GitLab. Une fois la connexion établie, toute pull request (GitLab : merge request) dont le nom de branche ou le titre contient un identifiant de tâche (par exemple CS-123), ou dont la description en cite un après un mot-clé de clôture (Closes CS-123), est associée automatiquement à cette tâche, apparaît sous Pull requests dans la barre latérale de la tâche et — lorsqu'elle est fusionnée avec un mot-clé de clôture — fait passer la tâche au statut choisi (Terminé par défaut). La CI du commit de tête s'affiche sous forme de barre de vérifications sur la carte.

Ces fournisseurs fonctionnent en parallèle de GitHub : un espace de travail peut les combiner librement. La clôture dépend du réglage commun Paramètres → Statuts des tâches → Automatisation et de l’exception propre à chaque tâche. Les PR fermées sans fusion ne bloquent pas la clôture. Une association retirée n’est pas recréée automatiquement et activer le réglage ne clôture pas rétroactivement les tâches. Voir GitHub pour les conditions détaillées.

Dans Paramètres → Intégrations → GitHub ou la page Git auto-hébergé, choisissez le statut après fusion : Terminé par défaut, un statut de catégorie en cours ou terminé (personnalisé compris), ou aucun changement. Bloqué est exclu. Le réglage est commun à tous les fournisseurs.

Prérequis (serveur)

Activez l'intégration pour ce déploiement. Elle est désactivée par défaut : la section reste masquée tant que vous n'avez pas défini :

CLOWLD_VCS_INTEGRATION_ENABLED=true

Le fichier docker compose officiel d'auto-hébergement (docker-compose.selfhost.yml) la définit pour vous.

Définissez ensuite une clé de 32 octets encodée en base64 pour que le serveur puisse chiffrer les identifiants stockés. Sans elle, le formulaire de connexion est désactivé.

openssl rand -base64 32

CLOWLD_VCS_SECRET_KEY=<base64 32-byte key>

Les deux sont requises : l'interrupteur détermine si la fonctionnalité est proposée, et la clé chiffre le jeton et le secret du webhook stockés. La connexion, le webhook et la régénération exigent ces deux réglages.

Définissez CLOWLD_PUBLIC_URL sur l'URL de base publique du serveur pour que Clowld Space puisse afficher une URL de webhook prête à coller. Sans elle, l'interface n'affiche que le chemin du webhook et vous devez y ajouter vous-même votre origine.

Connecter un espace de travail

1. Chez votre fournisseur, créez un jeton d'accès disposant d'un accès en lecture aux dépôts que vous voulez refléter :
   • Forgejo / Gitea : Settings → Applications.
   • GitLab : un jeton d'accès personnel (ou de groupe/projet) avec la portée read_api.
2. Dans Clowld Space, ouvrez Paramètres → Intégrations → Fournisseurs git (auto-hébergés).
3. Choisissez le Fournisseur, saisissez l'URL de l'instance (par exemple https://forgejo.example.com) et le jeton d'accès, puis cliquez sur Connecter. Clowld Space valide le jeton auprès de l'instance avant d'enregistrer.
4. Copiez l'URL du webhook et le Secret du webhook affichés après la connexion.

Enregistrer le webhook

Sur le dépôt (ou sur l'organisation/le groupe, pour couvrir tous les dépôts) :

Forgejo / Gitea — Settings → Webhooks → Add Webhook → Forgejo/Gitea :

• Target URL : l'URL du webhook obtenue à l'étape précédente.
• HTTP method POST, content type application/json.
• Secret : le secret du webhook (utilisé pour vérifier le HMAC X-Gitea-Signature).
• Trigger events : sélectionnez Pull Request, ainsi que Commit Status pour refléter la CI.

GitLab — Settings → Webhooks :

• URL : l'URL du webhook.
• Secret token : le secret du webhook (envoyé dans X-Gitlab-Token et comparé tel quel).
• Triggers : activez Merge request events, ainsi que Pipeline events pour refléter la CI.

Clowld Space authentifie chaque livraison à l'aide du secret stocké : un webhook qui n'a pas le secret correspondant est rejeté.

Ce qui est reflété

• Pull requests / merge requests — état ouvert, fermé, fusionné et brouillon, auteur, branche et (lorsque le fournisseur les fournit) statistiques de diff.
• Liens vers les tâches — un identifiant dans le titre ou la branche associe la PR à la tâche, tout comme un identifiant placé après un mot-clé de clôture dans la description ; une simple mention dans la description n'associe rien. Un mot-clé de clôture (Closes/Fixes/Resolves CS-123) sur une PR fusionnée fait passer la tâche au statut choisi (Terminé par défaut) dès qu'aucune PR associée n'est encore ouverte.
• CI — les statuts de commit Forgejo/Gitea et les pipelines GitLab sont agrégés dans une barre de vérifications réussie/en échec/en attente pour le commit de tête.

Agents qui ouvrent des pull requests

La création de PR ne nécessite aucune configuration de fournisseur dans Clowld Space. Les agents récupèrent les dépôts dans le runtime, puis poussent leurs branches et ouvrent les PR avec les identifiants Git propres à la machine du runtime. Pour permettre aux agents de travailler avec un fournisseur, assurez-vous que la machine du daemon peut s'y authentifier — par exemple avec une clé de déploiement SSH, ou un jeton dans le gestionnaire d'identifiants Git (credential helper) de la machine — et ajoutez l'URL du dépôt comme d'habitude. La récupération des dépôts fonctionne avec n'importe quelle URL Git : aucun câblage propre au fournisseur n'est nécessaire.