Orbit
Connexion d'un référentiel Bitbucket
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 se connecte à Orbit par OAuth : vous autorisez Kapsule une fois, Orbit liste les référentiels auxquels votre compte Bitbucket peut accéder, et il enregistre un webhook par référentiel pour que chaque push déclenche une compilation. Ce guide couvre la connexion, la sélection d'un référentiel, la création du projet et ce qu'il faut vérifier quand un référentiel n'apparaît pas.
Avant de Commencer
Orbit ne voit que ce que votre compte Bitbucket voit. Pour un référentiel d'espace de travail, vous avez besoin au minimum d'un accès en écriture et de permissions suffisantes pour créer un webhook de référentiel. Si votre espace de travail restreint les consommateurs OAuth tiers, un administrateur doit autoriser Kapsule Orbit avant que la connexion ne réussisse.
Étape 1 : Connecter Bitbucket
- Dans KPanel, cliquez sur Orbit dans la barre latérale gauche.
- Cliquez sur New project.
- Laissez le mode défini sur Import Git Repo.
- À l'étape 1, cliquez sur Connect Bitbucket.
Vous êtes envoyé à Bitbucket pour autoriser le consommateur OAuth Kapsule Orbit. Accordez les permissions demandées et Bitbucket vous ramène à KPanel avec vos référentiels chargés. L'étape 1 affiche alors Just connected.
Si l'autorisation échoue, KPanel affiche l'erreur renvoyée par Bitbucket. Lisez-la plutôt que de réessayer aveuglément : une politique d'espace de travail bloquante et une autorisation annulée se ressemblent mais nécessitent des correctifs différents.
Étape 2 : Sélectionner un Référentiel
Vos référentiels accessibles apparaissent sous forme de liste. Cliquez sur Select à côté de celui que vous voulez déployer. Les référentiels privés portent un badge Private ; Orbit déploie les référentiels publics et privés de la même manière.
Si un Référentiel est Manquant
- Confirmez votre niveau d'accès au référentiel. L'accès en lecture ne suffit pas ; vous avez besoin d'un accès en écriture pour qu'Orbit enregistre le webhook dont il a besoin.
- Vérifiez que le référentiel se trouve dans un espace de travail auquel vous appartinez réellement, et non dans un espace pour lequel vous avez seulement un lien.
- Cliquez sur Reconnect Bitbucket à l'étape 1 pour relancer le flux OAuth et actualiser le jeton et la liste des référentiels.
Si le panneau affiche No repos accessible, l'autorisation a réussi mais n'a rien renvoyé. Reconnectez-vous et confirmez que vous avez approuvé les étendues de référentiel.
Étape 3 : Configurer Votre Projet
| Champ | Ce qu'il fait |
|---|---|
| Project Name | Le nom d'affichage dans KPanel, par exemple my-app |
| Deploy URL | Le sous-domaine sous kaps.run, donc my-app devient my-app.kaps.run |
Cliquez sur Create project. Orbit clone le référentiel, met en file d'attente la première compilation, et vous amène à l'aperçu du projet avec le flux du journal.
Le slug de l'URL de déploiement est défini une fois à la création et ne peut pas être modifié ultérieurement. Pour servir à une adresse différente, attachez un domaine personnalisé. Voir Adding a Custom Domain to Your Project.
Déploiements Automatiques
Orbit enregistre un webhook sur votre référentiel Bitbucket lors de la création du projet. Après cela :
- Une poussée vers votre branche de production met en file d'attente un déploiement de production.
- Une poussée vers toute autre branche crée un aperçu isolé à
branch-<branch-name>.kaps.run, si Branch previews est activé dans Settings sous Runtime. Voir Branch Preview Deployments in Orbit. - Supprimer une branche met en pause son environnement d'aperçu, et le stockage est repris environ un jour plus tard.
Vous ne créez jamais ou ne maintenez jamais le webhook vous-même.
Le paramètre CI required checks dans Orbit contrôle les déploiements en fonction des noms de jobs GitHub Actions ou d'un pipeline GitLab. Il ne contrôle pas sur Bitbucket Pipelines. Si vous avez besoin que Bitbucket Pipelines décide quand un déploiement se produit, désactivez les déploiements déclenchés par push pour cette branche et faites plutôt appeler un hook de déploiement par votre pipeline en cas de succès. Voir Triggering Deployments Via Deploy Hooks.
Reconnecter ou Déconnecter Bitbucket
- Cliquez sur Orbit, puis sur New project.
- À l'étape 1, cliquez sur Reconnect pour relancer le flux OAuth, ou sur Disconnect pour supprimer le lien.
Reconnecter est la bonne première étape chaque fois que le listing des référentiels se casse, car les tokens OAuth expirent et reconnecter en crée un nouveau.
La déconnexion conserve vos projets et leur historique de déploiement, et le déploiement actif continue à servir le trafic. Les déploiements déclenchés par push s'arrêtent. Les hooks de déploiement s'arrêtent également, car un hook lit la tête de branche via la connexion du fournisseur pour décider ce qu'il faut construire.
Lectures Connexes
- Deploying Your Project pour le cycle complet de déploiement, les verrous de déploiement et les approbations
- Configuring Your Build Command and Output Directory si la première compilation échoue ou publie le mauvais dossier
- Connecting a GitHub Repo et Connecting a GitLab Repo pour les autres fournisseurs