Bitbucket: nyckelbegrepp, Pipelines och möjligheter

Vad är Bitbucket?

Bitbucket är en webbplattform för hosting av Git-repositories, utvecklad av företaget Atlassian. Ursprungligen stödde Bitbucket endast Mercurial (från 2008), men efter att stödet för Mercurial upphörde 2020 övergick det helt till Git. Plattformen finns i två utgåvor: Bitbucket Cloud (SaaS, Atlassian-hosting) och Bitbucket Data Center (lokal version för Enterprise).

Den främsta fördelen med Bitbucket jämfört med konkurrenterna — djup integration med Atlassian-produkter. Jira kopplar automatiskt commits och Pull Requests till uppgifter, Confluence gör det möjligt att bädda in kodsnuttar i dokumentation, och Opsgenie kopplar samman driftsättningar med incidenter. För team som redan använder Atlassian-ekosystemet är Bitbucket ett naturligt val eftersom det inte kräver konfiguration av ytterligare integrationer.

Bitbucket Cloud erbjuder flera nivåer av hosting. Den kostnadsfria planen omfattar en användare och begränsad lagring (1 GB). Standardplanen kostar 3 dollar per användare per månad med obegränsat antal privata repositories och 2500 minuter Pipelines per månad. Bitbucket använder en användarlicensieringsmodell: varje användare som har åtkomst till ett repository, inklusive skrivskyddad, faktureras.

Bitbucket Pipelines: CI/CD ur lådan

Bitbucket Pipelines är ett inbyggt CI/CD-system som fungerar på basis av Docker-containrar. Pipelines är direkt integrerat i Bitbucket Cloud och kräver inte installation av separata runners eller konfiguration av webhook. Konfigurationen beskrivs i filen bitbucket-pipelines.yml som finns i roten av repositoryt. Varje pipeline består av steg (steps) som kombineras i sekvenser.

Pipelines stöder parallella steg, manuell start, triggers vid push och schema, cachning av beroenden och artefakter. Varje steg körs i en isolerad Docker-container vars bild specificeras i konfigurationen. Nedan visas ett exempel på en pipeline för att bygga en Android-app med testning och publicering till Firebase App Distribution:

# bitbucket-pipelines.yml
image: openjdk:17-jdk

pipelines:
  pull-requests:
    '**':
      - step:
          name: Build and Test
          caches:
            - gradle
          script:
            - ./gradlew assembleDebug testDebugUnitTest
          artifacts:
            - app/build/outputs/apk/debug/

  branches:
    main:
      - step:
          name: Deploy to Firebase
          script:
            - pipe: atlassian/firebase-distribution:1.0.0
              variables:
                APP_FILE: 'app/build/outputs/apk/debug/app-debug.apk'

Bitbucket Pipelines har en begränsning på 50 minuter per pipeline för Cloud-versionen, vilket är tillräckligt för de flesta projekt, men kan vara en flaskhals för stora monorepositories. I Data Center tas denna begränsning bort helt — pipeline-längden bestäms endast av tillgängliga serverresurser. Pipelines stöder också anpassade Docker-bilder, vilket gör det möjligt att använda vilka bygg- och testverktyg som helst.

Pull Request och kodgranskning i Bitbucket

Pull Request i Bitbucket är implementerad med fokus på företagsprocesser för kodgranskning. Bitbucket erbjuder: inline-kommentarer till specifika diff-rader, obligatoriska kontroller (checks) från Pipelines eller externa tjänster, minsta antal godkännanden för sammanslagning, blockering av merge tills alla kontroller är godkända och deklaration av intressekonflikt (decline). PR-gränssnittet är uppdelat i tre kolumner: källkod, diff och filstruktur.

Den unika funktionen i Bitbucket — Code Insights. Detta är ett API för integration av externa verktyg för kodkvalitet (SonarQube, CodeScene, ESLint, Detekt) som visar sina resultat direkt i Pull Request-gränssnittet. Utvecklaren ser: antal nya buggar, testtäckning, code smells och dubbliceringar. Code Insights möjliggör beslut om merge baserat på objektiva mätvärden, inte bara granskarens subjektiva åsikt.

Bitbucket stöder också grenbegränsningar (branch permissions): man kan förbjuda borttagning av grenar, tvinga skapande av PR för vissa grenar, begränsa listan över användare med merge-rättigheter till main. Dessutom finns merge-kontroller (merge checks) — en lista med obligatoriska villkor (Pipelines godkänd, minst N godkännanden, inga öppna kommentarer) som måste uppfyllas före Merge-knappen. Inställningarna skyddar produktionsgrenen från oavsiktliga oprövade ändringar.

Integration av Bitbucket med Jira och Confluence

Integrationen av Bitbucket med Jira är plattformens främsta fördel. När utvecklaren inkluderar uppgiftsnyckeln i commit-meddelandet (t.ex. PROJ-123) kopplar Jira automatiskt denna commit till uppgiften. I uppgiftsgränssnittet visas fliken Development där alla commits, Pull Requests, grenar och driftsättningar relaterade till denna uppgift samlas. PR uppdaterar automatiskt uppgiftsstatus i Jira vid sammanslagning (övergång till Done).

