Comment envoyer son projet sur GitHub depuis le terminal

Si vous développez des sites web, des applications ou tout autre projet numérique, vous avez sans doute déjà entendu parler de GitHub. Ce service en ligne est aujourd’hui devenu un outil incontournable dans le monde du développement. Que vous soyez débutant, étudiant ou professionnel confirmé, savoir envoyer un projet sur GitHub depuis le terminal est une compétence essentielle.

Mais avant de plonger dans la pratique, prenons le temps de comprendre ce qu’est réellement GitHub, à quoi il sert, et pourquoi il est si utile dans la vie d’un développeur.

Qu’est-ce que GitHub ?

GitHub est une plateforme en ligne qui permet de stocker, partager et collaborer sur du code source. Elle repose sur un système de gestion de versions appelé Git, créé par Linus Torvalds (le même qui a développé Linux).

Concrètement, Git est un outil qui permet d’enregistrer l’historique complet des modifications d’un projet. GitHub, quant à lui, héberge vos dépôts Git (appelés “repositories” ou “repos”) dans le cloud. Cela signifie que votre code n’est plus seulement stocké sur votre ordinateur, mais aussi sur Internet, accessible depuis n’importe où et sauvegardé de manière sécurisée.

Vous pouvez imaginer GitHub comme un Dropbox pour les développeurs, mais bien plus puissant. Non seulement il conserve vos fichiers, mais il garde aussi la trace de chaque changement, de chaque ligne modifiée, et de chaque personne ayant participé au projet.

Pour allez plus loin, consultez notre guide pour Débuter avec Git.

À quoi sert GitHub ?

GitHub est utilisé dans une multitude de situations. Tout d’abord, il permet de sauvegarder son code de manière sûre et organisée. Vous pouvez ainsi récupérer votre projet à tout moment, même si votre ordinateur rencontre un problème.

Ensuite, il facilite la collaboration. Plusieurs développeurs peuvent travailler ensemble sur un même projet sans risquer d’écraser le travail des autres. GitHub gère les versions, compare les modifications, et aide à fusionner le code proprement.

Il est également un excellent moyen de montrer vos projets. Les recruteurs, les écoles ou les clients peuvent consulter votre profil GitHub et voir concrètement vos réalisations, votre style de code, vos contributions open source et votre évolution dans le temps.

Enfin, GitHub sert à déployer des projets. Grâce à des services comme GitHub Pages, il est possible d’héberger gratuitement un site web statique directement depuis un dépôt.

Les avantages de GitHub

Les avantages de GitHub sont nombreux. D’abord, il offre un gain de sécurité : tout votre code est sauvegardé en ligne et peut être restauré à n’importe quel moment.

Ensuite, il permet une traçabilité totale. Vous pouvez revenir en arrière sur une version antérieure, analyser les changements apportés et comprendre l’évolution du projet.

L’outil encourage aussi la collaboration efficace. Les “pull requests” permettent de proposer des améliorations, tandis que les “issues” aident à suivre les bugs ou les idées d’évolution.

Enfin, GitHub est un vecteur de visibilité. Publier son code, c’est participer à la communauté open source, montrer son savoir-faire et apprendre des autres.

Préparer son environnement

Avant d’envoyer un projet sur GitHub, il faut s’assurer que votre environnement est prêt. Cela passe par trois éléments :

1. Avoir un compte GitHub : si ce n’est pas encore le cas, rendez-vous sur https://github.com et créez un compte gratuitement.
2. Installer Git sur votre ordinateur : Git est le moteur qui permet de communiquer avec GitHub.
   • Sur Windows, vous pouvez télécharger “Git for Windows”.
   • Sur macOS, Git est souvent déjà installé, sinon tapez brew install git si vous avez Homebrew.
   • Sur Linux, utilisez la commande sudo apt install git.
3. Configurer votre identité Git : c’est une étape importante. Ouvrez votre terminal et entrez :

git config --global user.name "Votre Nom" git config --global user.email "[email protected]"

Ces informations seront associées à vos futurs commits. Une fois ces prérequis en place, vous êtes prêt à passer à la pratique.

Comment envoyer un projet sur GitHub depuis le terminal

Passons maintenant au cœur du sujet : envoyer votre projet sur GitHub directement depuis le terminal. C’est une opération que vous allez effectuer très souvent en tant que développeur, que ce soit pour un site web, une application ou un simple script.

