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 Enterprise Server 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://HOSTNAME/user/repo.git
  • Une URL SSH, comme git@HOSTNAME: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.

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 Enterprise Server. 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 ».

Tip

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. 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 ».

Tip

Vous pouvez utiliser une URL SSH pour cloner un référentiel sur votre ordinateur, ou comme moyen sécurisé de 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 Enterprise Server dans votre terminal. Pour plus d’informations, consultez « À propos de GitHub CLI ».