Skip to main content
Nous publions des mises à jour fréquentes de notre documentation, et la traduction de cette page peut encore être en cours. Pour obtenir les informations les plus actuelles, consultez la documentation anglaise.

À propos des référentiels distants

L’approche collaborative de GitHub du développement dépend de la publication de commits de votre dépôt local sur GitHub pour que d’autres personnes puissent voir, récupérer (fetch) et mettre à jour.

À propos des référentiels distants

URL distante est le terme que Git utilise pour désigner « l’emplacement où votre code est stocké ». Cette URL peut être votre référentiel sur GitHub ou sur la duplication d’un autre utilisateur, ou même sur un serveur complètement différent.

Vous ne pouvez envoyer qu’à deux types d’adresses URL :

  • Une URL HTTPS, comme https://github.com/user/repo.git
  • Une URL SSH, comme git@github.com:user/repo.git

Git associe une URL distante avec un nom, et votre référentiel distant par défaut est généralement appelé origin.

Création de référentiels distants

Vous pouvez utiliser la commande git remote add pour faire correspondre une URL distante avec un nom. Par exemple, vous entreriez ce qui suit dans la ligne de commande :

git remote add origin <REMOTE_URL>

Cela associe le nom origin à la REMOTE_URL.

Vous pouvez utiliser la commande git remote set-url pour modifier l’URL d’un référentiel distant.

Choix d’une URL pour votre référentiel distant

Il existe plusieurs façons de cloner des dépôts disponibles sur GitHub.com.

Lorsque vous affichez un référentiel lors de la connexion à votre compte, les URL que vous pouvez utiliser pour cloner le projet sur votre ordinateur sont disponibles sous les détails du référentiel.

Pour plus d’informations sur la définition ou la modification de votre URL distante, consultez « Gestion des référentiels distants ».

Clonage avec des URL HTTPS

Les URL de clonage https:// sont disponibles sur tous les référentiels, quelle que soit la visibilité. Les URL de clone https:// fonctionnent même si vous êtes derrière un pare-feu ou un proxy.

Lorsque vous git clone, git fetch, git pull ou git push dans un référentiel distant à l’aide d’URL HTTPS en ligne de commande, Git vous demande vos nom d’utilisateur et mot de passe GitHub. Lorsque Git vous invite à entrer votre mot de passe, entrez votre personal access token. Vous pouvez également utiliser une assistance des informations d’identification comme Git Credential Manager. L’authentification basée sur un mot de passe pour Git a été supprimée en faveur de méthodes d’authentification plus sécurisées. Pour plus d’informations, consultez « Création d’un personal access token ».

Si vous accédez à une organisation qui utilise l’authentification unique SAML et que vous utilisez un personal access token (classic), vous devez également autoriser votre personal access token à accéder à l’organisation avant de vous authentifier. Pour plus d’informations, consultez « À propos de l’authentification à l’aide de l’authentification unique SAML » et « Autorisation d’un personal access token à utiliser avec l’authentification unique SAML ».

Conseils :

Si vous préférez utiliser SSH, mais que vous ne pouvez pas vous connecter via le port 22, vous pouvez utiliser SSH via le port HTTPS. Pour plus d’informations, consultez « Utilisation de SSH sur le port HTTPS ».

Clonage avec des URL SSH

Les URL SSH fournissent l’accès à un référentiel Git via SSH, un protocole sécurisé. Pour utiliser ces URL, vous devez générer une paire de clés SSH sur votre ordinateur et ajouter la clé publique à votre compte sur GitHub.com. Pour plus d’informations, consultez « Connexion à GitHub avec SSH ».

Lorsque vous git clone, git fetch, git pull ou git push vers un référentiel distant à l’aide d’URL SSH, vous êtes invité à entrer un mot de passe et vous devez fournir la phrase secrète de votre clé SSH. Pour plus d’informations, consultez « Utilisation de phrases secrètes de clé SSH ».

Si vous accédez à une organisation qui utilise l’authentification unique SAML, vous devez autoriser votre clé SSH à accéder à l’organisation avant de vous authentifier. Pour plus d’informations, consultez « À propos de l’authentification avec l’authentification unique SAML » et « Autorisation d’une clé SSH à utiliser avec l’authentification unique SAML » dans la documentation GitHub Enterprise Cloud.

Conseil : Vous pouvez utiliser une URL SSH pour cloner un référentiel sur votre ordinateur ou pour déployer votre code sur des serveurs de production. Vous pouvez également utiliser le transfert de l’agent SSH avec votre script de déploiement pour éviter de gérer les clés sur le serveur. Pour plus d’informations, consultez « Utilisation du transfert d’agent SSH ».

Clonage avec GitHub CLI

Vous pouvez également installer GitHub CLI pour utiliser les workflows GitHub dans votre terminal. Pour plus d’informations, consultez « À propos de GitHub CLI ».

Clonage avec Subversion

Remarque : La prise en charge de Subversion sera supprimée de GitHub le 8 janvier 2024. Toute version de GitHub Enterprise Server ultérieure au 8 janvier 2024 supprimera également la prise en charge de Subversion. Pour en savoir plus à ce sujet, consultez le blog GitHub.

Vous pouvez également utiliser un client Subversion pour accéder à n’importe quel référentiel sur GitHub. Subversion offre un ensemble de fonctionnalités différent de Git. Pour plus d’informations, consultez « Quelles sont les différences entre Subversion et Git ? »

Vous pouvez également accéder aux référentiels sur GitHub à partir des clients Subversion. Pour plus d’informations, consultez « Prise en charge des clients Subversion ».