Aller au contenu principal

Jira Cloud

Jira Cloud est l’outil de suivi des tickets hébergé par Atlassian, dont les tickets ont pour adresse https://<your-org>.atlassian.net/browse/<KEY>-<NUMBER>. Cette page relie les messages de commit, les noms de branches et les titres de pull requests de vos dépôts fremforge à des liens vers les tickets de votre Jira.

Côté Forgejo : suivi de tickets externe

Paramètres du dépôt → Fonctionnalités → Tickets → Utiliser un système de suivi d’issues externe.

ChampValeur
External issue tracker URLhttps://<your-org>.atlassian.net/browse/{user}-{index}
External issue tracker URL formathttps://<your-org>.atlassian.net/browse/{user}-{index}
External issue tracker number formatRegexp
External issue tracker number format regexp([A-Z][A-Z0-9]+)-([0-9]+)

Appliquez, enregistrez. Chaque JIRA-123 ou PROJ-456 (ou tout autre préfixe de clé de projet utilisé par votre Jira) dans les messages de commit, les noms de branches et les titres de pull requests devient un lien cliquable vers votre Jira.

Format de message de commit recommandé

feat(api): add SBOM endpoint

PROJ-123 PROJ-124

Citez une ou plusieurs clés à la fin du corps du commit. Le panneau « Development » de chaque ticket Jira récupère les commits liés via le webhook entrant (section suivante).

Côté outil de suivi : webhook entrant (facultatif)

Pour que Jira affiche les commits et pull requests liés sur chaque ticket :

  1. Jira → Settings → System → WebHooks → Create a WebHook.
  2. URL : https://<your-org>.atlassian.net/rest/dvcs/1.0/jira-dvcs-webhook (remplacez-la par le point de terminaison de webhook DVCS de votre instance ; la documentation d’Atlassian, Linking commits to issues, donne l’URL à jour).
  3. Événements : cochez Push et Pull Request.
  4. Dans fremforge : Paramètres du dépôt → Webhooks → Ajouter un webhook → Forgejo → collez l’URL.

Les charges utiles vérifiées arrivent dans le DVCS Connector de Jira. La configuration prend environ 5 minutes par dépôt ; les administrateurs transverses la mettent généralement en place via les valeurs par défaut des dépôts, pour que chaque nouveau dépôt en hérite.

Conséquences en matière de sous-traitance

Le plan de contrôle de Jira Cloud se trouve dans AWS US-east-1 + AWS EU-west-2 (la résidence des données Atlassian en choisit un à l’inscription). Lorsque vous reliez fremforge à Jira Cloud :

  • Les messages de commit, l’adresse e-mail de l’auteur et le nom du dépôt partent vers le cloud d’Atlassian.
  • Mettez à jour votre AIPD et votre registre des sous-traitants pour y inscrire Atlassian comme sous-traitant ultérieur traitant des données à caractère personnel (métadonnées de commit).
  • Le DPA de fremforge exclut explicitement Atlassian : l’avenant au DPA de votre organisation est un document distinct.

Si la souveraineté est une contrainte stricte, utilisez plutôt Jira Data Center (auto-hébergé) ou Plane (auto-hébergé, déployable dans l’UE, Apache 2.0).

Ce que cette intégration ne fait pas

  • Pas de fermeture automatique à la fusion (automatisation côté outil de suivi : configurez une règle d’automatisation Jira qui ferme le ticket quand le webhook entrant arrive avec merged: true).
  • Pas de synchronisation bidirectionnelle de l’état (un ticket Jira qui passe à « In Progress » ne crée PAS automatiquement de branche fremforge ; il faut pour cela un workflow Forgejo Actions de votre côté).
  • Pas de syntaxe smart commit (#close PROJ-123 ne change pas l’état : c’est une règle d’automatisation côté Jira que vous configurez sur la charge utile du webhook entrant).
Jira Data Center