Comment “git clone”, y compris les submodules?

Je suis en train de mettre un sous-module dans une prise en pension. Le problème est que lorsque je clone le parent pensions de titres, les sous-module dossier est entièrement vide.

Est-il possible de faire en sorte que git clone parent_repo se met les données dans le sous-module dossier?

Par exemple, http://github.com/cwolves/sequelize/tree/master/lib/, nodejs-mysql-native est pointant sur un externe git sous-module, mais quand je l'extraction de la sequelize projet, ce dossier est vide.

Cette commande serait git clone --recurse-submodules --remote-submodules (T3 2019 Git 2.23): il permet de cloner et de mettre à jour les submodules en une seule commande. Voir mon édité réponse ci-dessous.

InformationsquelleAutor Mark | 2010-09-26

git git-submodules

2829

Avec la version 2.13 de Git et, plus tard, --recurse-submodules peut être utilisé à la place de --recursive:
```
git clone --recurse-submodules -j8 git://github.com/foo/bar.git
cd bar
```
^{note de l'Éditeur: -j8 est une option d'optimisation de la performance devenues disponibles dans la version 2.8, et atteint jusqu'à 8 submodules à un moment en parallèle — voir man git-clone.}

Avec la version 1.9 de Git jusqu'à la version 2.12 (-j drapeau uniquement disponible dans la version 2.8+):
```
git clone --recursive -j8 git://github.com/foo/bar.git
cd bar
```
Avec la version 1.6.5 de Git et plus tard, vous pouvez utiliser:
```
git clone --recursive git://github.com/foo/bar.git
cd bar
```
Déjà cloné repos, ou les anciennes versions Git, utilisation:
```
git clone git://github.com/foo/bar.git
cd bar
git submodule update --init --recursive
```
- Est-il possible de spécifier ce comportement par défaut dans votre dépôt git, de sorte que les moins bien informés cloneurs sera automatiquement initialisée sous-module?
- Malheureusement, non. (Pas que je sache, au moins.)
- Et logiquement penser git clone --recursive également remplir toutes les submodules d'un sous-module, droit?
- il ne semble pas: stackoverflow.com/questions/4251940/...
- vous pourriez envisager de git subtree blogs.atlassian.com/2013/05/... Elle résout le problème de @NHDaly commentaire
- sûr, il suffit d'ajouter ceci dans votre ~/.gitconfig en vertu de la [alias] section: cloner = clone --recursive
- Alors que c'est utile, il n'a pas répondu @NHDaly de la question. .gitconfig paramètres sont globaux, et pas seulement pour un seul référentiel.
- ah vous avez raison monsieur. J'ai mal lu la question.
- Après avoir fait un ou l'autre, il est sage de changer de source pour la branche master (ou la branche) depuis votre pension sera sorte de tête. De haut niveau des pensions de -- git submodule foreach git checkout master
- est-il sage? Que faire si la tenue des pensions de besoin d'une version d'un sous-module qui est pas master?
- Merci... si c'est de toute branche autre que le maître, comme mentionné, substituer à la master avec votre choix de nom de la branche autres que master.
- Même ainsi, la bonne s'engager n'est pas nécessairement à l'extrémité de la branche.
- vous pouvez utiliser git submodule update --depth 10 --recursive --init peu profondes le repo
- Cela ne fonctionne pas avec git 2.7, mais il a travaillé avec git 2.9
- Merci! J'avais oublié de récupérer le sous-module de dépendance contenu avec git submodule update --init --recursive avant d'exécuter sh -c 'cd cmd/ios7crypt && go install'
- Je n'ai git submodule update --init --recursive mais tous les submodules sont en dechated chef de l'etat, je dois aller dans chaque sous-module et checkout master. Quelqu'un sait pourquoi?
- J'ai git 1.9.1 et git clone --recursive -j8 [email protected]:repoToClone ne fonctionne pas. Il me dit error: unknown switch j' ` Si je supprime le -j8 cela fonctionne sans problème
- Comme il semble, le drapeau nom a été mis à jour à --recurse-submodules
- Je pense que je reviens à cette réponse une fois par mois... Pourquoi ne pas git il suffit de demander sur le clonage si elle doit également télécharger les submodules?
- Cela a fonctionné pour moi, merci une tonne!
- Je suppose que l'-j8 option n'est pas disponible pour déjà clone de repos?
- Si le repos n'est pas public et un jeton d'identification/authentification est nécessaire, ce cmd va vous demander d'entrer de nouveau et de nouveau le jeton d'accès/ ou user_password pour chaque sous-module. Est-il une solution de contournement?
- Je ne pouvais pas trouver tout de dépréciation note ni dans les notes de version, ni dans le code source. --recurse-submodules est le documentées et de façon préférée, mais --recursive n'est pas déconseillée.
- Vous êtes de droite. Quelqu'un avait modifié ma réponse en ajoutant que la déclaration en quelque sorte et cela a été accepté. J'ai corrigé maintenant. Merci!
- Également à préciser (car je voulais savoir et je ne pouvais pas trouver une réponse, sauf en regardant le source), le git clone --recursive et --recurse-submodules options se comportent de façon identique. Ils la suite d'un appel à la même fonction.
- "Est-il un moyen de spécifier ce comportement par défaut dans votre dépôt git"; oui, le mettre dans votre fichier README
InformationsquelleAutor Mathias Bynens
460

Que vous avez à faire deux choses avant d'un sous-module seront remplies:
```
git submodule init 
git submodule update
```
- J'avais peur de ça... il n'a pas de sens puisque vous êtes de la vérification partielle d'un projet, dans ce cas. Je comprends que le sous-module de mises à jour ne sont pas automatiques, mais pourquoi n'est-il pas lié à la version automatiquement vérifié?? Est-il un moyen de le forcer? J'ai un projet avec 3 niveaux de submodules et il semble absurde d'avoir à traverser de loin juste pour faire une extraction.
- Veuillez lire la git-submodule(1) page de man (kernel.org/pub/software/scm/git/docs/git-submodule.html). Vous verrez que git submodule update prend en charge une belle paramètre appelé --recursive.
- Pourquoi ne pas juste faire les deux en une seule commande? git submodule update --init (Voir aussi ma réponse).
- Je pense que c'est mieux de répondre à la question avec ces deux commandes. Sa explique mieux comment accomplir la tâche.
- Une machine que je viens de connecté uniquement a git 1.5.5.6, qui, apparemment, ne prend pas en charge le raccourcissement de l'instruction, mais prend en charge comme les deux commandes.
- Je pense que vous avez mal compris. git submodule update --init doit être élargi pour git submodule init; git submodule update dans 1.5.5.6.
- Après je fais cela, alors si j'ai un cd dans le sous-module de répertoire et de git pull il dit que sa tête est détachée et je ne peux pas faire git pull dans à la mise à jour, aucun moyen de résoudre ce problème?
- Cela ne fonctionne que pour moi. Merci
InformationsquelleAutor LiraNuna
192

Git 2.23 (T3 2019): si vous voulez cloner et mettre à jour les submodules à leur dernière révision:
```
git clone --recurse-submodules --remote-submodules
```
Si vous voulez juste clone à leur enregistré SHA1:
```
git clone --recurse-submodules
```
Voir ci-dessous.

Original de la réplique 2010

Comme joschi mentionne dans les commentaires, git sous-module prend désormais en charge la --recursive option (Git1.6.5 et plus).

Si --recursive est spécifié, cette commande de manière récursive dans le régime enregistré d'submodules, et de mettre à jour toutes les submodules à l'intérieur.

Voir Travailler avec des submodules de manière récursive pour le init.

Voir git sous-module expliqué pour plus d'.

Avec la version 1.6.5 de git et plus tard, vous pouvez le faire automatiquement par le clonage de la super-projet avec la –-recursive option:
```
git clone --recursive git://github.com/mysociety/whatdotheyknow.git
```
Mise à jour en 2016, avec git 2.8: voir "Comment faire pour accélérer /paralléliser les téléchargements de submodules à l'aide de git clone --recursive?"

Vous pouvez lancer l'extraction de la sous-module en utilisant plusieurs threads en parallèle.

Pour les instances:
```
git fetch --recurse-submodules -j2
```
Encore mieux, avec Git 2.23 (T3 2019), vous pouvez le copier et extraire les sous-module de suivi de branche en une seule commande!

Voir s'engager 4c69101 (19 Mai 2019) par Ben Avison (`).

