Ajout de code hébergé localement dans GitHub

Si votre code est stocké localement sur votre ordinateur et est suivi par Git ou n'est suivi par aucun système de contrôle de version (VCS), vous pouvez importer le code vers GitHub en utilisant GitHub CLI ou des commandes Git.

Platform navigation

Dans cet article

A propos de l'importation du code source

L’importation de votre code source dans GitHub facilite la collaboration entre vous et d’autres utilisateurs sur des projets et vous permet de gérer le code. GitHub vous aide à collaborer, à suivre les modifications et à organiser les tâches, ce qui simplifie la génération et la gestion des projets. Pour plus d’informations, consultez « À propos de GitHub et git ».

Avertissement

Ne jamais envoyer d'informations sensibles git add,commit oupush, par exemple des mots de passe ou des clés d'API, à un référentiel distant. Si vous avez déjà ajouté ces informations, consultez Suppression de données sensibles dans un dépôt.

Ajouter le code source existant à GitHub

Si vous disposez d'un code source stocké localement sur votre ordinateur qui est suivi par Git ou qui n'est suivi par aucun système de contrôle de version (VCS), vous pouvez ajouter le code à GitHub en tapant des commandes dans un terminal. Vous pouvez le faire en tapant directement les commandes Git. Vous pouvez également utiliser GitHub CLI ou GitHub Desktop.

Utilisation de GitHub CLI

GitHub CLI est un outil open source permettant d’utiliser GitHub à partir de la ligne de commande de votre ordinateur. GitHub CLI peut simplifier le processus d'ajout d'un projet existant à GitHub en utilisant la ligne de commande. Pour plus d’informations sur GitHub CLI, consultez À propos de l’interface CLI GitHub.

Utilisation de GitHub Desktop

Si vous préférez utiliser une interface utilisateur de type pointer-cliquer, ajoutez plutôt votre projet avec GitHub Desktop. Pour plus d’informations, consultez « Ajout d’un dépôt de votre ordinateur local à GitHub Desktop ».

Conversion de référentiels à partir d’autres VCS

Si votre code source est suivi par un autre VCS, tel que Mercurial, Subversion ou Team Foundation Version Control, vous devez convertir le référentiel en Git avant d'ajouter le projet à GitHub.

Initialisation d’un dépôt Git

Si votre code hébergé localement n’est suivi par aucun système de gestion de versions, la première étape consiste à initialiser un dépôt Git. Si votre projet est déjà suivi par Git, passez à Importation d’un référentiel Git avec la ligne de commande.

  1. Ouvrez TerminalTerminalGit Bash.

  2. Accédez au répertoire racine de votre projet.

  3. Initialisez le répertoire local en tant que dépôt Git. Par défaut, la branche initiale est appelée main.

    Si vous utilisez Git 2.28.0 ou une version ultérieure, vous pouvez définir le nom de la branche par défaut en utilisant -b.

    git init -b main

    Si vous utilisez Git 2.27.1 ou une version antérieure, vous pouvez définir le nom de la branche par défaut en utilisant git symbolic-ref.

    git init && git symbolic-ref HEAD refs/heads/main

  4. Ajoutez les fichiers dans votre nouveau dépôt local. Cette opération les prépare en vue du premier commit.

    $ git add .
# Adds the files in the local repository and stages them for commit. Pour désindexer un fichier, utilisez « git reset HEAD VOTRE-FICHIER ».

  5. Commitez les fichiers que vous avez indexés dans votre dépôt local.

    $ git commit -m "First commit"
# Commits the tracked changes and prepares them to be pushed to a remote repository. Pour supprimer ce commit et modifier le fichier, utilisez « git reset --soft HEAD~1 », puis commitez et rajoutez le fichier.

Importation d’un dépôt Git avec la ligne de commande

Après avoir initialisé un référentiel Git, vous pouvez pousser le référentiel vers GitHub, en utilisant soit GitHub CLI soit Git.

Ajout d’un dépôt local à GitHub avec GitHub CLI

  1. Pour créer un référentiel pour votre projet sur GitHub, utilisez la sous-commande gh repo create. Lorsque vous y êtes invité, sélectionnez Envoyer un référentiel local existant vers GitHub et entrez le nom souhaité pour votre référentiel. Si vous voulez que votre projet appartienne à une organisation plutôt qu’à votre compte d’utilisateur, spécifiez le nom de l’organisation et le nom du projet avec ORGANIZATION-NAME/PROJECT-NAME.

  2. Suivez les invites interactives. Pour ajouter le dépôt distant et le pousser, répondez oui quand vous êtes invité à ajouter le dépôt distant et à pousser les commits vers la branche active.

  3. Vous pouvez aussi ignorer toutes les invites, fournir le chemin du dépôt avec l’indicateur --source et utiliser un indicateur de visibilité (--public, --private ou --internal). Par exemple : gh repo create --source=. --public. Spécifiez un distant avec l’indicateur --remote. Pour pousser vos commits, passez l’indicateur --push. Pour plus d’informations sur les arguments possibles, consultez le manuel GitHub CLI.

