mise à jour du sous-module git

Ce GitPro page n'résumer la conséquence d'un git sous-module de mise à jour joliment

quand vous lancez git submodule update , il vérifie la version spécifique du projet, mais pas dans une branche. Cela s'appelle avoir une tête détachée - cela signifie que la tête du fichier pointe directement vers une propagation, et non vers une référence symbolique.

le problème est que vous ne voulez généralement pas travailler dans un environnement de la tête, parce qu'il est facile de perdre des changements .

Si vous faites une mise à jour initiale de submodule, commit dans ce répertoire submodule sans créer de branche dans laquelle travailler, puis lancez à nouveau la mise à jour de submodule git à partir du superproject sans vous engager dans l'intervalle, Git va écraser vos modifications sans vous en informer. Techniquement, vous ne perdrez pas le travail, mais vous n'aurez pas une branche pointant vers elle, il sera donc un peu difficile à récupérer.

---

Note Mars 2013:

, Comme mentionné dans " git sous-module de suivi des dernières ", un sous-module maintenant (git1.8.2) suivre une direction.

# add submodule to track master branch
git submodule add -b master [URL to Git repo];

# update your submodule
git submodule update --remote 
# or (with rebase)
git submodule update --rebase --remote

voir " git submodule update --remote vs git pull ".

MindTooth 's réponse illustrent une mise à jour manuelle (sans configuration locale):

git submodule -q foreach git pull -q origin master

dans les deux cas, cela va changer les références submodules (le gitlink , un entrée spéciale dans le parent repo index ), et vous aurez besoin d'ajouter, de commit et de pousser ces références de la principale repo.

La prochaine fois que vous clonerez ce parent repo, il peuplera les sous-modules pour refléter ces nouvelles références SHA1.

le reste de cette réponse détaille la caractéristique classique du sous-module (référence à un fixe commit, qui est le point tout derrière la notion de sous-module).

---

pour éviter ce problème, créez une branche lorsque vous travaillez dans un répertoire submodule avec le travail git checkout-b ou quelque chose d'équivalent. Quand vous faites la mise à jour du sous-module une deuxième fois, il va toujours revenir à votre travail, mais au moins vous avez un pointeur pour revenir à.

brancher des branches avec des sous-modules peut aussi être délicat. Si vous créez une nouvelle branche, ajoutez un sous-module là, puis revenez à une branche sans ce sous-module, vous avez toujours le répertoire de sous-module comme un répertoire Non suivi:

---

alors, pour répondre à vos questions:

est-ce que je peux créer des branches/modifications et utiliser push/pull comme je le ferais normalement repos, ou y a-t-il des choses à éviter?

vous pouvez créer une branche et pousser les modifications.

"151960920 d'AVERTISSEMENT" (de Git sous-module Tutoriel ): Toujours publier (push) le sous-module de changement avant de les publier (push) le changement de la superproject la référence. Si vous oubliez de publier le changement de submodule, d'autres ne pourront pas cloner le dépôt.

comment J'avance les sous-module référencé commettre de dire (tagged) 1.0 à 1.1 (même si le chef de l'original de la pension de titres est déjà à 2.0)

de La page " Compréhension Submodules " aide

submodules sont mis en œuvre à l'aide de deux pièces en mouvement:

• le "151950920 de fichier" et
• un type spécial d'arbre objet.

Ces ensemble de trianguler une révision spécifique d'un référentiel spécifique qui est vérifié dans un emplacement spécifique dans votre projet.

---

De la git sous-module page

vous ne pouvez pas modifier le contenu de la sous-module de l'intérieur de l'objectif principal du projet

100% correct: vous ne pouvez pas modifier un sous-module, ne faire référence qu'à l'une de ses commit.

C'est pourquoi, lorsque vous modifiez un sous-module de l'intérieur le projet principal, vous:

• besoin de commit et push à l'intérieur le sous-module (à l'amont du module), et
• ensuite, montez dans votre projet principal, et re-commit (afin que ce projet principal se réfère à la nouvelle sous-module commit que vous venez de créer et poussé)

un sous-module vous permet d'avoir une approche basée sur les composants développement, où le projet principal se réfère uniquement aux propagations spécifiques d'autres composants (ici"autres dépôts Git déclarés comme sous-modules").

un sous-module est un marqueur (commit) vers un autre dépôt Git qui n'est pas lié par le cycle de développement du projet principal: il (l '"autre" git repo) peut évoluer indépendamment.

C'est au projet principal de choisir dans cet autre repo tout ce dont il a besoin.

cependant, si vous voulez, hors de convenance , modifier l'un de ces sous-modules directement à partir de votre projet principal, Git vous permet de le faire, à condition que vous premier publier ces modifications de sous-modules à son git repo original, et puis engager votre projet principal se référant à un nouvelle version de ladite sous-module.

mais l'idée principale reste: référencement des composants spécifiques qui:

• ont leur propre cycle de vie
• ont leur propre ensemble d'étiquettes
• ont leur propre développement

la liste des engagements spécifiques auxquels vous faites référence dans votre projet principal définit votre configuration (c'est ce que Configuration la gestion est tout au sujet, englobing simple Version système de contrôle )

si un composant pouvait vraiment être développé en même temps comme votre projet principal (parce que toute modification sur le projet principal impliquerait la modification du sous-répertoire, et vice-versa), alors ce serait un" sous-module " pas plus, mais un sous-Tree fusionner (également présenté dans la question transfert de la base de code d'héritage de cvs au dépôt distribué ), reliant l'histoire des deux git repo ensemble.

est-ce que cela aide à comprendre la vraie nature des sous-Règles de gitan?