Bitbucket: klíčové pojmy, Pipelines a možnosti

Co je Bitbucket?

Bitbucket je webová platforma pro hosting Git repozitářů, vyvinutá společností Atlassian. Původně Bitbucket podporoval pouze Mercurial (od roku 2008), ale po ukončení podpory Mercurial v roce 2020 zcela přešel na Git. Platforma je k dispozici ve dvou edicích: Bitbucket Cloud (SaaS, hosting Atlassian) a Bitbucket Data Center (místní verze pro Enterprise).

Hlavní výhoda Bitbucket oproti konkurenci — hluboká integrace s produkty Atlassian. Jira automaticky propojuje commity a Pull Requesty s úkoly, Confluence umožňuje vkládání úryvků kódu do dokumentace a Opsgenie spojuje nasazení s incidenty. Pro týmy, které již používají ekosystém Atlassian, je Bitbucket přirozenou volbou, protože nevyžaduje konfiguraci dalších integrací.

Bitbucket Cloud nabízí několik úrovní hostingu. Bezplatný tarif zahrnuje jednoho uživatele a omezené úložiště (1 GB). Standardní tarif stojí 3 dolary na uživatele měsíčně s neomezeným počtem soukromých repozitářů a 2500 minutami Pipelines měsíčně. Bitbucket používá model licencování uživatelů: každý uživatel s přístupem k repozitáři, včetně pouze pro čtení, je účtován.

Bitbucket Pipelines: CI/CD z krabice

Bitbucket Pipelines je vestavěný CI/CD systém, který pracuje na bázi Docker kontejnerů. Pipelines je integrován přímo do Bitbucket Cloud a nevyžaduje instalaci samostatných runnerů nebo konfiguraci webhooku. Konfigurace je popsána v souboru bitbucket-pipelines.yml, umístěném v kořeni repozitáře. Každý pipeline se skládá z kroků (steps) spojených do sekvencí.

Pipelines podporuje paralelní kroky, ruční spouštění, triggery na push a plán, ukládání závislostí do mezipaměti a artefakty. Každý krok je spuštěn v izolovaném Docker kontejneru, jehož obraz je určen v konfiguraci. Níže je uveden příklad pipeline pro sestavení Android aplikace s testováním a publikací do 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 má omezení 50 minut na jeden pipeline pro Cloud verzi, což je dostačující pro většinu projektů, ale může být úzkým hrdlem pro velké monorepozitáře. V Data Center je toto omezení zcela odstraněno — doba trvání pipeline je určena pouze dostupnými prostředky serveru. Pipelines také podporuje vlastní Docker obrazy, což umožňuje použití jakýchkoli nástrojů pro sestavení a testování.

Pull Request a kontrola kódu v Bitbucket

Pull Request v Bitbucket je implementován s důrazem na firemní procesy kontroly kódu. Bitbucket nabízí: inline komentáře ke konkrétním řádkům diff, povinné kontroly (checks) z Pipelines nebo externích služeb, minimální počet schválení pro sloučení, blokování merge do dokončení všech kontrol a prohlášení o střetu zájmů (decline). Rozhraní PR je rozděleno do tří sloupců: zdrojový kód, diff a struktura souborů.

Unikátní funkce Bitbucket — Code Insights. Jde o API pro integraci externích nástrojů kvality kódu (SonarQube, CodeScene, ESLint, Detekt), které zobrazují své výsledky přímo v rozhraní Pull Request. Vývojář vidí: počet nových chyb, pokrytí testy, code smells a duplicity. Code Insights umožňuje rozhodování o merge na základě objektivních metrik, nejen subjektivního názoru recenzenta.

Bitbucket také podporuje omezení větví (branch permissions): lze zakázat mazání větví, nařídit vytváření PR pro určité větve, omezit seznam uživatelů s právy merge do main. Dále existují kontroly merge (merge checks) — seznam povinných podmínek (Pipelines prošel, minimálně N schválení, žádné otevřené komentáře), které musí být splněny před tlačítkem Merge. Nastavení chrání produkční větev před náhodnými neověřenými změnami.

Integrace Bitbucket s Jira a Confluence

Integrace Bitbucket s Jira — klíčová výhoda platformy. Když vývojář zahrne do zprávy commitu klíč úkolu (např. PROJ-123), Jira automaticky připojí tento commit k úkolu. V rozhraní úkolu se zobrazí karta Development, kde jsou shromážděny všechny commity, Pull Requesty, větve a nasazení související s tímto úkolem. PR automaticky aktualizují stav úkolu v Jira při sloučení (přechod do Done).

Confluence se také integruje s Bitbucket: živé úryvky kódu z repozitáře lze vložit do stránek Confluence pomocí makra Code Block. Změny v kódu jsou automaticky synchronizovány s Confluence, což je vhodné pro vedení architektonické dokumentace. Kromě toho Atlassian poskytuje Smart Commits — správu úkolů Jira přímo ze zprávy commitu: změna stavu, přidání času a priorit.