Ajout d’un dépôt local sur GitHub en utilisant Git

Avant de pouvoir ajouter votre référentiel local à GitHub à l’aide de Git, vous devez vous authentifier auprès de GitHub sur la ligne de commande. Pour plus d’informations, consultez « À propos de l’authentification à GitHub ».

  1. Créez un référentiel dans GitHub. Pour éviter les erreurs, n’initialisez pas le nouveau dépôt avec le fichier README, la licence ou les fichiers gitignore. Vous pouvez ajouter ces fichiers après que votre projet ait été poussé sur GitHub. Pour plus d’informations, consultez « Création d’un dépôt ».

  2. En haut de votre dépôt dans la page Configuration rapide de GitHub, cliquez sur pour copier l’URL du dépôt distant.

    Capture d’écran de l’en-tête « Configuration rapide » dans un dépôt. À côté de l'URL distant, une icône représentant deux carrés superposés apparaît en orange.

  3. Ouvrez TerminalTerminalGit Bash.

  4. Remplacez le répertoire de travail actuel par votre projet local.

  5. Exécutez la commande suivante pour ajouter l’URL du référentiel distant vers lequel votre référentiel local sera envoyé. Remplacez REMOTE-URL par l’URL complète du référentiel sur GitHub.

    git remote add origin REMOTE-URL

    Pour plus d’informations, consultez « Gestion de dépôts distants ».

  6. Exécutez la commande suivante pour vérifier que vous avez correctement défini l’URL distante :

    git remote -v

  7. Exécutez la commande suivante pour envoyer (push) les modifications de votre dépôt local vers GitHub.

    git push -u origin main

    Si votre branche par défaut n’est pas nommée « main », remplacez « main » par le nom de votre branche par défaut. Pour plus d’informations, consultez « À propos des branches ».

  1. Créez un référentiel dans GitHub. Pour éviter les erreurs, n’initialisez pas le nouveau dépôt avec le fichier README, la licence ou les fichiers gitignore. Vous pouvez ajouter ces fichiers après que votre projet ait été poussé sur GitHub. Pour plus d’informations, consultez « Création d’un dépôt ».

  2. En haut de votre dépôt dans la page Configuration rapide de GitHub, cliquez sur pour copier l’URL du dépôt distant.

    Capture d’écran de l’en-tête « Configuration rapide » dans un dépôt. À côté de l'URL distant, une icône représentant deux carrés superposés apparaît en orange.

  3. Ouvrez TerminalTerminalGit Bash.

  4. Remplacez le répertoire de travail actuel par votre projet local.

  5. Exécutez la commande suivante pour ajouter l’URL du référentiel distant vers lequel votre référentiel local sera envoyé. Remplacez REMOTE-URL par l’URL complète du référentiel sur GitHub.

    git remote add origin REMOTE-URL

    Pour plus d’informations, consultez « Gestion de dépôts distants ».

  6. Exécutez la commande suivante pour vérifier que vous avez correctement défini l’URL distante :

    git remote -v

  7. Exécutez la commande suivante pour envoyer (push) les modifications de votre dépôt local vers GitHub.

    git push origin main

    Si votre branche par défaut n’est pas nommée « main », remplacez « main » par le nom de votre branche par défaut. Pour plus d’informations, consultez « À propos des branches ».

  1. Créez un référentiel dans GitHub. Pour éviter les erreurs, n’initialisez pas le nouveau dépôt avec le fichier README, la licence ou les fichiers gitignore. Vous pouvez ajouter ces fichiers après que votre projet ait été poussé sur GitHub. Pour plus d’informations, consultez « Création d’un dépôt ».

  2. En haut de votre dépôt dans la page Configuration rapide de GitHub, cliquez sur pour copier l’URL du dépôt distant.

    Capture d’écran de l’en-tête « Configuration rapide » dans un dépôt. À côté de l'URL distant, une icône représentant deux carrés superposés apparaît en orange.

  3. Ouvrez TerminalTerminalGit Bash.

  4. Remplacez le répertoire de travail actuel par votre projet local.

  5. Exécutez la commande suivante pour ajouter l’URL du référentiel distant vers lequel votre référentiel local sera envoyé. Remplacez REMOTE-URL par l’URL complète du référentiel sur GitHub.

    git remote add origin REMOTE-URL

    Pour plus d’informations, consultez « Gestion de dépôts distants ».

  6. Exécutez la commande suivante pour vérifier que vous avez correctement défini l’URL distante :

    git remote -v

  7. Exécutez la commande suivante pour envoyer (push) les modifications de votre dépôt local vers GitHub.

    git push origin main

    Si votre branche par défaut n’est pas nommée « main », remplacez « main » par le nom de votre branche par défaut. Pour plus d’informations, consultez « À propos des branches ».

Pour aller plus loin