À 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 votre instance GitHub Enterprise Server.
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 ».
Conseils :
- Vous pouvez utiliser un assistant d’informations d’identification pour que Git mémorise vos informations d’identification GitHub chaque fois qu’il communique avec GitHub. Pour plus d’informations, consultez « Mise en cache de vos informations d’identification GitHub dans Git ».
- Pour cloner un référentiel sans s’authentifier auprès de GitHub Enterprise Server sur la ligne de commande, vous pouvez utiliser GitHub Desktop pour cloner à la place. Pour plus d’informations, consultez « Clonage d’un dépôt de GitHub vers GitHub Desktop ».
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 votre instance GitHub Enterprise Server. 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 ».
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 Enterprise Server 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 avec la version 3.13 de GitHub. Pour plus d'informations, consultez le blog de 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 ».