Naar de hoofdinhoud

Trello

Trello is de kaartgebaseerde tracker van Atlassian. Kaarten zijn bereikbaar via een korte ID (bijv. https://trello.com/c/aBc12XyZ, waarbij aBc12XyZ de korte link van de kaart is) of via een numerieke ID per bord en kaart. Door het losse projectmodel van Trello werkt de integratie anders dan bij Jira: er zijn geen “projectsleutels” zoals JIRA-123; kaarten zijn gewoon ID’s.

Forgejo-kant: externe issuetracker

Repository-instellingen → Onderdelen → Issues → Gebruik externe issue tracker.

Er zijn twee patronen, afhankelijk van of je team naar Trello-kaarten verwijst met de korte link of met een oplopend nummer per bord:

Patroon A: verwijzingen met de korte link (aanbevolen)

VeldWaarde
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})

Conventie voor commitberichten: T#aBc12XyZ (het korte-linkdeel uit de URL van de Trello-kaart).

Patroon B: oplopende numerieke verwijzingen

Gebruikt je team de numerieke vorm #<n> (die Trello per bord ook ondersteunt), kies dan een voorvoegsel per bord om botsingen te voorkomen wanneer meerdere borden naar één repository verwijzen: TRELLO-<n>. Patroon:

VeldWaarde
External issue tracker URLhttps://trello.com/b/<your-board-id>/<your-board-slug>
External issue tracker URL format(Trello biedt geen directe URL’s per numerieke ID; open in plaats daarvan het bord en zoek het nummer met ⌘F)
External issue tracker number formatRegexp
External issue tracker number format regexpTRELLO-([0-9]+)

Patroon A werkt prettiger, omdat elke kaart een stabiele URL met korte link heeft.

Aanbevolen formaat voor commitberichten

chore(deps): bump alpine 3.21 → 3.22

T#aBc12XyZ

De korte link blijft stabiel als een kaart een andere naam krijgt of naar een andere lijst gaat; numerieke ID’s niet (die worden opnieuw genummerd wanneer gearchiveerde kaarten terugkomen).

Trackerkant: Power-Up-webhook van Trello (optioneel)

Inkomende webhooks in Trello stel je per bord in:

  1. Trello-bord → Show menu → Power-Ups → zoek naar “Webhooks” of gebruik de Custom Webhooks Power-Up.
  2. Voeg een webhook toe met een URL die wijst naar een relay die je zelf beheert (Trello verwacht een specifieke vorm van verzoeken die model + action aan kaartgebeurtenissen koppelt; de vorm van de uitgaande webhook van fremforge past daar niet direct op).
  3. Hetzelfde patroon met een relay ertussen als bij Linear: 30 regels relaycode vertalen pull_request.opened van Forgejo naar de API-aanroep attachToCard van Trello, zodat de kaart de gekoppelde PR toont.

Wil je geen relay draaien, gebruik dan alleen het patroon met klikbare links in één richting (Forgejo → Trello), sla de inkomende webhook over en accepteer dat Trello-kaarten geen “linked PRs” tonen.

Gevolgen voor subverwerkers

Het control plane van Trello is AWS US-east-1 (beheerd door Atlassian, dezelfde opzet als Jira Cloud). Als je fremforge aan Trello koppelt:

  • Stromen commitmetadata en het e-mailadres van de auteur naar de cloud van Atlassian.
  • Neem je Atlassian op als subverwerker in je DPA en je register van subverwerkers (één vermelding dekt Jira Cloud, Trello en Confluence Cloud; ze delen dezelfde dataresidentie).
  • EU-dataresidentie is een optie op de Premium-abonnementen van Atlassian Cloud; controleer dat je Trello-workspace een Premium-abonnement heeft als alleen de EU toegestaan is.

Wat dit niet doet

  • Geen besef van Trello-borden of -lijsten: fremforge behandelt elke kaart hetzelfde. Wil je dat “een PR de kaart van In Progress naar Done verplaatst”, stel dan aan de Trello-kant een automatisering in (Butler-regel) die de relaywebhook leest.
  • Geen kaart aanmaken bij een commit: een verwijzing naar een korte link van een niet-bestaande kaart geeft een kapotte link, geen nieuwe kaart.
  • Een kaart aan meerdere repository’s koppelen vereist dat je in elke repository afzonderlijk naar dezelfde korte link verwijst.
LinearPlane