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.
| Felt | Verdi |
|---|---|
| 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 |
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#34521Prefikset 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:
- Azure DevOps → Project Settings → Service hooks → + Add subscription.
- Tjeneste: Web Hooks (siste valg i listen – Azure har ingen innebygd service hook for «Forgejo», men Web Hooks godtar hvilken som helst URL).
- Trigger: la stå som «Code pushed» / «Pull request created», avhengig av hva du vil få fram.
- 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.