Imaginons que vous avez un dossier nommé mon-projet sur votre ordinateur. Ce dossier contient votre travail : fichiers HTML, CSS, JavaScript, images, etc. Vous souhaitez maintenant le rendre disponible sur GitHub.

Étape 1 : Initialiser le dépôt Git localement

Placez-vous dans le dossier de votre projet à l’aide du terminal :

cd chemin/vers/mon-projet

Ensuite, créez un dépôt Git dans ce dossier :

git init

Cette commande initialise un nouveau dépôt Git local. En d’autres termes, elle dit à Git : “À partir de maintenant, surveille les modifications de ce dossier”.

Vous pouvez vérifier que tout s’est bien passé en tapant :

ls -a

Vous verrez alors un dossier caché .git, qui contient toute la configuration du dépôt.

Étape 2 : Ajouter les fichiers à la zone de suivi

Git ne surveille pas automatiquement tous les fichiers. Vous devez lui dire lesquels suivre. Pour cela, ajoutez-les avec :

git add .

Le point . signifie “ajoute tous les fichiers du dossier courant”. Vous pouvez aussi ajouter un fichier spécifique, par exemple git add index.html.

Cette étape place vos fichiers dans la “zone de préparation” (staging area), c’est-à-dire la liste des fichiers qui seront enregistrés lors du prochain commit.

Étape 3 : Créer un premier commit

Un commit correspond à un point de sauvegarde. Il contient une description claire des changements effectués.

Pour enregistrer vos fichiers dans l’historique Git :

git commit -m "Premier commit : ajout du projet initial"

Votre dépôt local est désormais prêt. Vous avez un historique de version et pouvez suivre l’évolution de votre travail. Il ne reste plus qu’à le connecter à GitHub.

Étape 4 : Créer un dépôt distant sur GitHub

Maintenant que votre projet est versionné en local, il faut le lier à un dépôt distant, c’est-à-dire à une copie hébergée sur GitHub.

Pour cela, connectez-vous à votre compte sur https://github.com. Une fois connecté, cliquez sur le bouton “New repository” ou sur le signe “+” en haut à droite, puis sélectionnez “New repository”.

Sur la page de création, plusieurs champs apparaissent :

• Repository name : c’est le nom de votre projet. Il doit être unique sur votre compte. Par exemple : mon-projet.
• Description (optional) : vous pouvez y ajouter une brève présentation de votre projet.
• Public / Private : choisissez si vous souhaitez que votre dépôt soit visible par tous ou réservé à vous-même et à vos collaborateurs.
• Initialize this repository with a README : ne cochez pas cette case si vous avez déjà un projet en local. Sinon, cela créera un conflit avec votre dossier.

Une fois tout cela rempli, cliquez sur “Create repository”.

Vous arrivez alors sur une page indiquant comment connecter votre dépôt local à celui de GitHub. Vous y verrez plusieurs lignes de commande, dont l’une très importante : l’adresse du dépôt distant, qui ressemble à ceci :

https://github.com/votre-nom-utilisateur/mon-projet.git

Copiez cette adresse, car vous allez en avoir besoin pour la suite.

Étape 5 : Connecter votre dépôt local à GitHub

Retournez dans votre terminal. Vous allez indiquer à Git que votre dépôt local doit être synchronisé avec celui de GitHub.

Entrez la commande suivante :

git remote add origin https://github.com/votre-nom-utilisateur/mon-projet.git

Ici, “origin” est le nom symbolique que Git utilise pour désigner le dépôt distant principal. Vous pourriez en ajouter plusieurs plus tard (par exemple pour un fork ou un miroir), mais pour le moment, “origin” suffira.

Pour vérifier que la connexion est bien établie, tapez :

git remote -v

Le terminal devrait afficher deux lignes, correspondant aux opérations fetch (récupérer) et push (envoyer).

Étape 6 : Envoyer votre projet sur GitHub

C’est le grand moment : vous allez envoyer votre code sur GitHub.

Avant cela, assurez-vous d’être sur la bonne branche. Par défaut, Git crée souvent une branche nommée master ou mainselon votre version.
Vous pouvez vérifier le nom de la branche avec :

git branch

Si vous êtes sur une branche différente, vous pouvez la renommer pour correspondre à celle que GitHub attend (souvent “main”) :

git branch -M main

Ensuite, poussez votre projet sur le dépôt distant :

git push -u origin main

Le paramètre -u permet de lier la branche locale à la branche distante, de sorte que les futures commandes git push ou git pull sauront automatiquement où envoyer ou récupérer les modifications.

