Orbit
Een Bitbucket-repository verbinden
Bitbucket connects to Orbit through OAuth: you authorise Kapsule once, Orbit lists the repositories your Bitbucket account can reach, and it registers a webhook per repository so every push triggers…
Bitbucket maakt verbinding met Orbit via OAuth: je autoriseert Kapsule eenmaal, Orbit geeft een lijst van de repositories die je Bitbucket-account kan bereiken, en het registreert een webhook per repository zodat elke push een build triggert. Deze gids behandelt de verbinding, het selecteren van een repository, het maken van het project, en wat je moet controleren als een repository niet verschijnt.
Voordat je begint
Orbit ziet alleen wat je Bitbucket-account ziet. Voor een workspace-repository heb je minimaal schrijftoegang nodig, en voldoende machtiging om een repository-webhook te maken. Als je workspace OAuth-consumenten van derden beperkt, moet een beheerder Kapsule Orbit goedkeuren voordat de verbinding slaagt.
Stap 1: Bitbucket verbinden
- Klik in KPanel op Orbit in de linker zijbalk.
- Klik op New project.
- Laat de modus ingesteld op Import Git Repo.
- Klik op stap 1 op Connect Bitbucket.
Je wordt naar Bitbucket gestuurd om de Kapsule Orbit OAuth-consument goed te keuren. Verleen de gevraagde machtigingen en Bitbucket brengt je terug naar KPanel met je repositories geladen. Stap 1 geeft dan Just connected weer.
Als de autorisatie mislukt, toont KPanel de fout die Bitbucket heeft geretourneerd. Lees deze aandachtig in plaats van blindelings opnieuw te proberen: een werkruimtebeleid-blokkade en een geannuleerde autorisatie zien er vergelijkbaar uit maar vereisen verschillende oplossingen.
Stap 2: Selecteer een repository
Je toegankelijke repositories verschijnen als een lijst. Klik Select naast degene die je wilt implementeren. Privérepositories hebben een Private-badge; Orbit implementeert zowel openbare als privérepositories.
Als een repository ontbreekt
- Bevestig je toegangsniveau op de repository. Leestoegang is niet voldoende; je hebt schrijftoegang nodig zodat Orbit de webhook kan registreren die het nodig heeft.
- Controleer of de repository in een workspace staat waar je echt bij hoort, niet een waar je alleen een link naar hebt.
- Klik op Reconnect Bitbucket op stap 1 om de OAuth-flow opnieuw uit te voeren en het token en de repository-lijst te vernieuwen.
Als het paneel No repos accessible toont, is de toekenning geslaagd maar heeft niets geretourneerd. Maak opnieuw verbinding en bevestig dat je de repository-scopes hebt goedgekeurd.
Stap 3: Configureer je project
| Veld | Wat het doet |
|---|---|
| Project Name | De weergavenaam in KPanel, bijvoorbeeld my-app |
| Deploy URL | Het subdomein onder kaps.run, dus my-app wordt my-app.kaps.run |
Klik Create project. Orbit klont de repository, plaatst de eerste build in de wachtrij, en brengt je naar het projectoverzicht met de log streaming.
De Deploy URL slug wordt eenmaal ingesteld, bij maken, en kan later niet worden bewerkt. Om onder een ander adres te serveren, voeg je een aangepast domein toe. Zie Adding a Custom Domain to Your Project.
Automatische implementaties
Orbit registreert een webhook op je Bitbucket-repository bij het maken van het project. Daarna:
- Een push naar je productiebranch plaatst een productie-implementatie in de wachtrij.
- Een push naar een ander branch bouwt een geïsoleerde preview op
branch-<branch-name>.kaps.run, als Branch previews is ingeschakeld in Settings onder Runtime. Zie Branch Preview Deployments in Orbit. - Het verwijderen van een branch pauzert de bijbehorende preview-omgeving, en de opslag wordt binnen ongeveer een dag teruggeclaimed.
Je maakt of onderhoudt de webhook zelf nooit.
De instelling CI required checks in Orbit gated implementaties op GitHub Actions-jobnamen of een GitLab-pipeline. Het gated niet op Bitbucket Pipelines. Als je Bitbucket Pipelines nodig hebt om te bepalen wanneer een implementatie plaatsvindt, schakel je push-geactiveerde implementaties voor die branch uit en laat je je pipeline in plaats daarvan een deploy hook aanroepen bij succes. Zie Triggering Deployments Via Deploy Hooks.
Bitbucket opnieuw verbinden of ontkoppelen
- Klik op Orbit, vervolgens New project.
- Klik op stap 1 op Reconnect om de OAuth-flow opnieuw uit te voeren, of Disconnect om de verbinding te verwijderen.
Opnieuw verbinden is de juiste eerste stap wanneer repository-vermelding stuk gaat, omdat OAuth-tokens verlopen en opnieuw verbinden een nieuw token oplevert.
Ontkoppelen houdt je projecten en hun implementatiegeschiedenis, en de live implementatie blijft verkeer serveren. Push-geactiveerde implementaties stoppen. Deploy hooks stoppen ook, omdat een hook de branch-head via de providerverbinding leest om te bepalen wat er moet worden gebouwd.
Gerelateerde informatie
- Deploying Your Project voor de volledige implementatiecyclus, implementatievergrendelingen en goedkeuringen
- Configuring Your Build Command and Output Directory als de eerste build mislukt of de verkeerde map publiceert
- Connecting a GitHub Repo en Connecting a GitLab Repo voor de andere providers