Baixando submódulo do Git e Github

Nesse post vamos entender como baixar submódulos do Github juntamente com o clone do projeto.

O que são submódulos do git ?

De uma forma bem resumida, é um git dentro de outro git.

Mas pra que isso serve ?

Digamos que você esteja desenvolvendo um blog que utiliza um template de terceiro. Esse template por sua vez, tem seu próprio repositório git e seria interessante que você mantivesse sempre essa pasta atualizada no seu atual repositório, seja lá por motivos de segurança ou de otimização. Para que você não precise ficar baixando esse módulo separado da sua pasta e copiar/colar em seguida no seu repositório, você pode adicionar um “git de terceiro” dentro do seu repositório e atualizar sempre que você quiser (normalmente com git pull). Esse recurso é chamado de submódulo no git.

E como adicionar um submódulo no meu repositório ?

Dentro do seu repositório git já iniciado, você deve escolher uma subpasta e apontar o link do repositório através do comando abaixo.

No exemplo abaixo, vamos adicionar um submódulo dentro da subpasta “teste” do seu repositório:

# o link é de um repositório válido do github
# A forma de adicionar um submódulo é muito parecida com a de clonar um repositório com o comando "git clone"
git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke.git teste

Pronto, agora toda vez que eu quiser atualizar essa pasta com o seu repositório git, eu entro dentro dessa pasta e executo o “git pull”, da mesma forma que faríamos com qualquer outro projeto:

# acessando a pasta do submódulo
cd teste
# atualizando o git com o repositório remoto
git pull

E quando eu baixar meu repositório em outro local, os submódulos ja são baixados juntos automaticamente ?

A resposta é não. A pasta do submódulo vem baixada, porém vem vazia, mas isso é fácil de resolver, basta adicionar o comando –recursive assim que você baixar o repositório:

git push [https://link-do-seu-projeto.git] --recursive

pronto, tudo nos conformes

E para listar os submódulos que meu projeto tem:

Simples: 

git submodule

A saída vai ser algo parecido com isso: 

1b21063360f0f7905f0ae9d736d14da0c4393e87 blog/public (heads/master)
+0340796dd5889154b8d1e71d09b75bf2883f2bab blog/themes/ananke (v2.5.6-113-g0340796)

Nessa saída, temos dois submódulos, sendo que o primeiro está na pasta blog/public e o segundo está em blog/themes/ananke.

Como eu vejo o link do repositório do submódulo ?

Com a informação acima em mãos, eu posso ir na pasta do repositório. No exemplo abaixo, vamos acessar a pasta blog/public: 

cd blog/public

Agora vamos executar o comando git remote –verbose para verificar o link do repositório remoto: 

git remote -v

A saída vai ser mais ou menos assim: 

origin  https://github.com/theNewDynamic/gohugo-theme-ananke.git (fetch)
origin  https://github.com/theNewDynamic/gohugo-theme-ananke.git (push)

Se você quiser um repositório de exemplo que contenha submódulos reais, você pode clonar o repositório git desse blog no link abaixo:

https://github.com/diegolinkk/blog

Por hoje é só.

Fontes