Transferring an Orbit Project - Transferencia de un Proyecto Orbit

Un proyecto se puede mover a otra cuenta de Kapsule sin reimplementarlo ni reconstruir su configuración. El movimiento se verifica por correo electrónico, solo es reversible si se transfiere de vuelta, y se lleva todo consigo: entornos, implementaciones, variables de entorno, webhooks y configuración.

Cuándo Transferir un Proyecto

• Una agencia entrega un sitio terminado al cliente que lo poseerá a partir de ahora.
• Un proyecto se mueve de una cuenta personal a una cuenta de empresa.
• Un equipo se divide y un proyecto va con las personas que lo mantienen.

Transferir no es lo mismo que agregar un colaborador. Si quieres que alguien trabaje en el proyecto mientras lo conservas, agrégalo al equipo del proyecto en su lugar: consulta Orbit Project Settings.

Iniciar una Transferencia

Abre Orbit, haz clic en el proyecto, elige Settings y busca Transfer project en la Danger zone. La tarjeta describe lo que sucede: el proyecto se mueve a otra cuenta de Kapsule, el destinatario recibe un correo electrónico para aceptar y todos los datos se transfieren con el proyecto.

1. Ingresa la dirección de correo electrónico del propietario de la cuenta receptora.
2. Haz clic en Initiate transfer.

La tarjeta se confirma con Transfer email sent y luego muestra Transfer pending, indicando quién está esperando y cuándo expira.

Una Transferencia Pendiente a la Vez

Iniciar una nueva transferencia reemplaza cualquier transferencia ya pendiente para ese proyecto. El enlace anterior deja de funcionar inmediatamente, que es también la forma más rápida de corregir un error tipográfico en la dirección: inicia de nuevo con la dirección correcta.

Lo Que Ve el Destinatario

El destinatario recibe un correo electrónico con un enlace de aceptación. Al abrirlo se muestra una página de confirmación titulada Accept project transfer, que nombra la cuenta remitente, el proyecto y su slug, y la dirección de correo electrónico a la que se envió la transferencia.

Debajo, la página expone claramente el alcance: todos los entornos, implementaciones, variables de entorno, webhooks y configuración se transferirán, y cuándo expira el enlace.

Hacer clic en Accept transfer completa el movimiento. La página entonces muestra Transfer complete y lo redirige al proyecto, que ahora está en su cuenta.

El Destinatario Debe Haber Iniciado Sesión Con Esa Dirección

La aceptación verifica el correo electrónico del usuario conectado contra la dirección a la que se envió la transferencia. Si no coinciden, la solicitud se rechaza con un mensaje que nombra la dirección a la que se envió y le pide que inicie sesión con esa cuenta.

Esa es la propiedad de seguridad que hace que todo sea seguro: conocer el enlace no es suficiente. Debes ser la persona a la que se dirigía.

Si el destinatario no tiene una cuenta de Kapsule aún, necesita crear una con esa dirección exacta primero, luego abrir el enlace de nuevo.

La Ventana de 48 Horas

Un enlace de transferencia expira 48 horas después de su creación. Después de eso, la página de aceptación muestra que la transferencia ya no es válida y da la razón: expired.

La misma página maneja los otros estados terminales, por lo que un destinatario que haga clic en un enlace antiguo se le informa si ya fue aceptado, cancelado o simplemente expiró, en lugar de ver un error genérico.

Si una transferencia expira, inicia una nueva. No hay forma de extender un enlace existente.

Cancelar una Transferencia Pendiente

Mientras una transferencia está pendiente, la tarjeta ofrece Cancel. La cancelación invalida el enlace inmediatamente, por lo que la página de aceptación lo rechazará incluso si el destinatario tiene el correo electrónico abierto frente a él.

Cancela tan pronto como te des cuenta de que una transferencia fue a la dirección equivocada. No dependas de la expiración de 48 horas para hacerlo por ti.

Qué Se Mueve y Qué No

Todo lo adjunto al proyecto se mueve con él:

• Cada entorno, incluyendo staging y previews.
• El historial completo de implementaciones.
• Variables de entorno, incluyendo secretos.
• Webhooks, cron jobs, edge functions y configuración.
• Dominios personalizados adjuntos al proyecto.

Dos cosas que vale la pena pensar por separado:

• El registro de dominio. Si el proyecto sirve un dominio personalizado registrado en tu cuenta de Kapsule, el dominio no se mueve con el proyecto. Transfiere o reapunta el dominio como un paso separado: consulta Transferring a Domain Out.
• La conexión del repositorio. El proyecto sigue apuntando al mismo repositorio. La cuenta receptora necesita su propio acceso a ese repositorio para que las futuras implementaciones funcionen, así que planifica la entrega del repositorio al mismo tiempo.

Después de la Transferencia

Desde el lado del remitente, el proyecto simplemente desaparece de la lista de Orbit. No hay copia archivada, y deshacerlo significa pedir al nuevo propietario que lo transfiera de vuelta.

Desde el lado del destinatario, el proyecto aparece en su lista de Orbit, aún implementado y aún sirviendo tráfico. No hay necesidad de reimplementar nada.

Lo primero que debe hacer el nuevo propietario es verificar el uso del proyecto contra su propio plan. Los minutos de compilación y los límites de ancho de banda son de toda la cuenta, por lo que un proyecto ocupado cambia los números en ambos lados: consulta Orbit Plan Limits.

Transferir Mediante la API

Las transferencias también se pueden impulsar mediante programación: iniciar, cancelar y verificar el estado están disponibles como endpoints, documentados en la referencia de API del panel. Consulta Orbit API Tokens and the REST API. Aplican las mismas reglas, incluyendo iniciación solo para propietarios y aceptación verificada por correo electrónico.

Solución de Problemas

El campo de transferencia no está disponible. No eres propietario de la cuenta.

El destinatario dice que el enlace no funciona. Verifica tres cosas: si ha expirado, si fue cancelado o reemplazado por una transferencia más nueva, y si ha iniciado sesión con la dirección exacta a la que se envió.

El destinatario no tiene una cuenta de Kapsule. Necesita registrarse con la dirección a la que se envió la transferencia, luego reabre el enlace.

Las implementaciones del proyecto se detuvieron después de la transferencia. La nueva cuenta no tiene acceso al repositorio. Reconéctalo: consulta Connecting a GitHub Repository.

Un dominio personalizado dejó de resolverse. El dominio sigue en la cuenta antigua. Reapúntalo o transfierelo.

A Dónde Ir Después

• Orbit Project Settings para colaboradores, archivado y el resto de la danger zone.
• Environment Variables in Orbit para saber qué rotar antes de entregar.
• Orbit Plan Limits para los límites de la cuenta receptora.