Orbit
Verbindung mit einem Bitbucket-Repository
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 verbindet sich mit Orbit über OAuth: Sie autorisieren Kapsule einmalig, Orbit listet die Repositorys auf, die Ihr Bitbucket-Konto erreichen kann, und registriert einen Webhook pro Repository, damit jeder Push einen Build auslöst. Diese Anleitung behandelt die Verbindung, die Auswahl eines Repositorys, die Projekterstellung und was zu überprüfen ist, wenn ein Repository nicht angezeigt wird.
Bevor Sie beginnen
Orbit sieht nur, was Ihr Bitbucket-Konto sieht. Für ein Workspace-Repository benötigen Sie mindestens Schreibzugriff und ausreichende Berechtigungen, um einen Repository-Webhook zu erstellen. Wenn Ihr Workspace OAuth-Consumer von Drittanbietern einschränkt, muss ein Administrator Kapsule Orbit genehmigen, bevor die Verbindung erfolgreich ist.
Schritt 1: Bitbucket verbinden
- Klicken Sie in KPanel auf Orbit in der linken Seitenleiste.
- Klicken Sie auf New project.
- Lassen Sie den Modus auf Import Git Repo eingestellt.
- Klicken Sie in Schritt 1 auf Connect Bitbucket.
Sie werden zu Bitbucket weitergeleitet, um den OAuth-Consumer von Kapsule Orbit zu autorisieren. Erteilen Sie die angeforderten Berechtigungen und Bitbucket leitet Sie mit Ihren geladenen Repositorys zu KPanel zurück. Schritt 1 zeigt dann Just connected.
Wenn die Autorisierung fehlschlägt, zeigt KPanel den Fehler an, den Bitbucket zurückgegeben hat. Lesen Sie ihn, anstatt blindlings zu wiederholen: Eine Workspace-Richtlinienblockierung und eine abgebrochene Autorisierung sehen ähnlich aus, benötigen aber unterschiedliche Lösungen.
Schritt 2: Repository auswählen
Ihre zugänglichen Repositorys werden als Liste angezeigt. Klicken Sie auf Select neben dem Repository, das Sie bereitstellen möchten. Private Repositorys tragen ein Private-Badge; Orbit stellt öffentliche und private Repositorys gleichermaßen bereit.
Wenn ein Repository fehlt
- Bestätigen Sie Ihre Zugriffsstufe auf dem Repository. Lesezugriff ist nicht ausreichend; Sie benötigen Schreibzugriff, damit Orbit den Webhook registrieren kann, den es benötigt.
- Überprüfen Sie, dass sich das Repository in einem Workspace befindet, dem Sie tatsächlich angehören, nicht in einem, zu dem Sie nur einen Link haben.
- Klicken Sie in Schritt 1 auf Reconnect Bitbucket, um den OAuth-Ablauf erneut auszuführen und das Token und die Repository-Liste zu aktualisieren.
Wenn das Panel No repos accessible anzeigt, war die Genehmigung erfolgreich, hat aber nichts zurückgegeben. Verbinden Sie sich erneut und bestätigen Sie, dass Sie die Repository-Bereiche genehmigt haben.
Schritt 3: Konfigurieren Sie Ihr Projekt
| Feld | Was es tut |
|---|---|
| Project Name | Der Anzeigename in KPanel, beispielsweise my-app |
| Deploy URL | Die Subdomain unter kaps.run, also my-app wird zu my-app.kaps.run |
Klicken Sie auf Create project. Orbit klont das Repository, reiht den ersten Build in die Warteschlange ein und leitet Sie zur Projektübersicht mit dem Stream-Log weiter.
Der Deploy URL-Slug wird einmal bei der Erstellung festgelegt und kann später nicht bearbeitet werden. Um unter einer anderen Adresse zu bedienen, fügen Sie eine benutzerdefinierte Domain an. Siehe Adding a Custom Domain to Your Project.
Automatische Bereitstellungen
Orbit registriert einen Webhook auf Ihrem Bitbucket-Repository bei der Projekterstellung. Danach:
- Ein Push zu Ihrem Production-Branch reiht eine Production-Bereitstellung in die Warteschlange ein.
- Ein Push zu jedem anderen Branch erstellt eine isolierte Vorschau bei
branch-<branch-name>.kaps.run, wenn Branch previews in Settings unter Runtime aktiviert ist. Siehe Branch Preview Deployments in Orbit. - Das Löschen eines Branch pausiert seine Vorschau-Umgebung und der Speicher wird innerhalb von etwa einem Tag freigegeben.
Sie erstellen oder verwalten den Webhook selbst nie.
Die Einstellung CI required checks in Orbit steuert Bereitstellungen basierend auf GitHub Actions-Jobnamen oder einer GitLab-Pipeline. Sie steuert nicht basierend auf Bitbucket Pipelines. Wenn Sie Bitbucket Pipelines benötigen, um zu entscheiden, wann eine Bereitstellung erfolgt, deaktivieren Sie Push-ausgelöste Bereitstellungen für diesen Branch und lassen Sie Ihre Pipeline stattdessen bei erfolgreicher Ausführung einen Deploy-Hook aufrufen. Siehe Triggering Deployments Via Deploy Hooks.
Bitbucket erneut verbinden oder trennen
- Klicken Sie auf Orbit, dann auf New project.
- Klicken Sie in Schritt 1 auf Reconnect, um den OAuth-Ablauf erneut auszuführen, oder auf Disconnect, um die Verbindung zu entfernen.
Das Erneute Verbinden ist der richtige erste Schritt, wenn die Repository-Auflistung nicht funktioniert, da OAuth-Token ablaufen und das Erneute Verbinden ein neues Token erstellt.
Das Trennen behält Ihre Projekte und deren Bereitstellungsverlauf bei, und die aktive Bereitstellung bedient weiterhin Traffic. Push-ausgelöste Bereitstellungen werden beendet. Deploy-Hooks werden auch beendet, da ein Hook den Branch-Head über die Provider-Verbindung liest, um zu entscheiden, was zu erstellen ist.
Weiterführende Lektüre
- Deploying Your Project für den vollständigen Deploy-Zyklus, Deploy-Sperren und Genehmigungen
- Configuring Your Build Command and Output Directory, wenn der erste Build fehlschlägt oder den falschen Ordner veröffentlicht
- Connecting a GitHub Repo und Connecting a GitLab Repo für die anderen Provider