Gå til hovedinnhold

Azure Boards

Azure Boards er Microsofts tracker for arbeidselementer og en del av Azure DevOps Services. Arbeidselementer adresseres med en fortløpende numerisk ID (#12345) innenfor et prosjekt, og i commit-meldinger får de ofte prefikset AB# for å skille dem fra issue-referanser i GitHub-stil.

Forgejo-siden: ekstern issue-tracker

Innstillinger for repositoryet → Enheter → Issues → Bruk ekstern issue-tracker.

FeltVerdi
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

Regex-uttrykket fanger både AB#12345 (den kanoniske referansen i Azure Boards) og den eldre formen #12345. Bytt ut <your-org> og <your-project> med slugene for organisasjonen og prosjektet ditt i Azure DevOps.

Anbefalt format for commit-meldinger

refactor: extract token-exchange path

AB#34521

Prefikset AB# er en løs konvensjon fra dokumentasjonen til Azure DevOps-teamet; hvis teamet ditt heller bruker bare #12345, fanger regex-uttrykket over begge – men å blande begge stilene i ett repository forvirrer verktøy lenger ned i kjeden.

Tracker-siden: service hooks (valgfritt)

Slik får du Azure Boards til å vise de tilknyttede commitene og PR-ene på hvert arbeidselement:

  1. Azure DevOps → Project Settings → Service hooks → + Add subscription.
  2. Tjeneste: Web Hooks (siste valg i listen – Azure har ingen innebygd service hook for «Forgejo», men Web Hooks godtar hvilken som helst URL).
  3. Trigger: la stå som «Code pushed» / «Pull request created», avhengig av hva du vil få fram.
  4. URL: opprett FØRST en utgående webhook i fremforge (administrasjon → Webhooks → Legg til webhook) med målet https://dev.azure.com/<your-org>/<your-project>/_apis/git/repositories/<your-repo-id>/links – Azures endepunkt for å feste lenker. Lim inn den URL-en i service hook-abonnementet.

Hoppet er asymmetrisk (Forgejo → Azure) fordi Azure DevOps ikke poller eksterne repositoryer for Forgejo; den forventer å bli varslet om pusher fra CI-en eller kodeverten din. Den utgående webhooken i fremforge er riktig byggekloss.

Konsekvenser for underdatabehandlere

Kontrollplanet til Azure DevOps Services er Microsoft Azure (regionene US-Central og EU-West, etter datalokalisering). Når du kobler fremforge til Azure Boards:

  • Commit-metadata og referanser til repositoryer flyter til Microsoft Azure.
  • Før opp Microsoft Corporation i underdatabehandlerregisteret ditt som behandler av personopplysninger (forfatterens e-postadresse og commit-melding).
  • Databehandleravtalen med fremforge utelukker uttrykkelig underdatabehandlere fra Microsoft (i tråd med suverenitetsprofilen på trust-siden) – tillegget til databehandleravtalen for organisasjonen din står alene for denne delen.

For arbeidslaster der suverenitet er viktig, kan du vurdere Plane (selvhostet, kan rulles ut i EU, Apache 2.0) som alternativ til Azure Boards.

Hva dette ikke gjør

  • Ingen automatisk lukking ved merge (Azure Boards støtter automatisering via Work Item Automation rules; sett opp regelen mot payloaden fra den innkommende Web Hook-en).
  • Den innebygde integrasjonen i Azure DevOps Repos (statusovergang når en PR merges) følger IKKE med over til Forgejo – den koblingen er spesifikk for Repos. Integrasjonen i fremforge er enveis (commit/PR → lenke til arbeidselement) pluss automatisering som kunden selv driver for motsatt retning.
  • Synkronisering av sprint, iterasjon og area path er utenfor omfanget. Det er interne begreper i Azure som ikke lar seg overføre ryddig til en Git-vert.