Azure Boards
Azure Boards är Microsofts system för arbetsobjekt och en del av Azure DevOps Services. Arbetsobjekt identifieras med ett löpande numeriskt id (#12345) inom ett projekt, och i commit-meddelanden används ofta prefixet AB# för att skilja dem från ärendereferenser i GitHub-stil.
Forgejo-sidan: extern ärendehanterare
Repots Inställningar → Enheter → Ärenden → Använd externt ärendehanteringssystem.
| Fält | Värde |
|---|---|
| External issue tracker URL | https://dev.azure.com/<your-org>/<your-project>/_workitems/edit/{index} |
| External issue tracker URL format | https://dev.azure.com/<your-org>/<your-project>/_workitems/edit/{index} |
| External issue tracker number format | Regexp |
| External issue tracker number format regexp | `(?:AB |
Det reguljära uttrycket fångar både AB#12345 (den kanoniska referensen i Azure Boards) och den äldre formen #12345. Ersätt <your-org> och <your-project> med slugarna för din organisation och ditt projekt i Azure DevOps.
Rekommenderat format för commit-meddelanden
refactor: extract token-exchange path
AB#34521Prefixet AB# är en lös konvention från Azure DevOps-teamets dokumentation. Om ditt team i stället använder bara #12345 fångar uttrycket ovan båda formerna – men att blanda båda stilarna i samma repo förvirrar verktygen längre ned i kedjan.
Ärendehanterarens sida: Service Hooks (valfritt)
Så får du Azure Boards att visa länkade commits och PR:er på varje arbetsobjekt:
- Azure DevOps → Project Settings → Service hooks → + Add subscription.
- Tjänst: Web Hooks (sista alternativet i listan – Azure har ingen inbyggd service hook för ”Forgejo”, men Web Hooks accepterar vilken URL som helst).
- Utlösare: låt stå som ”Code pushed” / ”Pull request created”, beroende på vad du vill visa.
- URL: skapa FÖRST en utgående webhook i fremforge (Organisationens administration → Webhooks → Add Webhook) med målet
https://dev.azure.com/<your-org>/<your-project>/_apis/git/repositories/<your-repo-id>/links– Azures endpoint för att bifoga länkar. Klistra in den URL:en i Service Hook-prenumerationen.
Flödet är asymmetriskt (Forgejo → Azure) eftersom Azure DevOps inte pollar externa repon för Forgejo; det förväntar sig att pushar aviseras av din CI eller kodvärd. fremforges utgående webhook är rätt byggsten.
Konsekvenser för underbiträden
Kontrollplanet för Azure DevOps Services är Microsoft Azure (regionerna US-Central och EU-West, beroende på datalokalisering). När du kopplar fremforge till Azure Boards gäller följande:
- Commit-metadata och referenser till repon flödar till Microsoft Azure.
- Lägg till Microsoft Corporation i ditt register över underbiträden som en part som behandlar personuppgifter (commit-författarens mejladress, commit-meddelandet).
- fremforges personuppgiftsbiträdesavtal (DPA) undantar uttryckligen Microsofts underbiträden (enligt suveränitetshållningen på trust-sidan) – din organisations DPA-tillägg gäller ensamt för den här delen.
För arbetslaster där suveränitet är viktig kan du överväga Plane (egendriftad, kan driftas i EU, Apache 2.0) som alternativ till Azure Boards.
Vad det här inte gör
- Ingen automatisk stängning vid merge (Azure Boards stöder automatisering via Work Item Automation rules; konfigurera regeln mot den inkommande Web Hook-payloaden).
- Den inbyggda integrationen i Azure DevOps Repos (statusövergång när en PR mergas) följer INTE med till Forgejo – den kopplingen är specifik för Repos. Integrationen med fremforge är enkelriktad (commit/PR → länk till arbetsobjekt), plus automatisering som kunden själv sätter upp för den omvända riktningen.
- Synkronisering av sprint, iteration och area path ingår inte. Det är begrepp som är interna för Azure och inte låter sig mappas rent mot en Git-värd.