Skip to main content

Clonage d’un dépôt

Lorsque vous créez un référentiel sur GitHub, il existe en tant que référentiel distant. Vous pouvez cloner votre dépôt pour créer une copie locale sur votre ordinateur et effectuer une synchronisation entre les deux emplacements.

Platform navigation

À propos du clonage d’un référentiel

Vous pouvez cloner un référentiel à partir de votre instance GitHub Enterprise Server votre ordinateur faciliter la résolution des conflits de fusion, ajouter ou supprimer des fichiers et envoyer des validations plus volumineuses. Lorsque vous clonez un référentiel, vous copiez le référentiel à partir de votre instance GitHub Enterprise Server votre ordinateur.

Vous pouvez cloner un référentiel à partir de votre instance GitHub Enterprise Server sur votre ordinateur local pour faciliter la résolution des conflits de fusion, ajouter ou supprimer des fichiers et envoyer (push) des validations plus volumineuses. Lorsque vous clonez un référentiel, vous copiez le référentiel à partir de votre instance GitHub Enterprise Server sur votre ordinateur local.

Vous pouvez cloner un référentiel à partir de votre instance GitHub Enterprise Server sur votre ordinateur local pour faciliter la résolution des conflits de fusion, ajouter ou supprimer des fichiers et envoyer (push) des validations plus volumineuses. Lorsque vous clonez un référentiel, vous copiez le référentiel à partir de votre instance GitHub Enterprise Server sur votre ordinateur local.

Le clonage d’un référentiel extrait une copie complète de toutes les données de référentiel qui votre instance GitHub Enterprise Server ont à ce stade dans le temps, y compris toutes les versions de chaque fichier et dossier pour le projet. Vous pouvez envoyer (push) vos modifications au référentiel distant sur votre instance GitHub Enterprise Server, ou extraire les modifications d’autres personnes à partir de votre instance GitHub Enterprise Server. Pour plus d’informations, consultez « Utilisation de Git ».

Vous pouvez cloner votre référentiel existant ou cloner le référentiel existant d’une autre personne pour contribuer à un projet.

Clonage d’un dépôt

  1. Sur GitHub, accédez à la page principale du référentiel.

  2. Au-dessus de la liste de fichiers, cliquez sur Code.

    Capture d’écran de la liste des fichiers dans la page d’accueil d’un dépôt. Le bouton « Code » est mis en évidence avec un encadré orange foncé.

  3. Copiez l’URL du dépôt.

    • Pour cloner le référentiel en utilisant HTTPS, sous « HTTPS », cliquez sur .

    • Pour cloner le dépôt avec une clé SSH, en incluant un certificat émis par l’autorité de certification SSH de votre organisation, cliquez sur SSH et sur .

    • Pour cloner un dépôt avec l’GitHub CLI, cliquez sur GitHub CLI et sur .

      Capture d’écran du menu déroulant « Code ». À droite de l’URL HTTPS du dépôt, une icône de copie est indiquée en orange foncé.

  4. Ouvrez TerminalTerminalGit Bash.

  5. Remplacez le répertoire de travail actuel par l’emplacement où vous voulez mettre le répertoire cloné.

  6. Tapez git clone, puis collez l’URL que vous avez copiée précédemment.

    git clone https://HOSTNAME/YOUR-USERNAME/YOUR-REPOSITORY
    
  7. Appuyez sur Entrée pour créer votre clone local.

    $ git clone https://HOSTNAME/YOUR-USERNAME/YOUR-REPOSITORY
    > Cloning into `Spoon-Knife`...
    > remote: Counting objects: 10, done.
    > remote: Compressing objects: 100% (8/8), done.
    > remove: Total 10 (delta 1), reused 10 (delta 1)
    > Unpacking objects: 100% (10/10), done.
    

Remarque

Pour plus d’informations sur GitHub CLI, consultez À propos de l’interface CLI GitHub.

Pour cloner un référentiel localement, utilisez la sous-commande repo clone. Remplacez le paramètre repository par le nom du référentiel. Par exemple, octo-org/octo-repo, monalisa/octo-repo ou octo-repo. Si la partie OWNER/ de l’argument du référentiel OWNER/REPO est omise, il prend par défaut le nom de l’utilisateur à l’origine de l’authentification.

gh repo clone REPOSITORY

Vous pouvez également utiliser l’URL GitHub pour cloner un référentiel.

gh repo clone https://github.com/PATH-TO/REPOSITORY
  1. Sur GitHub, accédez à la page principale du référentiel.

  2. Au-dessus de la liste des fichiers, cliquez sur Code.

    Capture d’écran de la liste des fichiers dans la page d’accueil d’un dépôt. Le bouton « Code » est mis en évidence avec un encadré orange foncé.

  3. Pour cloner et ouvrir le référentiel avec GitHub Desktop, cliquez sur Ouvrir avec GitHub Desktop.

    Capture d’écran de la liste déroulante « Code » d’un dépôt. Un bouton intitulé « Ouvrir avec GitHub Desktop » est présenté en orange foncé.

  4. Suivez les instructions dans GitHub Desktop pour finaliser le clonage.

Pour plus d’informations, consultez « Clonage d’un dépôt de GitHub vers GitHub Desktop ».

Clonage d’un référentiel vide

Un référentiel vide ne contient aucun fichier. C’est souvent le cas si vous n’initialisez pas le référentiel avec un fichier README lors de sa création.

  1. Sur GitHub, accédez à la page principale du référentiel.

  2. Pour cloner votre référentiel à l’aide de la ligne de commande à l’aide du protocole HTTPS, sous « Installation rapide », cliquez sur . Pour cloner le référentiel à l’aide d’une clé SSH, y compris un certificat émis par l’autorité de certification SSH de votre organisation, cliquez sur SSH, puis cliquez sur .

    Capture d'écran des notes d'installation rapide pour un référentiel vide. À droite de l’URL HTTPS du dépôt, une icône de copie est indiquée en orange foncé.

    Sinon, pour cloner votre dépôt dans Desktop, cliquez sur Configurer dans Desktop et suivez les instructions pour terminer le clonage.

    Capture d'écran des notes d'installation rapide pour un référentiel vide. Le bouton « Configurer sur le bureau » est encadré en orange foncé.

  3. Ouvrez TerminalTerminalGit Bash.

  4. Remplacez le répertoire de travail actuel par l’emplacement où vous voulez mettre le répertoire cloné.

  5. Tapez git clone, puis collez l’URL que vous avez copiée précédemment.

    git clone https://HOSTNAME/YOUR-USERNAME/YOUR-REPOSITORY
    
  6. Appuyez sur Entrée pour créer votre clone local.

    $ git clone https://HOSTNAME/YOUR-USERNAME/YOUR-REPOSITORY
    > Cloning into `Spoon-Knife`...
    > remote: Counting objects: 10, done.
    > remote: Compressing objects: 100% (8/8), done.
    > remove: Total 10 (delta 1), reused 10 (delta 1)
    > Unpacking objects: 100% (10/10), done.
    

Résolution des erreurs de clonage

Lors du clonage d’un référentiel, il est possible que vous rencontriez des erreurs.

Si vous ne parvenez pas à cloner un référentiel, vérifiez ce qui suit :