Hoppa till huvudinnehållet

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ältVärde
External issue tracker URLhttps://dev.azure.com/<your-org>/<your-project>/_workitems/edit/{index}
External issue tracker URL formathttps://dev.azure.com/<your-org>/<your-project>/_workitems/edit/{index}
External issue tracker number formatRegexp
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#34521

Prefixet 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:

  1. Azure DevOps → Project Settings → Service hooks → + Add subscription.
  2. 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).
  3. Utlösare: låt stå som ”Code pushed” / ”Pull request created”, beroende på vad du vill visa.
  4. 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.