Transfert d'un projet Orbit

Un projet peut être déplacé vers un autre compte Kapsule sans le redéployer ni reconstruire sa configuration. Le déplacement est vérifié par email, ne peut être annulé qu'en le transférant à nouveau, et emporte tout avec lui : les environnements, les déploiements, les variables d'environnement, les webhooks et les paramètres.

Quand Transférer un Projet

• Une agence remet un site terminé au client qui en sera propriétaire à partir de maintenant.
• Un projet passe d'un compte personnel à un compte d'entreprise.
• Une équipe se divise, et un projet part avec les personnes qui le maintiennent.

Transférer n'est pas la même chose qu'ajouter un collaborateur. Si vous voulez que quelqu'un travaille sur le projet tandis que vous le gardez, ajoutez-le à l'équipe du projet à la place : voir Orbit Project Settings.

Commencer un Transfert

Ouvrez Orbit, cliquez sur le projet, choisissez Settings, et trouvez Transfer project dans la Danger zone. La carte décrit ce qui se passe : le projet est déplacé vers un autre compte Kapsule, le destinataire reçoit un email pour accepter, et toutes les données sont transférées avec le projet.

1. Entrez l'adresse email du propriétaire du compte destinataire.
2. Cliquez sur Initiate transfer.

La carte confirme avec Transfer email sent, puis affiche Transfer pending, nommant qui elle attend et quand elle expire.

Un Seul Transfert en Attente à la Fois

Initier un nouveau transfert remplace tout transfert déjà en attente pour ce projet. Le lien précédent cesse de fonctionner immédiatement, ce qui est aussi le moyen le plus rapide de corriger une faute de frappe dans l'adresse : lancez à nouveau avec la bonne adresse.

Ce que Voit le Destinataire

Le destinataire reçoit un email avec un lien d'acceptation. L'ouvrir affiche une page de confirmation intitulée Accept project transfer, qui nomme le compte expéditeur, le projet et son slug, ainsi que l'adresse email à laquelle le transfert a été envoyé.

Au-dessous, la page énonce clairement la portée : tous les environnements, les déploiements, les variables d'environnement, les webhooks et les paramètres seront transférés, et quand le lien expire.

Cliquer sur Accept transfer complète le déplacement. La page indique alors Transfer complete et les redirige vers le projet, qui se trouve maintenant dans son compte.

Le Destinataire Doit Être Connecté avec Cette Adresse

L'acceptation vérifie que l'email de l'utilisateur connecté correspond à l'adresse à laquelle le transfert a été envoyé. S'ils ne correspondent pas, la demande est refusée avec un message nommant l'adresse et demandant de se connecter avec ce compte.

C'est la propriété de sécurité qui rend tout cela sûr : connaître le lien ne suffit pas. Vous devez être la personne à qui il était destiné.

Si le destinataire n'a pas encore de compte Kapsule, il doit d'abord en créer un avec cette adresse exacte, puis ouvrir le lien à nouveau.

La Fenêtre de 48 Heures

Un lien de transfert expire 48 heures après sa création. Après cela, la page d'acceptation indique que le transfert n'est plus valide et donne la raison : expired.

La même page gère les autres états terminaux, donc un destinataire qui clique sur un ancien lien est informé s'il a déjà été accepté, annulé ou simplement expiré, plutôt que de voir une erreur générique.

Si un transfert expire, lancez-en un nouveau. Il n'y a aucun moyen d'étendre un lien existant.

Annuler un Transfert en Attente

Tandis qu'un transfert est en attente, la carte propose Cancel. L'annulation invalide le lien immédiatement, donc la page d'acceptation le refusera même si le destinataire a l'email ouvert devant lui.

Annulez dès que vous réalisez qu'un transfert est allé à la mauvaise adresse. Ne vous fiez pas à l'expiration de 48 heures pour le faire à votre place.

Ce qui Est Déplacé et Ce qui Ne l'Est Pas

Tout ce qui est attaché au projet est déplacé avec lui :

• Chaque environnement, y compris staging et previews.
• L'historique de déploiement complet.
• Variables d'environnement, secrets inclus.
• Webhooks, cron jobs, edge functions et paramètres.
• Domaines personnalisés attachés au projet.

Deux choses valent la peine d'être pensées séparément :

• L'enregistrement de domaine. Si le projet sert un domaine personnalisé enregistré dans votre compte Kapsule, le domaine ne se déplace pas avec le projet. Transférez ou pointez à nouveau le domaine comme une étape séparée : voir Transferring a Domain Out.
• La connexion au repository. Le projet continue à pointer vers le même repository. Le compte destinataire a besoin de son propre accès à ce repository pour que les futurs déploiements fonctionnent, donc planifiez la passation du repository en même temps.

Après le Transfert

Du côté de l'expéditeur, le projet disparaît simplement de la liste Orbit. Il n'y a pas de copie archivée, et l'annuler signifie demander au nouveau propriétaire de le transférer à nouveau.

Du côté du destinataire, le projet apparaît dans sa liste Orbit, toujours déployé et toujours en train de servir le trafic. Rien n'a besoin d'être redéployé.

La première chose que le nouveau propriétaire devrait faire est de vérifier l'utilisation du projet par rapport à son propre plan. Les allocations de minutes de build et de bande passante sont au niveau du compte, donc un projet occupé change les chiffres des deux côtés : voir Orbit Plan Limits.

Transfert via l'API

Les transferts peuvent également être pilotés par programmation : initier, annuler et vérifier le statut sont tous disponibles en tant que endpoints, documentés dans la référence API du panneau. Voir Orbit API Tokens and the REST API. Les mêmes règles s'appliquent, y compris l'initiation réservée aux propriétaires et l'acceptation vérifiée par email.

Dépannage

Le champ de transfert est indisponible. Vous n'êtes pas propriétaire du compte.

Le destinataire dit que le lien ne fonctionne pas. Vérifiez trois choses : s'il a expiré, s'il a été annulé ou remplacé par un nouveau transfert, et s'il est connecté avec l'adresse exacte à laquelle il a été envoyé.

Le destinataire n'a pas de compte Kapsule. Il doit s'inscrire avec l'adresse à laquelle le transfert a été envoyé, puis rouvrir le lien.

Le projet a cessé de déployer après le transfert. Le nouveau compte n'a pas accès au repository. Reconnectez-le : voir Connecting a GitHub Repository.

Un domaine personnalisé a cessé de se résoudre. Le domaine se trouve toujours dans l'ancien compte. Pointez-le à nouveau ou transférez-le.

Où Aller Ensuite

• Orbit Project Settings pour les collaborateurs, l'archivage et le reste de la danger zone.
• Environment Variables in Orbit pour savoir ce qu'il faut faire tourner avant de remettre.
• Orbit Plan Limits pour les allocations du compte destinataire.