Sto cercando di inserire un sottomodulo in un repository. Il problema è che quando clono il repository principale, la cartella del sottomodulo è completamente vuota.

C'è un modo per farlo in modo che git clone parent_repoinserisca effettivamente i dati nella cartella del sottomodulo?

Ad esempio, http://github.com/cwolves/sequelize/tree/master/lib/ , nodejs-mysql-nativeindica un sottomodulo git esterno, ma quando eseguo il checkout del sequelizeprogetto, quella cartella è vuota.

Con la versione 2.13 di Git e successive, è --recurse-submodulespossibile utilizzare invece di --recursive:

git clone --recurse-submodules -j8 git://github.com/foo/bar.git
cd bar

^{Nota dell'editore: -j8è un'ottimizzazione delle prestazioni opzionale che è diventata disponibile nella versione 2.8 e recupera fino a 8 sottomoduli alla volta in parallelo - vedi man git-clone.}

Con la versione 1.9 di Git fino alla versione 2.12 ( -jflag disponibile solo nella versione 2.8+):

git clone --recursive -j8 git://github.com/foo/bar.git
cd bar

Con la versione 1.6.5 di Git e successive, puoi usare:

git clone --recursive git://github.com/foo/bar.git
cd bar

Per repository già clonati o versioni precedenti di Git, utilizzare:

git clone git://github.com/foo/bar.git
cd bar
git submodule update --init --recursive

Devi fare due cose prima che un sottomodulo venga riempito:

git submodule init 
git submodule update

Git 2.23 (Q3 2019): se vuoi clonare e aggiornare i sottomoduli alla loro ultima revisione:

git clone --recurse-submodules --remote-submodules

Se vuoi solo clonarli nel loro SHA1 registrato:

git clone --recurse-submodules

Vedi sotto.

Risposta originale 2010

Come menziona joschi nei commenti, git submoduleora supporta l' --recursiveopzione (Git1.6.5 e altro).

Se --recursivespecificato, questo comando ricercherà nei sottomoduli registrati e aggiornerà tutti i sottomoduli annidati all'interno.

Vedi Lavorare con i sottomoduli git in modo ricorsivo per la parte init.
Vedi git submodulespiegato di più.

Con la versione 1.6.5 di git e successive, puoi farlo automaticamente clonando il super-progetto con l' –-recursiveopzione:

git clone --recursive git://github.com/mysociety/whatdotheyknow.git

Aggiornamento 2016, con git 2.8: vedi " Come velocizzare / parallelizzare i download dei sottomoduli git usando git clone --recursive? "

È possibile avviare il recupero del sottomodulo utilizzando più thread, in parallelo.
Per esempio:

git fetch --recurse-submodules -j2

Ancora meglio, con Git 2.23 (3 ° trimestre 2019), puoi clonare ed effettuare il checkout del sottomodulo nel loro ramo di tracciamento in un solo comando!

Vedi commit 4c69101 (19 maggio 2019) di Ben Avison ( bavison) .
^{(Unito da Junio ​​C Hamano - gitster- in commit 9476094 , 17 giugno 2019)}

clone: aggiungi --remote-submodulesflag

Quando si utilizzava, in git clone --recurse-submodulesprecedenza non esisteva alcun modo per passare un --remotepassaggio al git submodule updatecomando implicito per qualsiasi caso d'uso in cui si desidera eseguire il checkout dei sottomoduli sul ramo di tracciamento remoto anziché con SHA-1 registrato nel superprogetto.

Questa patch corregge questa situazione.
In realtà passa --no-fetchper git submodule updatecosì per i motivi che sottomodulo è appena stato clonato, così recupero dal telecomando nuovamente serve solo a rallentare le cose.

Questo significa:

--[no-]remote-submodules:

Tutti i sottomoduli che vengono clonati useranno lo stato del ramo di tracciamento remoto del sottomodulo per aggiornare il sottomodulo, piuttosto che lo SHA-1 registrato del superprogetto. Equivale a passare --remotea git submodule update.

[Risposta rapida]

È possibile utilizzare questo comando per clonare il repository con tutti i sottomoduli:

git clone --recursive YOUR-GIT-REPO-URL

Oppure se hai già clonato il progetto, puoi utilizzare:

git submodule init
git submodule update

Se il tuo sottomodulo è stato aggiunto in un ramo assicurati di includerlo nel comando clone ...

git clone -b <branch_name> --recursive <remote> <directory>

Prova questo:

git clone --recurse-submodules

Inserisce automaticamente i dati del sottomodulo supponendo che abbiate già aggiunto i sottomoduli al progetto principale.

Penso che tu possa andare con 3 passaggi:

git clone
git submodule init
git submodule update

risposta in ritardo

// git CLONE INCLUDE-SUBMODULES ADDRESS DESTINATION-DIRECTORY
git clone --recursive https://USERNAME@bitbucket.org/USERNAME/REPO.git DESTINATION_DIR

Dato che ho trascorso un'ora intera a giocherellare con un amico: anche se hai i diritti di amministratore su BitBucket, clona sempre il repository ORIGINAL e usa la password di chi possiede il repository. Fastidioso scoprire che ti sei imbattuto in questa minetrap: P.

Prova questo per includere i sottomoduli nel repository git.

git clone -b <branch_name> --recursive <remote> <directory>

o

git clone --recurse-submodules

È possibile utilizzare la --recursivebandiera durante la clonazione di un repository. Questo parametro forza git a clonare tutti i sottomoduli definiti nel repository.

git clone --recursive git@repo.org:your_repo.git

Dopo la clonazione, a volte i rami dei sottomoduli possono essere modificati, quindi eseguire questo comando dopo di esso:

git submodule foreach "git checkout master"

[Risposta rapida]

Dopo aver clonato il repository principale (che conteneva alcuni repository di sottomodulo), procedere come segue:

git submodule update --init --recursive

Il recupero parallelo di sottomoduli mira a ridurre il tempo necessario per recuperare un repository e tutti i relativi sottomoduli consentendo il recupero di più repository contemporaneamente. Questo può essere realizzato usando la nuova opzione --jobs, ad es .:

git fetch --recurse-submodules --jobs=4

Secondo il team Git, questo può velocizzare notevolmente l'aggiornamento dei repository che contengono molti sottomoduli. Quando si utilizza --recurse-submodules senza la nuova opzione --jobs, Git recupererà i sottomoduli uno alla volta.

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

Ho avuto lo stesso problema per un repository GitHub. Nel mio account mancava la chiave SSH. Il processo è

1. Genera chiave SSH
2. Aggiunta di una nuova chiave SSH al tuo account GitHub

Quindi, è possibile clonare il repository con submodules ( git clone --recursive YOUR-GIT-REPO-URL)

o

Esegui git submodule inite git submodule updaterecupera i sottomoduli nel repository già clonato.

Prova questo.

git clone -b <branch_name> --recursive <remote> <directory>

Se il sottomodulo è stato aggiunto in un ramo, assicurarsi di aggiungerlo al comando clone.

Se si tratta di un nuovo progetto, puoi semplicemente fare così:

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

Se è già installato di:

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