Skip to main content

À 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 « Création de dépôt 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 d’informations d’identification comme Git Credential Manager. L’authentification par 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 « Gestion de vos jetons d'accès personnels ».

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 unique SAML » et « Autorisation d’un jeton d’accès personnel à 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 à l’aide de 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 des 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 unique SAML » et « Autorisation d’une clé SSH pour l’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 ».