Cloner un dépôt
Le clonage copie un référentiel de GitHub, GitLab, Bitbucket, Azure DevOps ou n'importe quel serveur Git sur votre ordinateur, avec son historique. Dans GitTree, collez l'URL, choisissez où elle va et appuyez sur Clone ; il s'ouvre dans un nouvel onglet une fois terminé.
Fonctionne dans GitTree Gratuit : toutes les fonctionnalités Git locales, une fois connecté.
Sur cette page
Avant de commencer
- L'URL du référentiel, depuis sa page sur l'hôte :
https://…ougit@…(SSH). - Pour un référentiel privé, un moyen de se connecter : une clé SSH connue de l'hôte, ou un mot de passe ou un jeton que Git demande lorsqu'il en a besoin.
Où le trouver
- La carte Clone sur la page Nouvel onglet.
- La palette de commandes : Clone Repository….
- Avec un compte GitHub ou Bitbucket (GitTree Pro) connecté, Clone from GitHub / Bitbucket… sur la page Nouvel onglet répertorie vos référentiels parmi lesquels choisir.
| Action | macOS | Windows et Linux |
|---|---|---|
| Palette de commandes, puis Clone Repository… | ⌘⇧P | Ctrl+Shift+P |
Mesures
Collez l'URL du référentiel
Collez-le dans Repository URL. GitTree en remplit Folder name ; changez-le si vous voulez un autre nom.
Choisissez où il va
Tapez un Parent folder ou utilisez Browse…. Clones into affiche le dossier exact qui sera créé ; il doit être neuf ou vide.
Définissez les options dont vous avez besoin, puis clonez
Laissez Depth vide pour l'historique complet ou entrez un nombre de validations pour un clone superficiel. Cochez Also clone submodules si le projet les utilise. Gardez Open after cloning allumé, puis appuyez sur Clone.
Résultat attendu
Une barre de progression nomme chaque phase (réception d'objets, résolution de deltas, extraction de fichiers). Une fois terminé, le référentiel s'ouvre dans un nouvel onglet et apparaît sous Recent.
Vous pouvez arrêter avec Cancel Clone : GitTree supprime ce que le clone a écrit et ne supprime jamais un dossier qui existait auparavant.
Options de clonage
| Options | Ce que ça fait |
|---|---|
| Depth | Seuls les derniers commits sont téléchargés (un clone superficiel). Vide signifie l’historique complet. Vous pourrez récupérer plus d’historique plus tard. |
| Also clone submodules | Clone également les référentiels que le projet inclut en tant que sous-modules. |
| Sparse checkout | Extrait d'abord uniquement les fichiers de niveau supérieur, puis les dossiers que vous choisissez : utile pour les très grands référentiels. |
| Download file contents only when they are needed (blobless) | Télécharge l'historique mais récupère le contenu du fichier à la demande. |
| Open after cloning | Ouvre le nouveau référentiel dans un onglet une fois le clonage terminé. |
Si quelque chose ne va pas
"Impossible de cloner le référentiel"
Lisez Git’s output dans la boîte de dialogue : il nomme la cause (mauvaise URL, pas d'accès, réseau). Choisissez Edit and Try Again pour corriger l'URL ou le dossier.
"Ce dossier n'est pas vide"
La destination contient déjà des fichiers. Choisissez un autre Parent folder ou Folder name.
L'authentification a échoué pour un référentiel privé
Utilisez une URL SSH avec une clé connue de l'hôte, ou une URL HTTPS et un jeton d'accès personnel lorsque Git demande un mot de passe. GitHub et GitLab n'acceptent plus les mots de passe de compte via HTTPS.
Questions
Puis-je cloner sans connecter un compte d'hébergement ?
Oui. Le clonage avec une URL fait partie de GitTree Free et utilise vos propres informations d'identification Git. La navigation dans la liste des référentiels de votre fournisseur nécessite un compte connecté, qui fait partie de Pro.