Si c’est la première fois que vous utilisez GitHub sur cet ordinateur, Git peut vous demander de vous authentifier.
Deux solutions existent :

• Soit vous vous connectez avec un token personnel (GitHub a remplacé les mots de passe par des tokens sécurisés depuis 2021).
• Soit vous utilisez SSH, une méthode plus avancée et pratique à long terme.

Une fois la commande exécutée, vous verrez Git transférer les fichiers et afficher un message du type :

Enumerating objects: 15, done.
Counting objects: 100% (15/15), done.
Writing objects: 100% (15/15), 2.35 KiB | 2.35 MiB/s, done.
Total 15 (delta 0), reused 0 (delta 0), pack-reused 0
To https://github.com/votre-nom-utilisateur/mon-projet.git
 * [new branch]      main -> main

Félicitations : votre projet est désormais en ligne sur GitHub. Vous pouvez vous rendre sur la page du dépôt pour le vérifier.

Étape 7 : Mettre à jour votre dépôt à l’avenir

Une fois votre projet hébergé sur GitHub, vous serez amené à le mettre à jour régulièrement.
Le processus est simple :

1. Vous modifiez vos fichiers localement.
2. Vous enregistrez les changements dans Git :git add . git commit -m "Mise à jour du fichier index et ajout de la section contact"
3. Vous envoyez les modifications sur GitHub :git push

Dès lors, vos fichiers en ligne seront synchronisés avec votre travail local.

Étape 8 : Récupérer un projet depuis GitHub

L’opération inverse est également fréquente : vous pouvez vouloir cloner un projet GitHub pour le consulter ou le modifier.
Pour cela, rendez-vous sur la page GitHub du projet et copiez son adresse HTTPS.
Puis, dans votre terminal :

git clone https://github.com/utilisateur/nom-du-projet.git

Git créera alors un dossier contenant tous les fichiers, l’historique des commits et les branches du dépôt d’origine.

Envoyer ses fichiers sur GitHub avec un token personnel

Depuis août 2021, GitHub n’autorise plus la connexion via un mot de passe classique lors des commandes git push ou git pull. Cette mesure a été prise pour renforcer la sécurité. À la place, GitHub vous demande d’utiliser un Personal Access Token, souvent abrégé en token personnel.

Ce token joue le rôle d’un mot de passe, mais avec un niveau de sécurité bien supérieur. Il est unique, peut être limité dans le temps et dans ses permissions. Vous pouvez en créer plusieurs selon vos besoins (par exemple un pour votre ordinateur personnel et un autre pour votre poste professionnel).

Des formations informatique pour tous !

Débutant ou curieux ? Apprenez le développement web, le référencement, le webmarketing, la bureautique, à maîtriser vos appareils Apple et bien plus encore…

Formateur indépendant, professionnel du web depuis 2006, je vous accompagne pas à pas et en cours particulier, que vous soyez débutant ou que vous souhaitiez progresser. En visio, à votre rythme, et toujours avec pédagogie.

Découvrez mes formations Qui suis-je ?

Voyons ensemble comment le générer et l’utiliser.

Étape 1 : Créer un token personnel sur GitHub

1. Connectez-vous à votre compte GitHub depuis un navigateur.
2. Cliquez sur votre photo de profil (en haut à droite), puis sur Settings.
3. Dans le menu de gauche, descendez jusqu’à Developer settings.
4. Cliquez sur Personal access tokens, puis sur Tokens (classic) ou Fine-grained tokens selon la version proposée.
5. Sélectionnez Generate new token.

GitHub vous demandera ensuite de configurer ce token :

• Note : donnez-lui un nom parlant, par exemple “Token pour mon PC personnel”.
• Expiration : choisissez une durée (par exemple 90 jours). Vous pourrez en régénérer un facilement plus tard.
• Permissions : cochez au minimum les autorisations liées à “repo” (dépôts), nécessaires pour pouvoir pousser du code.

Enfin, cliquez sur Generate token.

Une fois généré, GitHub affiche votre token sous forme d’une longue suite de caractères comme ceci :

ghp_AbC1234567xyz...

Important : copiez-le immédiatement et conservez-le dans un endroit sûr (gestionnaire de mots de passe, fichier chiffré, etc.). GitHub ne l’affichera plus ensuite.

Étape 2 : Utiliser le token lors d’un push

Revenons maintenant à votre terminal. Vous êtes prêt à envoyer votre code sur GitHub.
Lors de la commande :

git push -u origin main

Git vous demandera de vous authentifier.
Il vous posera deux questions :

