Synchronisation et export GitHub : votre code Mythex vous appartient

Le code que vous créez sur Mythex vous appartient, et vous pouvez l'emporter avec vous. Avec le forfait Pro, vous pouvez synchroniser un projet avec un dépôt GitHub, télécharger l'ensemble dans une archive .tar.gz, ou importer une archive dans un projet. Les secrets sont exclus des exports, donc une archive peut être déplacée sans risque.

Ce que ça fait

Mythex vous offre trois façons de faire entrer et sortir du code d'un projet :

Synchronisation GitHub : reliez un dépôt et poussez ou tirez entre celui-ci et votre projet.
Export : téléchargez le projet en archive .tar.gz depuis les paramètres du projet.
Import : remplacez les fichiers d'un projet par le contenu d'une archive .tar.gz, .tgz ou .zip.

Si vous n'avez jamais utilisé GitHub, ce qu'est GitHub présente les bases : c'est là que la plupart des développeurs gardent leur code, suivent les modifications et révisent le travail des autres.

Pourquoi c'est important

Un créateur d'apps qui retient votre code en otage est un risque. Si vous changez d'outil, si vous engagez un développeur, ou si vous voulez simplement une copie sur votre propre ordinateur, vous devez pouvoir repartir avec tout.

La page propriété des données de Mythex l'énonce clairement : tout ce qui est créé dans votre projet vous appartient. Vous pouvez continuer à construire dans Mythex, l'exporter ou le synchroniser avec GitHub. La synchronisation GitHub est aussi le point de passage naturel lorsqu'une équipe d'ingénierie prend le relais : elle obtient un dépôt normal contenant le projet complet.

Comment utiliser la synchronisation GitHub

Connectez GitHub depuis les paramètres pendant que vous êtes connecté à Mythex. Cela utilise l'authentification OAuth de GitHub.
Reliez un dépôt au projet.
Poussez ou tirez depuis le projet vers ce dépôt.

La connexion GitHub sert uniquement à synchroniser des dépôts. Ce n'est pas un moyen de vous connecter à Mythex : vous vous connectez toujours par courriel ou avec Google.

Conseil tiré de la documentation : créez un point de contrôle propre avant toute opération de type force-push sur vos propres dépôts distants, afin d'avoir un endroit sûr où revenir.

Comment exporter

Ouvrez Paramètres du projet → Export.
Téléchargez le projet en archive .tar.gz.

Les secrets et node_modules (les paquets installés, qui peuvent être reconstruits) sont exclus. L'archive peut ainsi être partagée ou déplacée d'un environnement à l'autre sans risque. Vous devrez ajouter à nouveau vos secrets partout où vous exécuterez le projet. Si vous prévoyez de faire tourner l'app ailleurs, comment exporter et héberger soi-même une app construite avec l'IA détaille les étapes.

Comment importer

L'import fait entrer une archive dans le projet actuel. Il n'existe pas de procédure distincte « créer un projet à partir d'une archive » sur le tableau de bord ; commencez donc par créer un projet si vous en avez besoin d'un vide.

Ouvrez Paramètres du projet → Export.
Choisissez Import into this project.
Sélectionnez un fichier .tar.gz, .tgz ou .zip.

Ce qui se passe :

Les fichiers du projet sont remplacés par le contenu de l'archive.
Les secrets existants du projet sont conservés.
Les fichiers .env de l'archive sont retirés. Ajoutez de nouveau ces valeurs dans les paramètres.

L'import est utile pour restaurer une sauvegarde ou pour faire entrer une base de code existante dans un projet vide.

Ce que Mythex continue d'héberger

L'export vous donne une copie ; il ne déplace rien hors de Mythex. Tant qu'un projet existe, Mythex héberge :

les fichiers du projet, dans votre bac à sable privé
la base de données et le stockage de fichiers, si vous les avez activés
l'app publiée, jusqu'à ce que vous la dépubliiez ou supprimiez le projet

Supprimer un projet ou votre compte retire vos apps de l'hébergement Mythex. Exportez d'abord si vous voulez une copie locale.

Secrets et Git

Les clés d'API dans les secrets de votre projet servent à votre app lorsqu'elle s'exécute. Ne les validez pas dans Git. Les exports les excluent déjà, et les imports retirent les fichiers .env, donc les valeurs par défaut aident, mais si vous ajoutez manuellement des fichiers à votre dépôt, gardez les clés à l'écart. Ce que sont les variables d'environnement et les secrets explique pourquoi.

Limites

L'export et la synchronisation GitHub sont des fonctions Pro. Avec le forfait Free, vous pouvez consulter le code en lecture seule et utiliser l'aperçu et le terminal ; passez à un forfait supérieur pour télécharger ou synchroniser.
L'import remplace les fichiers. Il ne fusionne pas. Exportez d'abord si vous voulez peut-être retrouver la version actuelle.
Les exports excluent les secrets et node_modules. Prévoyez de réajouter les clés et de réinstaller les paquets ailleurs.