Aller au contenu principal

Trello

Trello est l’outil de suivi à base de cartes d’Atlassian. Les cartes sont identifiées par un identifiant court (par ex. https://trello.com/c/aBc12XyZ, où aBc12XyZ est le lien court de la carte) ou par un identifiant numérique tableau + carte. Le modèle de projet souple de Trello rend l’intégration différente de celle de Jira : il n’y a pas de « clés de projet » comme JIRA-123, les cartes ne sont que des identifiants.

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.

Deux modèles, selon que votre équipe désigne les cartes Trello par leur lien court ou par un numéro séquentiel propre à chaque tableau :

Modèle A : références par lien court (recommandé)

ChampValeur
External issue tracker URLhttps://trello.com/c/{index}
External issue tracker URL formathttps://trello.com/c/{index}
External issue tracker number formatRegexp
External issue tracker number format regexpT#([a-zA-Z0-9]{8})

Convention pour les messages de commit : T#aBc12XyZ (le suffixe de lien court tiré de l’URL de la carte Trello).

Modèle B : références numériques séquentielles

Si votre équipe utilise la forme numérique #<n> (que Trello prend aussi en charge par tableau), choisissez un préfixe par tableau pour éviter les collisions lorsque plusieurs tableaux sont liés à un même dépôt : TRELLO-<n>. Modèle :

ChampValeur
External issue tracker URLhttps://trello.com/b/<your-board-id>/<your-board-slug>
External issue tracker URL format(Trello n’expose pas d’URL directe par identifiant numérique : à défaut, ouvrez le tableau puis cherchez le numéro avec ⌘F)
External issue tracker number formatRegexp
External issue tracker number format regexpTRELLO-([0-9]+)

Le modèle A offre une meilleure expérience, car chaque carte possède une URL de lien court stable.

Format de message de commit recommandé

chore(deps): bump alpine 3.21 → 3.22

T#aBc12XyZ

Le lien court reste stable quand une carte est renommée ou déplacée d’une liste à l’autre ; ce n’est pas le cas des identifiants numériques (ils sont renumérotés quand des cartes archivées reviennent).

Côté outil de suivi : webhook Power-Up Trello (facultatif)

Les webhooks entrants de Trello se configurent par tableau :

  1. Tableau Trello → Show menu → Power-Ups → cherchez « Webhooks » ou utilisez le Power-Up Custom Webhooks.
  2. Ajoutez un webhook dont l’URL pointe vers un relais que vous contrôlez (Trello attend une forme de requête précise qui associe model + action à des événements de carte ; le format du webhook sortant de fremforge ne correspond pas directement).
  3. Même principe de relais intermédiaire que pour Linear : 30 lignes de code de relais traduisent le pull_request.opened de Forgejo en appel à l’API attachToCard de Trello, pour que la carte affiche la pull request liée.

Si vous ne voulez pas faire tourner de relais : contentez-vous du lien cliquable à sens unique (Forgejo → Trello), ignorez le webhook entrant et acceptez que les cartes Trello n’affichent pas les « pull requests liées ».

Conséquences en matière de sous-traitance

Le plan de contrôle de Trello se trouve dans AWS US-east-1 (géré par Atlassian, même position que Jira Cloud). Lorsque vous reliez fremforge à Trello :

  • Les métadonnées de commit et l’adresse e-mail de l’auteur partent vers le cloud d’Atlassian.
  • Inscrivez Atlassian comme sous-traitant ultérieur dans votre DPA et votre registre des sous-traitants (une seule entrée couvre Jira Cloud, Trello et Confluence Cloud, qui partagent la même résidence des données).
  • La résidence des données dans l’UE est une option des offres Atlassian Cloud Premium ; vérifiez que votre espace de travail Trello est sur une offre Premium si l’UE seule est exigée.

Ce que cette intégration ne fait pas

  • Aucune connaissance des tableaux ni des listes Trello : fremforge traite toutes les cartes de la même manière. Pour obtenir « la pull request fait passer la carte de In Progress à Done », configurez une automatisation côté Trello (règle Butler) qui lit le webhook du relais.
  • Pas de création de carte au commit : citer un lien court de carte inexistant produit un lien cassé, pas une nouvelle carte.
  • Lier une carte à plusieurs dépôts demande de citer le même lien court depuis chaque dépôt séparément.
LinearPlane