Username for 'https://github.com': 
Password for 'https://github.com':

Pour le nom d’utilisateur, entrez simplement votre pseudo GitHub.
Pour le mot de passe, collez le token personnel que vous venez de créer.

Git enverra alors les fichiers avec succès.

Étape 3 : Éviter de ressaisir le token à chaque fois

Répéter cette authentification à chaque git push serait fastidieux. Heureusement, il est possible de mémoriser votre token localement grâce à un gestionnaire de crédentials (informations d’accès).

Sous Windows, entrez la commande :

git config --global credential.helper wincred

Sous macOS :

git config --global credential.helper osxkeychain

Sous Linux :

git config --global credential.helper store

Lors du prochain git push, Git vous demandera encore le token, mais cette fois il le gardera en mémoire pour les prochaines utilisations.

Étape 4 : Révoquer ou régénérer un token

Si vous perdez votre token ou si vous pensez qu’il a été compromis, rendez-vous à nouveau dans Settings > Developer settings > Personal access tokens.
Vous pouvez alors révoquer le token en un clic. Cela le rend immédiatement inutilisable.

Il vous suffit ensuite d’en créer un nouveau et de le remplacer dans votre terminal.

C’est l’un des grands avantages de cette méthode : une sécurité maîtrisée et modulable, sans jamais exposer votre vrai mot de passe GitHub.

Envoyer ses fichiers sur GitHub avec une clé SSH

L’autre méthode d’authentification, plus technique mais aussi plus pratique à long terme, est la connexion SSH. Cette méthode permet de communiquer avec GitHub sans avoir à entrer ni mot de passe ni token à chaque push.

SSH (pour Secure Shell) repose sur un système de clés de chiffrement asymétrique :

• Une clé privée, conservée uniquement sur votre ordinateur.
• Une clé publique, que vous ajoutez à votre compte GitHub.

Lorsque vous poussez du code, GitHub vérifie simplement que la clé privée correspond bien à la clé publique enregistrée. Si c’est le cas, la connexion est autorisée.

Pour allez plus loin, consultez notre tutoriel pour Bien comprendre le SSH.

Étape 1 : Vérifier si une clé SSH existe déjà

Avant de créer une nouvelle clé, vérifiez si vous n’en avez pas déjà une :

ls -al ~/.ssh

Si vous voyez des fichiers comme id_rsa et id_rsa.pub (ou id_ed25519 et id_ed25519.pub), cela signifie que vous avez déjà une clé SSH.
Dans ce cas, vous pouvez directement passer à l’étape suivante.

Étape 2 : Créer une nouvelle clé SSH

Si aucune clé n’existe, générez-en une nouvelle à l’aide de cette commande :

ssh-keygen -t ed25519 -C "[email protected]"

Le paramètre -C permet d’ajouter un commentaire (souvent votre adresse mail) pour identifier la clé.

Le terminal vous demandera :

Enter a file in which to save the key (/Users/vous/.ssh/id_ed25519):

Appuyez simplement sur Entrée pour accepter l’emplacement par défaut.

Ensuite :

Enter passphrase (empty for no passphrase):

Vous pouvez laisser vide (pour ne pas devoir saisir un mot de passe à chaque fois) ou en mettre un pour plus de sécurité.

Une fois la clé générée, deux fichiers seront créés :

• ~/.ssh/id_ed25519 : la clé privée (gardez-la secrète)
• ~/.ssh/id_ed25519.pub : la clé publique (celle que vous partagerez à GitHub)

Étape 3 : Ajouter la clé SSH à votre compte GitHub

Copiez le contenu de votre clé publique :

cat ~/.ssh/id_ed25519.pub

Le terminal affichera une longue ligne commençant par ssh-ed25519.
Copiez-la entièrement.

Ensuite, connectez-vous à GitHub, puis :

1. Cliquez sur votre photo de profil > Settings.
2. Dans le menu de gauche, sélectionnez SSH and GPG keys.
3. Cliquez sur New SSH key.
4. Donnez un nom à votre clé (ex. : “Clé perso MacBook”).
5. Collez la clé publique dans le champ prévu.
6. Cliquez sur Add SSH key.

GitHub enregistrera la clé et vous serez prêt à vous connecter sans mot de passe.

Étape 4 : Tester la connexion SSH

Avant d’envoyer vos fichiers, testez votre connexion :

ssh -T [email protected]

GitHub devrait répondre :

Hi votre-nom-utilisateur! You've successfully authenticated, but GitHub does not provide shell access.

