Orbit
Trasferimento di un progetto Orbit
A project can be moved to a different Kapsule account without redeploying it or rebuilding its configuration. The move is email-verified, reversible only by transferring it back, and takes…
Un progetto può essere spostato in un diverso account Kapsule senza ridistribuirlo o ricostruirne la configurazione. Lo spostamento è verificato via email, reversibile solo trasferendolo indietro, e porta con sé tutto: ambienti, distribuzioni, variabili d'ambiente, webhook e impostazioni.
Quando Trasferire un Progetto
- Un'agenzia consegna un sito finito al cliente che ne sarà proprietario d'ora in poi.
- Un progetto si sposta da un account personale a un account aziendale.
- Un team si divide, e un progetto va con le persone che lo mantengono.
Trasferire non è lo stesso che aggiungere un collaboratore. Se desideri che qualcuno lavori sul progetto mentre lo mantieni tu, aggiungilo al team del progetto invece: vedi Impostazioni del Progetto Orbit.
Avvio di un Trasferimento
Apri Orbit, fai clic sul progetto, scegli Settings e trova Transfer project nella Danger zone. La scheda descrive cosa accade: il progetto si sposta in un altro account Kapsule, il destinatario riceve un'email per accettare e tutti i dati si trasferiscono con il progetto.
- Inserisci l'indirizzo email del proprietario dell'account ricevente.
- Fai clic su Initiate transfer.
La scheda conferma con Transfer email sent e quindi mostra Transfer pending, indicando chi sta aspettando e quando scade.

Solo i proprietari dell'account possono trasferire un progetto. Se il tuo ruolo è admin, developer o viewer, la scheda te lo comunica e il campo non è disponibile. Chiedi a un proprietario di farlo.
Un Trasferimento in Sospeso alla Volta
L'avvio di un nuovo trasferimento sostituisce qualsiasi trasferimento già in sospeso per quel progetto. Il link precedente smette di funzionare immediatamente, che è anche il modo più veloce per correggere un errore di battitura nell'indirizzo: avvia di nuovo con quello corretto.
Cosa Vede il Destinatario
Il destinatario riceve un'email con un link di accettazione. Aprirlo mostra una pagina di conferma intitolata Accept project transfer, che indica l'account mittente, il progetto e il suo slug, e l'indirizzo email a cui è stato inviato il trasferimento.
Sotto, la pagina dichiara chiaramente l'ambito: tutti gli ambienti, le distribuzioni, le variabili d'ambiente, i webhook e le impostazioni verranno trasferiti, e quando il link scade.
Facendo clic su Accept transfer completi lo spostamento. La pagina legge quindi Transfer complete e ti reindirizza nel progetto, che ora è nel tuo account.
Il Destinatario Deve Essere Connesso Con Quell'Indirizzo
L'accettazione controlla l'email dell'utente connesso rispetto all'indirizzo a cui è stato inviato il trasferimento. Se non corrispondono, la richiesta viene rifiutata con un messaggio che indica l'indirizzo a cui è stato inviato e ti chiede di accedere con quell'account.
Questa è la proprietà di sicurezza che rende l'intera cosa sicura: conoscere il link non è sufficiente. Devi essere la persona a cui era indirizzato.
Se il destinatario non ha ancora un account Kapsule, deve crearne uno con quell'indirizzo esatto in primo luogo, quindi aprire di nuovo il link.
La Finestra di 48 Ore
Un link di trasferimento scade 48 ore dopo la creazione. Dopo di che, la pagina di accettazione mostra che il trasferimento non è più valido e fornisce il motivo: expired.
La stessa pagina gestisce gli altri stati terminali, quindi un destinatario che fa clic su un link vecchio viene informato se è già stato accettato, annullato o semplicemente scaduto, piuttosto che visualizzare un errore generico.
Se un trasferimento scade, avvia uno nuovo. Non c'è modo di estendere un link esistente.
Annullamento di un Trasferimento in Sospeso
Mentre un trasferimento è in sospeso, la scheda offre Cancel. L'annullamento invalida il link immediatamente, quindi la pagina di accettazione lo rifiuterà anche se il destinatario ha l'email davanti a sé.
Annulla non appena ti rendi conto che un trasferimento è andato all'indirizzo sbagliato. Non fare affidamento sulla scadenza di 48 ore per farlo per te.
Cosa Si Sposta e Cosa No
Tutto ciò che è allegato al progetto si sposta con esso:
- Ogni ambiente, inclusi staging e anteprime.
- La cronologia completa della distribuzione.
- Variabili d'ambiente, inclusi i segreti.
- Webhook, cron job, edge function e impostazioni.
- Domini personalizzati collegati al progetto.
Le variabili d'ambiente si spostano con il progetto, segreti inclusi. Chiunque possieda il progetto dopo il trasferimento può leggerle e modificarle. Prima di trasferire un progetto a una parte di cui non ti fidi completamente, ruota ogni credenziale in esso: chiavi API, password del database, token di terze parti. Vedi Variabili d'Ambiente in Orbit.
Due cose vale la pena considerare separatamente:
- La registrazione del dominio. Se il progetto serve un dominio personalizzato registrato nel tuo account Kapsule, il dominio non si sposta con il progetto. Trasferisci o reindirizza il dominio come passaggio separato: vedi Trasferimento di un Dominio in Uscita.
- La connessione del repository. Il progetto continua a puntare allo stesso repository. L'account ricevente ha bisogno del proprio accesso a quel repository affinché le future distribuzioni funzionino, quindi pianifica il passaggio del repository allo stesso tempo.
Dopo il Trasferimento
Dal lato del mittente il progetto semplicemente scompare dall'elenco di Orbit. Non c'è una copia archiviata, e annullarlo significa chiedere al nuovo proprietario di trasferirlo indietro.
Dal lato del destinatario il progetto appare nel loro elenco di Orbit, ancora distribuito e ancora che serve il traffico. Non è necessario ridistribuire nulla.
La prima cosa che il nuovo proprietario dovrebbe fare è controllare l'utilizzo del progetto rispetto al proprio piano. I minuti di compilazione e le indennità di larghezza di banda sono account-wide, quindi un progetto occupato cambia i numeri su entrambi i lati: vedi Limiti del Piano Orbit.
Trasferimento Via API
I trasferimenti possono anche essere guidati a livello di programmazione: l'avvio, l'annullamento e il controllo dello stato sono tutti disponibili come endpoint, documentati nel riferimento API in-panel. Vedi Token API di Orbit e API REST. Si applicano le stesse regole, inclusa l'avvio solo per proprietari e l'accettazione verificata via email.
Risoluzione dei Problemi
Il campo di trasferimento non è disponibile. Non sei un proprietario dell'account.
Il destinatario dice che il link non funziona. Controlla tre cose: se è scaduto, se è stato annullato o sostituito da un trasferimento più recente, e se è connesso con l'indirizzo esatto a cui è stato inviato.
Il destinatario non ha un account Kapsule. Deve iscriversi con l'indirizzo a cui è stato inviato il trasferimento, quindi riaprire il link.
Le distribuzioni del progetto si sono fermate dopo il trasferimento. Il nuovo account non ha accesso al repository. Ricollegalo: vedi Connessione di un Repository GitHub.
Un dominio personalizzato ha smesso di risolversi. Il dominio è ancora nell'account vecchio. Reindirizza o trasferiscilo.
Dove Andare Dopo
- Impostazioni del Progetto Orbit per collaboratori, archiviazione e il resto della danger zone.
- Variabili d'Ambiente in Orbit per quello che ruotare prima di consegnare.
- Limiti del Piano Orbit per le indennità dell'account ricevente.