Orbit
Connessione di un repository GitLab
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 si collega a Orbit tramite OAuth anziché un'app installata: autorizzi Kapsule una volta, Orbit elenca i progetti che il tuo account GitLab può raggiungere e registra un webhook per ogni repository in modo che ogni push attivi una build. Questa guida copre la connessione, la selezione di un repository, il controllo dei deploy sulla tua pipeline GitLab e i motivi comuni per cui un repository non viene visualizzato.
Prima di Iniziare
Orbit può vedere solo i progetti GitLab che il tuo account può vedere. Per un progetto di proprietà di un gruppo hai bisogno di almeno accesso Developer, e hai bisogno di permessi sufficienti per creare un webhook nel repository. Se la tua istanza GitLab limita i webhook in uscita, questa limitazione si applica anche qui.
Step 1: Connetti GitLab
- In KPanel, fai clic su Orbit nella barra laterale sinistra.
- Fai clic su New project.
- Lascia la modalità impostata su Import Git Repo.
- Nel passaggio 1, fai clic su Connect GitLab.
Sei inviato a GitLab per autorizzare l'applicazione Kapsule Orbit. Approva gli scope richiesti e GitLab ti riporta a KPanel con i tuoi repository caricati. Il passaggio 1 mostra quindi Just connected.
Se la connessione non riesce, KPanel mostra l'errore restituito da GitLab anziché un messaggio generico. Leggilo prima di riprovare: un rifiuto di scope e un'autorizzazione scaduta richiedono correzioni diverse.
Step 2: Seleziona un Repository
I tuoi repository accessibili appaiono come un elenco. Fai clic su Select accanto a quello che desideri. I repository privati hanno un badge Private; Orbit distribuisce repository sia pubblici che privati.
Se un Repository È Mancante
- Controlla il tuo ruolo nel progetto. L'accesso Reporter non è sufficiente; hai bisogno di almeno Developer.
- Se il progetto appartiene a un gruppo, conferma che la tua iscrizione è nel gruppo o nel progetto stesso, non solo in un gruppo antenato con un ruolo limitato.
- Fai clic su Reconnect GitLab nel passaggio 1 per rieseguire il flusso OAuth. Questo aggiorna il token e rilegge l'elenco dei tuoi progetti.
Se il pannello mostra No repos accessible, la concessione OAuth è andata a buon fine ma non ha restituito nulla. Riconnetti e verifica di aver approvato gli scope del repository anziché un set ridotto.
Step 3: Configura il Tuo Progetto
| Campo | Cosa fa |
|---|---|
| Project Name | Il nome visualizzato in KPanel, ad 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.
Lo slug dell'URL di distribuzione è fisso alla creazione e non può essere modificato in seguito. Per pubblicare sotto un indirizzo diverso, collega invece un dominio personalizzato. Vedi Adding a Custom Domain to Your Project.
Distribuzioni Automatiche
Orbit registra un webhook nel tuo repository GitLab quando il progetto viene creato. Successivamente:
- Un push al tuo ramo di produzione mette in coda una distribuzione di produzione.
- Un push su qualsiasi altro ramo costruisce un'anteprima isolata su
branch-<branch-name>.kaps.run, se Branch previews è abilitato in Settings sotto Runtime. Vedi Branch Preview Deployments in Orbit. - L'eliminazione di un ramo mette in pausa il suo ambiente di anteprima e lo spazio di archiviazione viene recuperato entro circa un giorno.
Non crei o mantieni il webhook manualmente.
In Attesa della Tua Pipeline GitLab CI
Se esegui test in GitLab CI, Orbit può trattenere la distribuzione fino al successo della pipeline.
- Apri il progetto, quindi Settings.
- Trova CI required checks.
- Inserisci un valore qualsiasi non vuoto e salva.
Su GitLab, il valore stesso non viene confrontato con i nomi dei job: un valore qualsiasi non vuoto dice a Orbit di attendere il successo della intera pipeline. Un errore della pipeline annulla automaticamente la distribuzione di Orbit. Questo si applica solo ai deploy attivati da push sul ramo di produzione.
Qui è dove i due provider differiscono. GitHub confronta il valore con i job Actions denominati; GitLab tratta un valore qualsiasi come "attendi l'intera pipeline". Se stai copiando le impostazioni tra un progetto GitHub e un progetto GitLab, non aspettarti che lo stesso campo si comporti in modo identico.
Riconnessione o Disconnessione da GitLab
- Fai clic su Orbit, quindi su New project.
- Nel passaggio 1, fai clic su Reconnect per rieseguire il flusso OAuth, o su Disconnect per rimuovere il collegamento.
La riconnessione è la mossa giusta come primo tentativo ogni volta che l'elenco dei repository smette di funzionare: i token OAuth scadono e la riconnessione ne conia uno nuovo.
La disconnessione mantiene i tuoi progetti e la loro cronologia di distribuzione, e la distribuzione dal vivo continua a servire il traffico. Quello che si interrompe è il deploy attivato da push. I deploy hook smettono di funzionare anche, perché un hook deve leggere il ramo head attraverso la connessione del provider per sapere cosa costruire.
Letture Correlate
- Deploying Your Project per il ciclo di distribuzione completo, i blocchi di distribuzione e le approvazioni
- Troubleshooting Failed Builds se la prima build non riesce
- Connecting a GitHub Repo e Connecting a Bitbucket Repo per gli altri provider