Orbit
Transferência de um Projeto 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…
Um projeto pode ser movido para uma conta Kapsule diferente sem reimplementá-lo ou reconstruir a sua configuração. A mudança é verificada por email, reversível apenas transferindo-o de volta, e leva tudo consigo: ambientes, implementações, variáveis de ambiente, webhooks e configurações.
Quando Transferir um Projeto
- Uma agência entregando um site terminado ao cliente que o possuirá a partir de agora.
- Um projeto mudando de uma conta pessoal para uma conta de empresa.
- Uma equipa a dividir-se, e um projeto a acompanhar as pessoas que o mantêm.
Transferir não é o mesmo que adicionar um colaborador. Se quer que alguém trabalhe no projeto enquanto o mantém, adicione-o à equipa do projeto em vez disso: consulte Orbit Project Settings.
Iniciar uma Transferência
Abra Orbit, clique no projeto, escolha Settings, e encontre Transfer project na Danger zone. O cartão descreve o que acontece: o projeto move-se para outra conta Kapsule, o destinatário recebe um email para aceitar, e todos os dados transferem-se com o projeto.
- Digite o endereço de email do proprietário da conta de receção.
- Clique em Initiate transfer.
O cartão confirma com Transfer email sent e depois mostra Transfer pending, nomeando quem está à espera e quando expira.

Apenas proprietários de contas podem transferir um projeto. Se a sua função é admin, developer ou viewer, o cartão diz-lhe isso e o campo fica indisponível. Peça a um proprietário para o fazer.
Uma Transferência Pendente de Cada Vez
Iniciar uma nova transferência substitui qualquer transferência já pendente para esse projeto. A ligação anterior deixa de funcionar imediatamente, que é também a forma mais rápida de corrigir um erro de digitação no endereço: inicie novamente com o correto.
O Que o Destinatário Vê
O destinatário recebe um email com uma ligação de aceitação. Abri-la mostra uma página de confirmação com o título Accept project transfer, nomeando a conta de envio, o projeto e o seu slug, e o endereço de email para o qual a transferência foi enviada.
Abaixo, a página apresenta o âmbito de forma clara: todos os ambientes, implementações, variáveis de ambiente, webhooks e configurações serão transferidos, e quando a ligação expira.
Clicar em Accept transfer completa a mudança. A página então mostra Transfer complete e redireciona-o para o projeto, que está agora na sua conta.
O Destinatário Deve Estar Ligado Com Esse Endereço
A aceitação verifica o email do utilizador ligado em relação ao endereço para o qual a transferência foi enviada. Se não corresponderem, o pedido é recusado com uma mensagem nomeando o endereço para o qual foi enviado e pedindo-lhe que se ligue com essa conta.
Essa é a propriedade de segurança que torna tudo isso seguro: conhecer a ligação não é suficiente. Tem de ser a pessoa para a qual foi endereçada.
Se o destinatário ainda não tem uma conta Kapsule, precisa de criar uma com esse endereço exato primeiro, depois abrir a ligação novamente.
A Janela de 48 Horas
Uma ligação de transferência expira 48 horas após ser criada. Depois disso a página de aceitação mostra que a transferência já não é válida e dá a razão: expired.
A mesma página lida com os outros estados terminais, por isso um destinatário que clica numa ligação antiga é informado se já foi aceite, cancelada, ou simplesmente expirou, em vez de ver um erro genérico.
Se uma transferência expirar, inicie uma nova. Não há forma de estender uma ligação existente.
Cancelar uma Transferência Pendente
Enquanto uma transferência está pendente, o cartão oferece Cancel. Cancelar invalida a ligação imediatamente, por isso a página de aceitação recusá-la-á mesmo que o destinatário tenha o email aberto à sua frente.
Cancele assim que perceba que uma transferência foi para o endereço errado. Não confie na expiração de 48 horas para o fazer por si.
O Que Se Move e O Que Não Se Move
Tudo o que está anexado ao projeto move-se com ele:
- Todo o ambiente, incluindo staging e previews.
- O histórico completo de implementações.
- Variáveis de ambiente, incluindo secrets.
- Webhooks, cron jobs, edge functions e configurações.
- Domínios personalizados anexados ao projeto.
As variáveis de ambiente movem-se com o projeto, secrets incluídos. Qualquer pessoa que possua o projeto após a transferência pode lê-las e alterá-las. Antes de transferir um projeto para uma parte em que não confia completamente, rode todas as credenciais nele: chaves API, palavras-passe de base de dados, tokens de terceiros. Consulte Environment Variables in Orbit.
Duas coisas que vale a pena pensar separadamente:
- O registo de domínio. Se o projeto serve um domínio personalizado registado na sua conta Kapsule, o domínio não se move com o projeto. Transfira ou reaponte o domínio como um passo separado: consulte Transferring a Domain Out.
- A ligação do repositório. O projeto continua a apontar para o mesmo repositório. A conta de receção precisa do seu próprio acesso a esse repositório para que futuras implementações funcionem, por isso planeie a transferência do repositório ao mesmo tempo.
Após a Transferência
Do lado do remetente o projeto simplesmente desaparece da lista Orbit. Não há cópia arquivada, e desfazer significa pedir ao novo proprietário para transferi-lo de volta.
Do lado do destinatário o projeto aparece na sua lista Orbit, ainda implementado e ainda a servir tráfego. Nada precisa de ser reimplementado.
A primeira coisa que o novo proprietário deve fazer é verificar a utilização do projeto em relação ao seu plano. As permissões de minutos de construção e largura de banda são abrangentes a nível de conta, por isso um projeto ocupado muda os números em ambos os lados: consulte Orbit Plan Limits.
Transferir Via a API
As transferências também podem ser conduzidas programaticamente: initiate, cancel, e check status estão todos disponíveis como endpoints, documentados na referência API no painel. Consulte Orbit API Tokens and the REST API. As mesmas regras aplicam-se, incluindo iniciação apenas pelo proprietário e aceitação verificada por email.
Resolução de Problemas
O campo de transferência está indisponível. Não é um proprietário de conta.
O destinatário diz que a ligação não funciona. Verifique três coisas: se expirou, se foi cancelada ou substituída por uma transferência mais recente, e se está ligado com o endereço exato para o qual foi enviada.
O destinatário não tem uma conta Kapsule. Precisa de se inscrever com o endereço para o qual a transferência foi enviada, depois reabrir a ligação.
As implementações do projeto pararam após a transferência. A nova conta não tem acesso ao repositório. Reconecte-o: consulte Connecting a GitHub Repository.
Um domínio personalizado deixou de resolver. O domínio ainda está na conta antiga. Reaponte ou transfira-o.
Onde Ir a Seguir
- Orbit Project Settings para colaboradores, arquivo e o resto da danger zone.
- Environment Variables in Orbit para o que rodar antes de entregar.
- Orbit Plan Limits para as permissões da conta de receção.