Comment importer mon projet depuis GitHub ?
Cloner un dépôt public ou privé sans exposer de token et vérifier la branche. Le gestionnaire de fichiers propose un import GitHub.
Le gestionnaire de fichiers propose un import GitHub. Pour un dépôt privé, utilisez un token limité au dépôt et révoquez-le après l’import si possible.
Procédure étape par étape
-
Nettoyer le dépôt
Retirez .env, tokens, mots de passe et fichiers volumineux. Ajoutez-les au .gitignore.
-
Ouvrir Fichiers
Cliquez sur « GitHub », puis saisissez l’URL du dépôt, la branche et le dossier cible.
-
Authentifier un dépôt privé
Utilisez un token GitHub à portée minimale. Ne le collez jamais dans un fichier du projet.
-
Installer les dépendances
Après l’import, placez les fichiers à la racine et redémarrez : la plateforme installe les dépendances de package.json ou de requirements.txt au démarrage.
-
Vérifier le démarrage
Contrôlez le fichier d’entrée et lisez la console au premier lancement.
Avant de commencer
L’import télécharge une copie du dépôt dans les fichiers du bot. Ce n’est pas un lien permanent : un nouveau commit sur GitHub n’arrive sur le bot qu’après un nouvel import.
- Le dépôt fait moins de 512 Mo : au-delà, l’import est refusé.
- package.json ou requirements.txt et le fichier principal sont au premier niveau du dépôt.
- Pour un dépôt privé : un token GitHub « fine-grained » limité à ce dépôt, avec la seule permission « Contents » en lecture.
Placer le code à la racine
La fenêtre « Importer depuis GitHub » crée toujours un nouveau dossier, le « Dossier cible », dans le dossier ouvert. Par défaut, il porte le nom du dépôt. Si un dossier de ce nom existe déjà, l’import est refusé avec le message existe deja dans ce repertoire : choisissez un autre nom ou supprimez l’ancien dossier.
La plateforme cherche package.json, requirements.txt et le fichier de démarrage à la racine des fichiers du bot. Après l’import, ouvrez le nouveau dossier, sélectionnez tout son contenu et utilisez « Déplacer » vers la racine. Sans ce déplacement, aucune dépendance n’est installée et le bot ne trouve pas son point d’entrée.
Une URL de branche comme https://github.com/owner/repository/tree/dev remplit automatiquement le champ « Branche ». Le token se colle dans « Jeton GitHub (dépôt privé) » : il sert à cet import uniquement et n’est jamais enregistré, vous pouvez donc le révoquer dès la fin de l’import.
Vérifier que tout fonctionne
Le message « Import GitHub terminé » indique le dossier créé. Une fois les fichiers à la racine, redémarrez le bot depuis la console : vous devez voir l’installation des dépendances, puis la commande lancée et le message de connexion de votre code.
Questions fréquentes
Que signifie « Dépôt ou branche introuvable » ?
GitHub ne trouve pas le dépôt ou la branche indiquée. Vérifiez l’orthographe, le nom exact de la branche (main ou master) et, pour un dépôt privé, ajoutez un token : sans token, un dépôt privé est traité comme inexistant.
Pourquoi « Jeton GitHub invalide ou expiré » ?
Le token a expiré, a été révoqué ou a été mal copié. Créez-en un nouveau dans GitHub, menu « Settings », « Developer settings », « Personal access tokens », en limitant l’accès au dépôt voulu et à une durée courte.
GitHub refuse l’accès alors que le token est valide, pourquoi ?
Le token n’a pas accès à ce dépôt, car il ne figure pas dans sa liste de dépôts autorisés, ou la limite de requêtes de GitHub est atteinte. Ajoutez le dépôt au token, ou patientez quelques minutes avant de relancer l’import.
Comment mettre à jour le bot après un nouveau commit ?
Importez à nouveau le dépôt dans un nouveau dossier cible, puis déplacez les fichiers modifiés à la racine en remplaçant les anciens. Gardez les fichiers créés par le bot lui-même, comme une base SQLite ou un dossier de journaux, puis redémarrez.