Comment puis-je spécifier une branche/étiquette lors de l'ajout d'un Git sous-module?

Remarque: Git 1.8.2 ajout de la possibilité de suivre des branches. Voir les réponses ci-dessous.

---

C'est un peu déroutant pour s'habituer à cela, mais submodules ne sont pas sur une branche. Ils sont, comme vous le dites, juste un pointeur à un particulier d'engager des sous-module du référentiel.

Cela signifie que, lorsque quelqu'un d'autre qui vérifie votre référentiel, ou tire votre code, et ne git sous-module de mise à jour, le sous-module est vérifié à la commettre.

Ce qui est excellent pour un sous-module qui ne change pas souvent, parce qu'alors tout le monde sur le projet peut avoir le sous-module à la même livraison.

Si vous souhaitez vous déplacer à la sous-module d'un particulier tag:

cd submodule_directory
git checkout v1.0
cd ..
git add submodule_directory
git commit -m "moved submodule to v1.0"
git push

Puis, un autre développeur qui veut avoir submodule_directory changé de marque, cela veut-il

git pull
git submodule update --init

git pull changements qui commettent leurs sous-module répertoire de points. git submodule update fait fusionne dans le nouveau code.

Git(2.22, T2 2019, a introduit git sous-module set-branche --direction de la abranche -- <submodule_path>)

Noter que si vous avez un existant sous-module qui n'est pas suivi une branche encore, puis (si vous avez git 1.8.2+):

• Assurez-vous que le parent repo sait que son sous-module suit désormais une branche:

  cd /path/to/your/parent/repo
  git config -f .gitmodules submodule.<path>.branch <branch>
  

• Assurez-vous que votre sous-module est en fait à la dernière de cette branche:

  cd path/to/your/submodule
  git checkout -b branch --track origin/branch
    # if the master branch already exist:
    git branch -u origin/master master
  

        
(avec "origine" étant le nom de la en amont à distance repo le sous-module a été cloné à partir d'.

        
Un git remote -v intérieur de ce sous-module affichera. Habituellement, il est "origine")

• N'oubliez pas d'enregistrer le nouvel état de votre sous-module dans votre parent repo:

  cd /path/to/your/parent/repo
  git add path/to/your/submodule
  git commit -m "Make submodule tracking a branch"
  

• Mise à jour ultérieure pour ce sous-module aurez à utiliser la --remote option:

  # update your submodule
  # --remote will also fetch and ensure that
  # the latest commit from the branch is used
  git submodule update --remote
  
  # to avoid fetching use
  git submodule update --remote --no-fetch 
  

---

Noter qu'avec Git 2.10+ (T3 2016), vous pouvez utiliser ' . " comme un nom de branche:

Le nom de la branche est enregistré comme submodule.<name>.branch dans .gitmodules pour update --remote.

Une valeur spéciale de . est utilisé pour indiquer que le nom de la branche dans le sous-module doit être le même nom que la branche courante dans le référentiel actuel.

---

Si vous souhaitez mettre à jour tous vos submodules à la suite d'une branche:

    git submodule update --recursive --remote

À noter que le résultat, pour chaque sous-module mis à jour, sera presque toujours un détaché de la TÊTE, comme Dan Cameron note dans sa réponse.

(Clintm notes dans les commentaires que, si vous exécutez git submodule update --remote et le sha1 est la même que la direction générale de la sous-module est actuellement sur, il ne rien faire et de laisser le sous-module encore "sur la branche" et pas dans décollement de la tête de l'état.)

Pour assurer la branche est effectivement vérifié (et qui ne modifie pas le SHA1 de la entrée spéciale qui représente le sous-module pour le parent repo), il suggère:

git submodule foreach -q --recursive 'branch="$(git config -f $toplevel/.gitmodules submodule.$name.branch)"; git checkout $branch'

Chaque sous-module sera toujours référence à la même SHA1, mais si vous faites des nouvelles validations, vous serez en mesure de pousser à eux, parce qu'ils seront référencés par la branche que vous souhaitez la sous-module de piste.

Après que pousser à l'intérieur d'un sous-module, n'oubliez pas d'aller à la maison mère pensions, d'ajouter, de s'engager et de pousser le nouveau SHA1 pour ceux qui sont modifiés submodules.

Notez l'utilisation de $toplevel, recommandé dans les commentaires par Alexander Pogrebniak.

$toplevel a été introduit dans git1.7.2 en Mai 2010: s'engager f030c96.

il contient le chemin absolu du répertoire de niveau supérieur (où .gitmodules est).

dtmland ajoute dans les commentaires:

Le foreach script échoue à la caisse submodules qui ne sont pas à la suite d'une direction générale.

Toutefois, cette commande vous donne à la fois:

 git submodule foreach -q --recursive 'branch="$(git config -f $toplevel/.gitmodules submodule.$name.branch)"; [ "$branch" = "" ] && git checkout master || git checkout $branch' –

La même commande, mais plus facile à lire:

git submodule foreach -q --recursive \
    'branch="$(git config -f $toplevel/.gitmodules submodule.$name.branch)"; \
     [ "$branch" = "" ] && \
     git checkout master || git checkout $branch' –

---

umläute affine dtmland's de commande avec une version simplifiée dans les commentaires:

git submodule foreach -q --recursive 'git checkout $(git config -f $toplevel/.gitmodules submodule.$name.branch || echo master)'

plusieurs lignes:

git submodule foreach -q --recursive \
  'git checkout \
  $(git config -f $toplevel/.gitmodules submodule.$name.branch || echo master)'

Un exemple de la façon dont j'utilise submodules.

1. Créer un nouveau référentiel
2. Puis clone d'un autre référentiel comme un sous-module
3. Alors nous avons ce sous-module d'utiliser une balise appelée V3.1.2
4. Et puis, nous nous engageons.

Et qui ressemble un peu à ceci:

git init 
vi README
git add README
git commit 
git submodule add git://github.com/XXXXX/xxx.yyyy.git stm32_std_lib
git status

git submodule init
git submodule update

cd stm32_std_lib/
git reset --hard V3.1.2 
cd ..
git commit -a

git submodule status 

Peut-être que c'est une aide (même si j'utilise une balise et non une branche)?