Pro automatizaci DevOps Bitbucket podporuje Deployment Gate — propojení nasazení s verzí úkolu. Když pipeline dosáhne fáze nasazení, Jira zkontroluje, zda všechny úkoly v tomto vydání mají stav Approved. Pokud ne — nasazení je blokováno. Tím je implementován princip Continuous Delivery s kontrolou kvality na úrovni úkolů, nejen kódu.

Šablony repozitářů

Bitbucket umožňuje vytváření šablon repozitářů pro standardizaci struktury projektů. Pro mobilní projekty lze vytvořit šablonu s předinstalovanými soubory: konfigurace Gradle, gitignore, nastavení Detekt a Ktlint, pipeline pro Android CI a README s návodem na sestavení. Nový projekt se vytvoří ze šablony několika kliknutími, což urychluje zaškolení nových vývojářů.

Bitbucket versus GitHub a GitLab

Srovnání Bitbucket s GitHub a GitLab závisí na ekosystému, ve kterém tým pracuje. Bitbucket prohrává s GitHub ve velikosti komunity (10 milionů oproti 100 milionům uživatelů), ale vítězí v podnikových integracích díky Atlassian stacku. Pokud tým již používá Jira pro správu úkolů a Confluence pro dokumentaci — Bitbucket poskytuje bezproblémovou integraci bez další konfigurace.

Pokud jde o CI/CD, Bitbucket Pipelines zaostává za GitLab CI/CD v pokročilých scénářích (žádné child pipelines, maticová sestavení, víceúrovňové pipeline) a GitHub Actions v počtu hotových akcí (Marketplace Actions obsahuje 20 000+ kroků oproti tisícům veřejných pipů v Bitbucket). Pipelines je však jednodušší na konfiguraci pro typické scénáře díky hotovým komponentám pipe od Atlassian.

Výběr Bitbucket je odůvodněn ve dvou scénářích: tým již používá ekosystém Atlassian (Jira + Confluence + Opsgenie) nebo práce probíhá v podnikovém prostředí, kde je Bitbucket Data Centre již nasazen jako standardní nástroj. Pro startupy a open-source projekty GitHub nabízí bohatší komunitu a bezplatné funkce, zatímco GitLab — nejlepší vlastní CI/CD.

Bitbucket Data Center pro Enterprise

Bitbucket Data Center je podniková verze platformy určená pro instalaci na vlastní infrastrukturu. Na rozdíl od Cloud verze Data Center nabízí: clustering (aktivní-aktivní režim pro více uzlů), Smart Mirroring (geograficky distribuovaná zrcadla pro urychlení clone/fetch), vysokou dostupnost (99,99% uptime při clusteringu) a úplný audit akcí.

Data Center zahrnuje všechny funkce Cloud verze, ale s podnikovými rozšířeními. Smart Mirroring automaticky synchronizuje repozitáře mezi servery v různých datových centrech — vývojáři z Evropy a Asie získávají stejnou rychlost clone/fetch, protože Git operace jsou prováděny přes nejbližší zrcadlo. Auditní logy ukládají každou akci: kdo, kdy a z jaké IP vytvořil větev, provedl push, sloučil PR.

Licencování Bitbucket Data Center je podle počtu uživatelů (ne repozitářů). Minimální licence pro 50 uživatelů stojí od 1520 dolarů ročně (standardní tarif). Data Center je povinné pro organizace, kde: jsou vyžadovány SLA pro dostupnost, data nemohou opustit zemi (GDPR, 152-FZ), počet vývojářů přesahuje 500 osob nebo je vyžadována integrace s podnikovým LDAP/SAML systémem.

Bitbucket Snippets pro sdílený kód

Bitbucket Snippets — nástroj pro ukládání a sdílení malých fragmentů kódu. Na rozdíl od repozitářů Snippets nemají úplnou historii Git, ale podporují verzování, komentáře a forky. Snippets jsou užitečné pro sdílené konfigurace (docker-compose.yml pro lokální vývoj), SQL migrační skripty a příklady kódu, které nevyžadují plnohodnotný repozitář. Každý Snippet má jedinečnou URL a může být propojen s projektem v Jira.

API Bitbucket pro automatizaci

Bitbucket REST API 2.0 umožňuje programové řízení repozitářů, Pull Requestů, větví a oprávnění. API se používá pro automatizaci pracovních postupů: vytvoření repozitáře ze šablony, hromadná aktualizace oprávnění, získání statistik Pull Request a integrace s externími CI systémy. Rate limit je 1000 požadavků za hodinu pro autentizované uživatele. API podporuje stránkování pomocí parametrů Page a Pagelen pro práci s velkými datovými sadami.