Orbit
Een GitLab-opslagplaats verbinden
GitLab connects to Orbit through OAuth rather than an installed app: you authorise Kapsule once, Orbit lists the projects your GitLab account can reach, and it registers a webhook per repository so…
GitLab verbindt met Orbit via OAuth in plaats van een geïnstalleerde app: u autoriseert Kapsule eenmaal, Orbit toont de projecten die uw GitLab-account kan bereiken, en het registreert een webhook per repository zodat elke push een build activeert. Deze gids behandelt de verbinding, het selecteren van een repository, het conditioneren van implementaties op uw GitLab-pijplijn, en de gebruikelijke redenen waarom een repository niet verschijnt.
Voordat U Begint
Orbit kan alleen GitLab-projecten zien die uw eigen account kan zien. Voor een groepsproject hebt u ten minste Developer-toegang nodig, en u moet voldoende machtigingen hebben om een webhook op de repository te maken. Als uw GitLab-instantie uitgaande webhooks beperkt, is die beperking hier ook van toepassing.
Stap 1: GitLab Verbinden
- Klik in KPanel op Orbit in de linker zijbalk.
- Klik op New project.
- Laat de modus ingesteld op Import Git Repo.
- Klik in stap 1 op Connect GitLab.
U wordt naar GitLab gestuurd om de Kapsule Orbit-toepassing goed te keuren. Goedkeuren de aangevraagde bereiken en GitLab brengt u terug naar KPanel met uw repositories geladen. Stap 1 toont dan Just connected.
Als de verbinding mislukt, toont KPanel de fout die GitLab heeft geretourneerd in plaats van een generiek bericht. Lees dit voordat u het opnieuw probeert: een weigeringsbereik en een verlopen autorisatie vereisen verschillende oplossingen.
Stap 2: Een Repository Selecteren
Uw toegankelijke repositories verschijnen als een lijst. Klik op Select naast degene die u wilt. Privérepositories dragen een Private-badge; Orbit implementeert openbare en privérepositories.
Als een Repository Ontbreekt
- Controleer uw rol op het project. Reporter-toegang is niet voldoende; u hebt ten minste Developer nodig.
- Als het project tot een groep behoort, bevestig dat uw lidmaatschap op de groep of het project zelf staat, niet alleen op een vooroudergroep met een beperkte rol.
- Klik op Reconnect GitLab in stap 1 om de OAuth-stroom opnieuw uit te voeren. Dit vernieuwt het token en leest uw projectlijst opnieuw.
Als het paneel No repos accessible toont, is de OAuth-toekenning doorgegaan maar heeft niets geretourneerd. Verbind opnieuw en controleer of u de repository-bereiken hebt goedgekeurd in plaats van een gereduceerde set.
Stap 3: Uw Project Configureren
| 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 op Create project. Orbit klont de repository, plaatst de eerste build in de wachtrij en brengt u naar het projectoverzicht.
De Deploy URL-slug is vast bij aanmaak en kan later niet worden gewijzigd. Om onder een ander adres te publiceren, voegt u in plaats daarvan een aangepast domein toe. Zie Adding a Custom Domain to Your Project.
Automatische Implementaties
Orbit registreert een webhook op uw GitLab-repository wanneer het project wordt aangemaakt. Daarna:
- Een push naar uw productietak plaatst een productie-implementatie in de wachtrij.
- Een push naar elke andere tak bouwt een geïsoleerd voorbeeld 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 tak pauzeert de preview-omgeving, en de opslag wordt binnen ongeveer een dag teruggewonnen.
U hoeft de webhook niet met de hand te maken of te onderhouden.
Wachten Op Uw GitLab CI-Pijplijn
Als u tests in GitLab CI uitvoert, kan Orbit de implementatie inhouden totdat de pijplijn slaagt.
- Open het project, vervolgens Settings.
- Zoek CI required checks.
- Voer een niet-lege waarde in en sla op.
Op GitLab wordt de waarde zelf niet vergeleken met jobnamen: elke niet-lege waarde zegt aan Orbit dat het moet wachten tot de volledige pijplijn slaagt. Een pijplijnfout annuleert de Orbit-implementatie automatisch. Dit is alleen van toepassing op push-geactiveerde implementaties op de productietak.
Dit is waar de twee providers verschillen. GitHub matcht de waarde tegen benoemde Actions-jobs; GitLab behandelt elke waarde als "wacht op de volledige pijplijn". Als u instellingen kopieert tussen een GitHub- en een GitLab-project, verwacht dan niet dat hetzelfde veld identiek werkt.
GitLab Opnieuw Verbinden Of Verbreken
- Klik op Orbit, vervolgens New project.
- Klik in stap 1 op Reconnect om de OAuth-stroom opnieuw uit te voeren, of Disconnect om de link te verwijderen.
Reconnect is de juiste eerste stap wanneer repository-vermelding niet meer werkt: OAuth-tokens verlopen, en opnieuw verbinden maakt een verse aan.
Verbreken behoudt uw projecten en hun implementatiegeschiedenis, en de live-implementatie blijft verkeer serveren. Wat stopt, is push-geactiveerde implementatie. Deploy hooks werken ook niet meer, omdat een hook de branchhead via de providerverbinding moet lezen om te weten wat er moet worden gemaakt.
Gerelateerde Lezing
- Deploying Your Project voor de volledige implementatiecyclus, implementatievergrendelingen en goedkeuringen
- Troubleshooting Failed Builds als de eerste build niet slaagt
- Connecting a GitHub Repo en Connecting a Bitbucket Repo voor de andere providers