Confluence integreras också med Bitbucket: levande kodsnuttar från repositoryt kan bäddas in i Confluence-sidor via makrot Code Block. Ändringar i koden synkroniseras automatiskt med Confluence, vilket är bekvämt för att underhålla arkitekturdokumentation. Dessutom tillhandahåller Atlassian Smart Commits — hantering av Jira-uppgifter direkt från commit-meddelandet: statusändring, tillägg av tid och prioriteringar.

För DevOps-automatisering stöder Bitbucket Deployment Gate — koppling av driftsättning till uppgiftsversion. När pipelinen når driftsättningsfasen kontrollerar Jira om alla uppgifter i denna version har status Approved. Om inte — blockeras driftsättningen. Detta implementerar Continuous Delivery-principen med kvalitetskontroll på uppgiftsnivå, inte bara kodnivå.

Repository-mallar

Bitbucket gör det möjligt att skapa repository-mallar för standardisering av projektstruktur. För mobila projekt kan en mall skapas med förinstallerade filer: Gradle-konfiguration, gitignore, Detekt- och Ktlint-inställningar, pipeline för Android CI och README med bygginstruktioner. Ett nytt projekt skapas från mallen med några klick, vilket påskyndar introduktionen av nya utvecklare.

Bitbucket jämfört med GitHub och GitLab

Jämförelse av Bitbucket med GitHub och GitLab beror på vilket ekosystem teamet arbetar i. Bitbucket förlorar mot GitHub i community-storlek (10 miljoner jämfört med 100 miljoner användare), men vinner i företagsintegrationer tack vare Atlassian-stacken. Om teamet redan använder Jira för uppgiftshantering och Confluence för dokumentation — ger Bitbucket sömlös integration utan ytterligare konfiguration.

När det gäller CI/CD ligger Bitbucket Pipelines efter GitLab CI/CD i avancerade scenarier (inga child pipelines, matrisbyggen, flernivåpipelines) och GitHub Actions när det gäller antalet färdiga åtgärder (Marketplace Actions innehåller 20 000+ steg jämfört med tusentals publika pipes i Bitbucket). Pipelines är dock enklare att konfigurera för typiska scenarier tack vare färdiga pipe-komponenter från Atlassian.

Valet av Bitbucket är motiverat i två scenarier: teamet använder redan Atlassian-ekosystemet (Jira + Confluence + Opsgenie) eller arbetet utförs i en företagsmiljö där Bitbucket Data Centre redan är implementerat som standardverktyg. För startups och open source-projekt erbjuder GitHub en rikare community och gratis funktioner, medan GitLab — den bästa egenhostade CI/CD.

Bitbucket Data Center för Enterprise

Bitbucket Data Center är företagsversionen av plattformen, avsedd för installation på egen infrastruktur. Till skillnad från Cloud-versionen erbjuder Data Center: klustring (aktiv-aktiv-läge för flera noder), Smart Mirroring (geografiskt distribuerade speglar för att påskynda clone/fetch), hög tillgänglighet (99,99% drifttid vid klustring) och fullständig granskning av åtgärder.

Data Center innehåller alla funktioner i Cloud-versionen, men med företagstillägg. Smart Mirroring synkroniserar automatiskt repositories mellan servrar i olika datacenter — utvecklare från Europa och Asien får samma clone/fetch-hastighet eftersom Git-operationer utförs via närmaste spegel. Granskningsloggar lagrar varje åtgärd: vem, när och från vilken IP som skapade en gren, gjorde en push, sammanfogade en PR.

Licensiering av Bitbucket Data Center baseras på antalet användare (inte repositories). Minsta licens för 50 användare kostar från 1520 dollar per år (standardplan). Data Center är obligatoriskt för organisationer där: SLA krävs för tillgänglighet, data inte får lämna landet (GDPR, 152-FZ), antalet utvecklare överstiger 500 personer eller integration med företagets LDAP/SAML-system krävs.

Bitbucket Snippets för delad kod

Bitbucket Snippets — ett verktyg för att lagra och dela små kodfragment. Till skillnad från repositories har Snippets ingen fullständig Git-historik, men stöder versionshantering, kommentarer och forks. Snippets är användbara för delade konfigurationer (docker-compose.yml för lokal utveckling), SQL-migreringsskript och kodexempel som inte kräver ett fullständigt repository. Varje Snippet har en unik URL och kan kopplas till ett projekt i Jira.

Bitbucket API för automatisering

Bitbucket REST API 2.0 möjliggör programmeringshantering av repositories, Pull Requests, grenar och behörigheter. API:t används för automatisering av arbetsflöden: skapa repository från mall, massuppdatering av behörigheter, hämtning av Pull Request-statistik och integration med externa CI-system. Rate limit är 1000 förfrågningar per timme för autentiserade användare. API:t stöder paginering via Page- och Pagelen-parametrar för arbete med stora datamängder.