Orbit
Connessione di un repository 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 si connette a Orbit tramite OAuth: autorizzi Kapsule una volta, Orbit elenca i repository che il tuo account Bitbucket può raggiungere, e registra un webhook per repository in modo che ogni push attivi una build. Questa guida copre la connessione, la selezione di un repository, la creazione del progetto, e cosa verificare quando un repository non appare.
Prima di Iniziare
Orbit vede solo quello che vede il tuo account Bitbucket. Per un repository di workspace hai bisogno almeno di accesso in scrittura, e abbastanza permessi per creare un webhook del repository. Se il tuo workspace limita i consumer OAuth di terze parti, un amministratore deve autorizzare Kapsule Orbit prima che la connessione avrà successo.
Step 1: Connetti Bitbucket
- In KPanel, fai clic su Orbit nella barra laterale sinistra.
- Fai clic su New project.
- Lascia la modalità impostata su Import Git Repo.
- Al passaggio 1, fai clic su Connect Bitbucket.
Vieni inviato a Bitbucket per autorizzare il consumer OAuth Kapsule Orbit. Concedi i permessi richiesti e Bitbucket ti riporta a KPanel con i tuoi repository caricati. Il passaggio 1 allora mostra Just connected.
Se l'autorizzazione fallisce, KPanel mostra l'errore che Bitbucket ha restituito. Leggilo piuttosto che riprovare alla cieca: una politica di workspace che blocca e un'autorizzazione annullata si assomigliano ma richiedono correzioni diverse.
Step 2: Seleziona un Repository
I tuoi repository accessibili appaiono come un elenco. Fai clic su Select accanto a quello che vuoi distribuire. I repository privati hanno un badge Private; Orbit distribuisce repository pubblici e privati allo stesso modo.
Se un Repository è Mancante
- Conferma il tuo livello di accesso al repository. L'accesso in lettura non è sufficiente; hai bisogno di accesso in scrittura perché Orbit registri il webhook di cui ha bisogno.
- Verifica che il repository sia in un workspace a cui appartieni realmente, non uno a cui hai solo un collegamento.
- Fai clic su Reconnect Bitbucket al passaggio 1 per eseguire di nuovo il flusso OAuth e aggiornare il token e l'elenco dei repository.
Se il pannello mostra No repos accessible, la concessione è riuscita ma non ha restituito nulla. Riconnetti e conferma che hai approvato gli ambiti del repository.
Step 3: Configura il Tuo Progetto
| Campo | Cosa fa |
|---|---|
| Project Name | Il nome visualizzato in KPanel, per esempio my-app |
| Deploy URL | Il sottodominio sotto kaps.run, quindi my-app diventa my-app.kaps.run |
Fai clic su Create project. Orbit clona il repository, mette in coda la prima build, e ti porta alla panoramica del progetto con il log in streaming.
Lo slug Deploy URL è impostato una volta, al momento della creazione, e non può essere modificato in seguito. Per servire sotto un indirizzo diverso, allega un dominio personalizzato. Vedi Adding a Custom Domain to Your Project.
Distribuzioni Automatiche
Orbit registra un webhook nel tuo repository Bitbucket al momento della creazione del progetto. Dopo di ciò:
- Un push al tuo branch di produzione mette in coda una distribuzione di produzione.
- Un push a qualsiasi altro branch costruisce un'anteprima isolata in
branch-<branch-name>.kaps.run, se Branch previews è abilitato in Settings sotto Runtime. Vedi Branch Preview Deployments in Orbit. - L'eliminazione di un branch mette in pausa il suo ambiente di anteprima, e lo spazio di archiviazione viene recuperato entro circa un giorno.
Non crei o mantieni mai il webhook tu stesso.
L'impostazione CI required checks in Orbit controlla le distribuzioni sui nomi dei job GitHub Actions o una pipeline GitLab. Non controlla su Bitbucket Pipelines. Se hai bisogno che Bitbucket Pipelines decida quando una distribuzione avviene, disattiva le distribuzioni attivate da push per quel branch e fai invece in modo che la tua pipeline chiami un deploy hook al successo. Vedi Triggering Deployments Via Deploy Hooks.
Riconnessione o Disconnessione di Bitbucket
- Fai clic su Orbit, quindi New project.
- Al passaggio 1, fai clic su Reconnect per eseguire di nuovo il flusso OAuth, o Disconnect per rimuovere il collegamento.
La riconnessione è il primo passo corretto ogni volta che l'elenco dei repository si interrompe, perché i token OAuth scadono e la riconnessione ne crea uno nuovo.
La disconnessione mantiene i tuoi progetti e la loro cronologia di distribuzione, e la distribuzione live continua a servire il traffico. Le distribuzioni attivate da push si fermano. Anche i deploy hook si fermano, perché un hook legge l'head del branch attraverso la connessione del provider per decidere cosa costruire.
Letture Correlate
- Deploying Your Project per il ciclo di distribuzione completo, blocchi di distribuzione e approvazioni
- Configuring Your Build Command and Output Directory se la prima build fallisce o pubblica la cartella sbagliata
- Connecting a GitHub Repo e Connecting a GitLab Repo per gli altri provider