^{(Fusionnés par Junio C Hamano -- gitster -- dans s'engager 9476094, 17 Juin 2019)}

clone: ajouter --remote-submodules drapeau

Lors de l'utilisation de git clone --recurse-submodules il n'y avait auparavant aucun moyen de
passer une --remote passer à l'implicite git submodule update de commande pour
toute utilisation les cas où vous souhaitez les submodules être vérifié sur leur
à distance de suivi de branche plutôt qu'avec le SHA-1 est enregistré dans l'superproject.

Ce patch corrige cette situation.

Il passe --no-fetch à git submodule update aussi bien sur le terrain qu'ils le sous-module a seulement été clonés, de sorte que l'extraction à partir de la télécommande de nouveau ne sert qu'à ralentir les choses.

Qui signifie:
```
--[no-]remote-submodules:
```
Tous les submodules qui sont clonés utilisera le statut de la sous-module de télécommande du suivi de la branche pour mettre à jour le sous-module, plutôt que de la superproject enregistré de l'algorithme SHA-1. L'équivalent de passage --remote à git submodule update.
- Il a donc fallu Git 14 ans pour commencer à ajouter un soutien approprié pour les submodules, hein. Merci pour la mise à jour! Que faire si j'ai déjà un clone de la principale repo sans submodules et sans enregistrées SHA1, et j'ai envie de tirer dans la dernière version de chaque sous-module. Est-il faisable?
- Si cloné référentiel a submodules, il a "enregistré SHA1". Et un git submodule update --init --recursive --remote devrait les mettre à jour à la dernière validation de leur direction respective. (ex: stackoverflow.com/a/56981834/6309)
- Laissez-moi vous expliquer avec un exemple: j'ai un modèle de projet sur Github qui utilise des submodules, et j'ai même commis des révisions spécifiques de la submodules dans ce modèle repo. Mais quand je créer un nouveau projet de ce dépôt, aucune des commandes que vous avez énumérés (ni clone --recurse-submodules --remote-submodules ni submodule update --init --recursive --remote) permettez-moi de réellement chercher la subrepos. Tout ce que j'obtiens est un .gitmodules fichier, et je ne pouvais pas trouver n'importe quel moyen pour initialiser le subrepos autres que manuellement le clonage un par un. J'aimerais au moins avoir un script pour le faire avec submodule foreach...
- Si vous connaissez une solution, j'aimerais poser une autre question que vous pourriez répondre. Voici le test de pensions de titres que je ne peux pas trouver un moyen de init autres que par la main: github.com/VioletGiraffe/TEST
- C'est parce que vous avez ajouté et a commis l' .gitmodules mais pas le gitlink (stackoverflow.com/a/16581096/6309, spécial entrées dans l'index: stackoverflow.com/a/19354410/6309) Voici un référentiel qui n'ont le bon gitlink inscrit: github.com/tiagomazzutti/antlr4dart
- Solution: cloner votre dépôt, supprimez le .gitmodules, d'ajouter et de s'engager. Puis ajouter les submodules de nouveau: git submodule add cpputils https://github.com/VioletGiraffe/cpputils.git et git submodule add cpp-template-utils https://github.com/VioletGiraffe/cpp-template-utils. Ajouter, commit et push. Vous verrez alors votre submodules, et peut clone qui référentiel avec, a déclaré submodules.
- Bon, je comprends que, et il fonctionne pour tous "normal" repo-vous créer à partir de zéro. Je pense que nous sommes à la recherche à un Github bug en ce qui concerne la manipulation subrepos dans les modèles de projet plus précisément, parce que le modèle d'origine repo a gitlinks ainsi, mais pas le nouveau projet créé à partir de ce modèle. P. S. Merci pour les réponses!
- Vous pouvez toujours mettre à jour que le modèle de projet avec le processus que j'ai mentionnés. Mais oui, cela ressemble à un bug sur GitHub côté. Ce serait intéressant pour illustrer/détail que dans une question distincte. Je vais y répondre quand je reviens du travail.
InformationsquelleAutor VonC
60

Vous pouvez utiliser cette commande pour cloner votre dépôt avec tous les submodules:
```
git clone --recursive YOUR-GIT-REPO-URL
```
Ou si vous avez déjà cloné le projet, vous pouvez utiliser:
```
git submodule init
git submodule update
```
InformationsquelleAutor Javier C.
31

Si votre sous-module a été ajouté dans une branche assurez-vous d'inclure dans votre commande clone...
```
git clone -b <branch_name> --recursive <remote> <directory>
```
- Cela ressemblait plus à ce que je cherchais... mais les submodules la liste de leur branche comme "détaché". 🙁
InformationsquelleAutor Mars Redwyne
28

Essayez ceci:
```
git clone --recurse-submodules
```
Il extrait automatiquement dans le sous-module de données en supposant que vous avez déjà ajouté les submodules pour le projet parent.
- Notez que --recurse-submodules et --recursive sont équivalent alias.
- que faire si vous êtes déjà dans le parent cloné repo?
- dans ce cas, vous pouvez faire git submodule update --init --recursive comme expliqué dans cette réponse
InformationsquelleAutor nweiler
23

Je pense que vous pouvez aller avec 3 étapes:
```
git clone
git submodule init
git submodule update
```
InformationsquelleAutor muhammad ali
20

réponse tardive
```
//git CLONE INCLUDE-SUBMODULES ADDRESS DESTINATION-DIRECTORY
git clone --recursive https://[email protected]/USERNAME/REPO.git DESTINATION_DIR
```
Que je viens de passer une heure ensemble de bidouiller avec un ami: Même si vous avez les droits d'Admin sur BitBucket, toujours cloner le dépôt ORIGINAL et utilisez le mot de passe de celui qui détient le repo. Gênant de savoir que vous avez couru dans ce minetrap 😛
- C'est exactement ce que je fais face à. Donc, vous dites que quelqu'un qui a besoin de développer sur un bitbucket référentiel qui a submodules doit utiliser le référentiel du créateur informations d'identification? Blech.
- Semble - il suce le GROS TEMPS... et je le sais.
- Cela ressemble à un bug. Avez-vous signaler à Bitbucket?
- Avez-vous tombez sur cette question? C'est un ans et demi plus tard et en fait je ne sais pas si c'est toujours le cas.
- Non, je viens de tombé sur votre réponse et a été surpris.
- C'est le cas uniquement si vous utilisez le protocole HTTPS et l'utilisateur est dans l'URL? La "bonne" façon est d'utiliser le SSH auth avec une clé privée/publique paire, de sorte que le mot de passe ne serait pas demandé.
- Cette réponse devrait vraiment être supprimé
- pourquoi?
- Il n'est pas descriptive réponse de la Fpo question, mais les détails un autre bug dans Bitbucket; ce qui, soit dit en passant, pourrait être simplement réduite à "utiliser l'authentification par clé SSH".
- documenté ici, comme il n'était pas clair qu'il est Atlassians faute. Voir upvotes: Apparemment d'autres ppl avoir couru dans cette, recherche pour ce problème et ont été heureux qui DONC est bien indexé dans les moteurs de recherche.
InformationsquelleAutor kaiser
18

Essayer ce, y compris pour les submodules dans le dépôt git.
```
git clone -b <branch_name> --recursive <remote> <directory>
```
ou
```
git clone --recurse-submodules
```
InformationsquelleAutor radhey shyam
15

Vous pouvez utiliser le --recursive drapeau lors du clonage d'un référentiel. Ce paramètre force git clone tous les submodules dans le référentiel.
```
git clone --recursive [email protected]:your_repo.git
```
Après le clonage, parfois submodules branches peuvent être modifiées, afin d'exécuter cette commande après:
```
git submodule foreach "git checkout master"
```
InformationsquelleAutor Ahmad Azimi
14

[Réponse Rapide]

Après le clonage de la mère repo (qui contient des sous-module repo), effectuez les opérations suivantes:
```
git submodule update --init --recursive
```
InformationsquelleAutor Benyamin Jafari
11

Submodules parallèle chercher vise à réduire le temps nécessaire pour récupérer une référentiels et de tous ses submodules en permettant la récupération de plusieurs référentiels à la fois. Ceci peut être accompli en utilisant le nouveau --les travaux de l'option, par exemple:
```
git fetch --recurse-submodules --jobs=4
```
Selon Git de l'équipe, cela peut considérablement accélérer la mise à jour des référentiels qui contiennent de nombreux submodules. Lors de l'utilisation de --recurse-submodules sans la nouvelle --les travaux de l'option, Git va chercher submodules un par un.

Source: http://www.infoq.com/news/2016/03/git28-released

InformationsquelleAutor Long Nguyen
6

J'ai eu le même problème pour un dépôt GitHub. Mon compte était en manque de Clés SSH. Le processus est
1. Générer des Clés SSH
2. L'ajout d'une nouvelle clé SSH à votre compte GitHub
Ensuite, vous pouvez cloner le dépôt avec submodules (git clone --recursive YOUR-GIT-REPO-URL)

ou

Exécuter git submodule init et git submodule update chercher submodules déjà cloné référentiel.

InformationsquelleAutor FatalError
5

De l'essayer.
```
git clone -b <branch_name> --recursive <remote> <directory>
```
Si vous avez ajouté le sous-module dans une branche assurez-vous que vous l'ajouter à la commande clone.

InformationsquelleAutor Himeshika96

Si c'est un nouveau projet, vous pouvez faire comme ceci :

$ git clone --recurse-submodules https://github.com/chaconinc/YourProjectName

Si il est déjà installé que :

$ cd YourProjectName (for the cases you are not at right directory) 
$ git submodule init
$ git submodule update

InformationsquelleAutor nzrytmn

Vous devez vous connecter pour publier un commentaire.

clone: ajouter --remote-submodules drapeau

[Réponse Rapide]

`clone`: ajouter `--remote-submodules` drapeau