Orbit
Che cos'è Orbit?
Orbit is Kapsule's git-based deployment platform: connect a repository, push a commit, and your app builds and goes live on its own URL with a free SSL certificate, no server to configure and no…
Orbit è la piattaforma di distribuzione basata su git di Kapsule: connetti un repository, fai un commit e la tua app si costruisce e va live su un URL proprio con certificato SSL gratuito, senza server da configurare e senza script di distribuzione da scrivere.
Tutto quello che distribuisci con Orbit si chiama progetto. Un progetto ha un URL di produzione, una cronologia completa delle distribuzioni con rollback in un clic, ambienti di staging e preview dei branch opzionali, e sue proprie impostazioni di build, variabili d'ambiente, domini e edge function.
Lo raggiungi da Orbit nella barra laterale di KPanel, oppure direttamente su /orbit.
Cosa fa Orbit per te
- Spingere per distribuire. Fai push al tuo branch di produzione e Orbit clona, installa, costruisce, pacchettizza l'output e inizia a servirlo. La maggior parte dei progetti è live in pochi minuti.
- Rollback istantaneo. L'artefatto di ogni build riuscita viene conservato. Il rollback promuove una versione già costruita, quindi impiega secondi e non riesegue mai una build.
- Ambienti multipli. Produzione, un ambiente di staging opzionale e un ambiente di preview automatico per ogni branch che fai push.
- Pipeline di build. npm, yarn e pnpm vengono rilevati dal tuo lockfile. Il comando di installazione, il comando di build, la directory di output, la directory radice e la versione di Node.js sono tutti personalizzabili.
- SSL gratuito, ovunque. Il tuo URL
kaps.rune ogni dominio personalizzato che colleghi ricevono un certificato fornito automaticamente. - Lock e approvazioni di distribuzione. Blocca la produzione durante un incidente oppure richiedi l'approvazione umana per ogni distribuzione attivata da push.
- Un limite di spesa su ogni progetto. Un limite predefinito di US$63.16 di spesa in eccesso al mese, con avvisi email al 50% e all'80%, quindi un ciclo di build sfuggito di mano non può produrre una fattura a sorpresa.
L'URL del tuo progetto
Quando crei un progetto scegli uno slug di Deploy URL, e Orbit assegna al progetto un sottodominio sotto kaps.run. Un progetto con lo slug my-app viene servito su my-app.kaps.run.
I preview dei branch ricevono il proprio hostname derivato dal nome del branch, nella forma branch-<branch-name>.kaps.run. I caratteri non alfanumerici nel nome del branch diventano trattini e il nome viene troncato a 48 caratteri, quindi un branch chiamato feat/new-checkout ha preview su branch-feat-new-checkout.kaps.run.
Puoi collegare il tuo dominio in qualsiasi momento dalla scheda Domain del progetto. Vedi Aggiungere un dominio personalizzato al tuo progetto.
Lo slug dell'URL di distribuzione viene scelto una sola volta, quando viene creato il progetto, e non è modificabile successivamente. Scegli qualcosa che sei felice di mantenere, oppure collega un dominio personalizzato in seguito e usalo come indirizzo pubblico.
Provider Git
Orbit si connette a GitHub, GitLab e Bitbucket. Ogni provider viene connesso una volta per account e può quindi essere utilizzato per un numero illimitato di progetti. Procedure dettagliate:
- Connessione di un repository GitHub
- Connessione di un repository GitLab
- Connessione di un repository Bitbucket
Puoi anche avviare un progetto da un modello di avvio invece che dal tuo repository. Nella schermata Nuovo progetto, passa da Import Git Repo a Start from Template e scegli uno degli stack predisposti (Next.js, Astro, Remix, SvelteKit, Nuxt 3, oppure un'API REST Express). Orbit copia il modello e lo distribuisce immediatamente.
Per iniziare
- Fai clic su Orbit nella barra laterale di KPanel.
- Fai clic su New project.
- Connetti il tuo provider Git, quindi scegli il repository che desideri distribuire.
- Compila Project Name e Deploy URL.
- Fai clic su Create project. La tua prima build inizia subito e arrivi alla panoramica del progetto.
Orientarsi in un progetto
Una volta che un progetto esiste, le sue pagine sono raggruppate in cinque sezioni nella parte superiore del progetto:
| Gruppo | Pagine | Cosa contiene |
|---|---|---|
| Overview | Overview, Docs | Stato live, ultima build, distribuzioni recenti, salute del progetto, il tuo README del repository |
| Deployments | Deployments, Releases, Branches, Pipeline | Cronologia completa della build, tag di release, stato per branch, visualizzazione della pipeline di build |
| Observability | Analytics, Web Vitals, Build Insights, Activity, Timeline, Status page | Utilizzo e eccedenze, Core Web Vitals degli utenti reali, tendenze delle prestazioni di build, trail di audit, pagina di stato pubblica |
| Configure | Environments, Env vars, Domain, Crons, Edge functions, Hooks, Webhooks | Tutto quello che configuri una volta e raramente tocchi di nuovo |
| Settings | Settings | Impostazioni di build, interruttori di runtime, sicurezza, notifiche, limiti di utilizzo, zona pericolo |
Pagine Orbit a livello di account
Alcune pagine si trovano al di sopra dei singoli progetti, raggiungibili dai pulsanti sull'indice Orbit in /orbit:
- Mission control (
/orbit/mission-control): una visualizzazione console live di ogni progetto contemporaneamente. - Queue (
/orbit/queue): ogni build attualmente in esecuzione o in attesa, su tutti i tuoi progetti. - Usage (
/orbit/usage): minuti di build e larghezza di banda per l'account. - Env groups (
/orbit/env-groups): variabili condivise tra più progetti contemporaneamente. - Tokens (
/orbit/tokens): token di accesso API per pipeline CI/CD. - Insights e Search: analitiche di build tra progetti, e ricerca tra progetti e distribuzioni.
Piani e limiti
Orbit ha tre piani: Launch (gratuito per sempre, nessuna carta richiesta), Liftoff a US$12.00/mese, e Apex a US$30.00/mese. Differiscono nel numero di progetti che puoi eseguire, quanti ambienti può avere ogni progetto, e i tuoi minuti di build mensili e la larghezza di banda.
Posti illimitati nel team e uso commerciale sono inclusi su ogni piano, incluso quello gratuito. Il traffico proveniente da attacchi denial-of-service non viene mai conteggiato rispetto alla tua larghezza di banda.
Fai clic su See Plans sull'indice Orbit per confrontare e cambiare. La suddivisione completa è in Limiti del piano Orbit.
Il piano Launch gratuito è veramente gratuito piuttosto che una prova. Non ha scadenza, nessun requisito di carta, e l'uso commerciale è consentito. È una dimora permanente ragionevole per un singolo sito piccolo.