Cela signifie que la clé fonctionne parfaitement.

Étape 5 : Lier le dépôt local avec l’adresse SSH

Si votre dépôt local est déjà lié à l’adresse HTTPS, il faut la remplacer par l’adresse SSH.
Dans GitHub, ouvrez votre dépôt, cliquez sur le bouton Code, puis copiez l’adresse SSH, qui ressemble à ceci :

[email protected]:votre-nom-utilisateur/mon-projet.git

Dans votre terminal :

git remote set-url origin [email protected]:votre-nom-utilisateur/mon-projet.git

Ensuite, vous pouvez pousser vos fichiers comme d’habitude :

git push -u origin main

Aucune saisie de mot de passe ne sera demandée : Git utilisera automatiquement votre clé SSH.

Étape 6 : Avantages de la méthode SSH

L’authentification SSH présente plusieurs atouts :

• Gain de temps : plus besoin d’entrer son token à chaque commande.
• Sécurité renforcée : les clés SSH sont pratiquement impossibles à deviner.
• Praticité sur plusieurs projets : une seule clé suffit pour tous vos dépôts GitHub.

C’est la méthode préférée des développeurs expérimentés, notamment lorsqu’ils gèrent plusieurs dépôts ou qu’ils automatisent leurs déploiements via des scripts.

Cas pratique : mise en ligne d’un projet web personnel

Prenons un exemple concret pour illustrer ce processus.
Imaginons que vous venez de terminer la création d’un petit site web en HTML et CSS intitulé “Portfolio Créatif”. Vous souhaitez le sauvegarder en ligne, le partager avec un ami, et pourquoi pas le publier plus tard avec GitHub Pages.

Voici les étapes :

1. Vous ouvrez votre terminal et vous vous rendez dans le dossier du projet : cd Documents/Portfolio-Creatif
2. Vous initialisez Git : git init
3. Vous ajoutez tous les fichiers : git add .
4. Vous créez un premier commit : git commit -m "Version initiale du Portfolio Créatif"
5. Vous créez un nouveau dépôt sur GitHub nommé portfolio-creatif.
6. Vous liez le dépôt local à GitHub : git remote add origin https://github.com/votre-nom/portfolio-creatif.git
7. Vous poussez le tout : git branch -M main git push -u origin main

Votre site est maintenant en ligne sur GitHub, disponible à l’adresse :

https://github.com/votre-nom/portfolio-creatif

Et si vous souhaitez le publier sous forme de site web visible par tous, il vous suffira ensuite d’activer GitHub Pages dans les paramètres du dépôt, en choisissant la branche “main”.

Les bonnes pratiques à adopter

Pour bien utiliser GitHub au quotidien, il est conseillé d’adopter quelques habitudes simples.
Commencez par faire des commits réguliers et clairs. Chaque message doit décrire brièvement le changement effectué, par exemple : “Ajout de la section contact” ou “Correction du bug sur le menu mobile”.

Ensuite, pensez à tirer les dernières modifications avant de pousser les vôtres, surtout si vous collaborez avec d’autres personnes :

git pull

Enfin, prenez le temps de lire et comprendre les messages de Git. L’outil est bavard, mais c’est souvent pour vous aider à corriger une erreur ou un conflit.

GitHub, bien plus qu’un simple outil de sauvegarde

Savoir envoyer un projet sur GitHub depuis le terminal n’est pas seulement une compétence technique, c’est une véritable porte d’entrée dans le monde professionnel du développement.
Ce geste simple vous permet non seulement de protéger votre travail, mais aussi de collaborer efficacement, de suivre l’évolution de vos projets, et de valoriser vos compétences auprès d’une communauté mondiale.

GitHub n’est pas une fin en soi, mais un écosystème complet autour du code : versionning, collaboration, documentation, déploiement, intégration continue, automatisation… autant de concepts que vous découvrirez au fil de votre pratique.

L’important est de prendre l’habitude d’utiliser Git et GitHub dès vos premiers projets, même personnels. Vous gagnerez en rigueur, en professionnalisme, et en confiance dans votre travail.

En maîtrisant ces bases, vous pouvez désormais gérer vos dépôts, suivre vos versions, contribuer à des projets open source ou simplement héberger vos créations personnelles.
GitHub devient alors non plus un outil extérieur, mais un véritable compagnon de route dans votre apprentissage du développement.

Alban

Fondateur de l’agence Créa-troyes.
Intervenant en Freelance.
Contactez-moi

crea-troyes.fr