Submodules sont un peu étrange - ils sont toujours en "isolé" mode -, elles ne sont pas mis à jour avec le dernier commit sur une branche comme vous vous en doutez.

Cela fait sens quand vous pensez à ce sujet, cependant. Disons que je me suis créer un référentiel foo avec sous-module bar. Je pousse mes modifications et dites-vous de vérifier s'engager a7402be de référentiel foo.

Ensuite, imaginez que quelqu'un commet un changement de référentiel bar avant que vous pouvez faire de votre clone.

Lorsque vous découvrez commettre a7402be de référentiel foo, vous vous attendez à obtenir le même code, je l'ai poussé. C'est pourquoi submodules ne pas mettre à jour jusqu'à ce que vous leur dites explicitement et ensuite procéder à une nouvelle validation.

Personnellement, je pense submodules sont la partie la plus déroutante de Git. Il ya beaucoup d'endroits qui peuvent expliquer les submodules mieux que je peux. Je recommande Pro Git par Scott Chacon.

J'ai ceci dans mon .gitconfig fichier. C'est encore un projet, mais il s'est avéré utile comme de maintenant. Il m'aide à toujours remettre en place le submodules à leur direction générale.

[alias]

######################
#
#Submodules aliases
#
######################


#git sm-trackbranch : places all submodules on their respective branch specified in .gitmodules
#This works if submodules are configured to track a branch, i.e if .gitmodules looks like :
#[submodule "my-submodule"]
#   path = my-submodule
#   url = [email protected]/my-submodule.git
#   branch = my-branch
sm-trackbranch = "! git submodule foreach -q --recursive 'branch=\"$(git config -f $toplevel/.gitmodules submodule.$name.branch)\"; git checkout $branch'"

#sm-pullrebase :
# - pull --rebase on the master repo
# - sm-trackbranch on every submodule
# - pull --rebase on each submodule
#
# Important note :
#- have a clean master repo and subrepos before doing this !
#- this is *not* equivalent to getting the last committed 
#  master repo + its submodules: if some submodules are tracking branches 
#  that have evolved since the last commit in the master repo,
#  they will be using those more recent commits !
#
#  (Note : On the contrary, git submodule update will stick 
#to the last committed SHA1 in the master repo)
#
sm-pullrebase = "! git pull --rebase; git submodule update; git sm-trackbranch ; git submodule foreach 'git pull --rebase' "

# git sm-diff will diff the master repo *and* its submodules
sm-diff = "! git diff && git submodule foreach 'git diff' "

#git sm-push will ask to push also submodules
sm-push = push --recurse-submodules=on-demand

#git alias : list all aliases
#useful in order to learn git syntax
alias = "!git config -l | grep alias | cut -c 7-"

Le seul effet de choisir une branche pour un sous-module, c'est que, chaque fois que vous passez la --remote option dans le git submodule update ligne de commande, Git va vérifier dans le détaché de la TÊTE mode (si la valeur par défaut --checkout comportement est sélectionné) le dernier commit sélectionné distance branche.

Vous devez être particulièrement prudent lors de l'utilisation de cette branche à distance la fonction de suivi pour les submodules si vous travaillez avec une faible clones de submodules.
La direction de choisir à cet effet dans le sous-module des paramètres n'EST PAS celui qui sera cloné au cours de git submodule update --remote.
Si vous passez également le --depth paramètre et vous ne chargent pas Git sur la branche que vous voulez cloner -- et en fait, vous ne peut pas dans le git submodule update ligne de commande!! -- , il sera implicitement se comporter comme expliqué dans le git-clone(1) documentation pour git clone --single-branch lorsque l'explicite --branch paramètre est manquant, et donc il permet de cloner la branche primaire seulement.

Sans surprise, après le clone étape réalisée par le git submodule update, il va finalement essayer de consulter les dernières de s'engager pour la distance de la branche que vous avez définies précédemment pour le sous-module, et, si ce n'est pas la principale, il ne fait pas partie de votre clone simple, et par conséquent, il échouera avec

fatale: Besoin d'une seule révision

Pas en mesure de trouver de l'origine/NotThePrimaryBranch révision en sous-module path 'mySubmodule'