編集：
有効なソリューションについては@Simba Answerを参照してください
submodule.<name>.update変更したいものです。ドキュメントを参照してください - デフォルトcheckout
submodule.<name>.branchで追跡するリモートブランチを指定します- デフォルトmaster
古い答え：
個人的には、時間の経過とともに機能しなくなる可能性のある外部リンクへの回答をここで嫌い、ここで私の回答を確認します （質問が重複しない限り） -他の件名の行の間の件名をカバーする質問に送信しますが、全体的には次のようになります：「私は答えないで、ドキュメントを読んでください。」
質問に戻りましょう：なぜそれが起こるのですか？
あなたが説明した状況
サーバーから変更をプルした後、多くの場合、サブモジュールのヘッドがマスターブランチから切り離されます。
これは、サブモジュールをあまり頻繁に使用しない場合や、サブモジュールで開始したばかりの場合の一般的なケースです。私は 、サブモジュールのHEADがデタッチされるある時点で全員がそこにいたと述べたことは正しいと思います。
- 原因：サブモジュールが正しいブランチを追跡していません（デフォルトマスター）。
解決策：サブモジュールが正しいブランチを追跡していることを確認してください
$ cd <submodule-path>
# if the master branch already exists locally:
# (From git docs - branch)
# -u <upstream>
# --set-upstream-to=<upstream>
# Set up <branchname>'s tracking information so <upstream>
# is considered <branchname>'s upstream branch.
# If no <branchname> is specified, then it defaults to the current branch.
$ git branch -u <origin>/<branch> <branch>
# else:
$ git checkout -b <branch> --track <origin>/<branch>
- 原因：親リポジトリがサブモジュールブランチを追跡するように設定されていません。
解決策：次の2つのコマンドで新しいサブモジュールを追加して、サブモジュールがリモートブランチを追跡するようにします。
- まず、gitにリモコンを追跡するように指示します
<branch>。
- チェックアウトの代わりにリベースまたはマージを実行するようにgitに指示します
- リモートからサブモジュールを更新するようにgitに指示します。
$ git submodule add -b <branch> <repository> [<submodule-path>]
$ git config -f .gitmodules submodule.<submodule-path>.update rebase
$ git submodule update --remote
- このように既存のサブモジュールを追加していない場合は、簡単に修正できます。
- まず、追跡したいブランチがサブモジュールにチェックアウトされていることを確認します。
$ cd <submodule-path>
$ git checkout <branch>
$ cd <parent-repo-path>
# <submodule-path> is here path releative to parent repo root
# without starting path separator
$ git config -f .gitmodules submodule.<submodule-path>.branch <branch>
$ git config -f .gitmodules submodule.<submodule-path>.update <rebase|merge>
一般的なケースでは、上記の構成の問題の1つに関連していたため、DETACHED HEADはすでに修正されています。
DETACHED HEADの修正 .update = checkout
$ cd <submodule-path> # and make modification to your submodule
$ git add .
$ git commit -m"Your modification" # Let's say you forgot to push it to remote.
$ cd <parent-repo-path>
$ git status # you will get
Your branch is up-to-date with '<origin>/<branch>'.
Changes not staged for commit:
modified: path/to/submodule (new commits)
# As normally you would commit new commit hash to your parent repo
$ git add -A
$ git commit -m"Updated submodule"
$ git push <origin> <branch>.
$ git status
Your branch is up-to-date with '<origin>/<branch>'.
nothing to commit, working directory clean
# If you now update your submodule
$ git submodule update --remote
Submodule path 'path/to/submodule': checked out 'commit-hash'
$ git status # will show again that (submodule has new commits)
$ cd <submodule-path>
$ git status
HEAD detached at <hash>
# as you see you are DETACHED and you are lucky if you found out now
# since at this point you just asked git to update your submodule
# from remote master which is 1 commit behind your local branch
# since you did not push you submodule chage commit to remote.
# Here you can fix it simply by. (in submodules path)
$ git checkout <branch>
$ git push <origin>/<branch>
# which will fix the states for both submodule and parent since
# you told already parent repo which is the submodules commit hash
# to track so you don't see it anymore as untracked.
しかし、サブモジュールに対してすでにローカルでいくつかの変更を行ってコミットし、コミットした場合、これらをリモートにプッシュしてから、 'git checkout'を実行すると、Gitから次のように通知されます。
$ git checkout <branch>
Warning: you are leaving 1 commit behind, not connected to any of your branches:
If you want to keep it by creating a new branch, this may be a good time to do so with:
一時的なブランチを作成するための推奨されるオプションは良いかもしれません、そしてあなたはこれらのブランチをマージすることができます等。しかし、私は個人的にはgit cherry-pick <hash>この場合にのみ使用します。
$ git cherry-pick <hash> # hash which git showed you related to DETACHED HEAD
# if you get 'error: could not apply...' run mergetool and fix conflicts
$ git mergetool
$ git status # since your modifications are staged just remove untracked junk files
$ rm -rf <untracked junk file(s)>
$ git commit # without arguments
# which should open for you commit message from DETACHED HEAD
# just save it or modify the message.
$ git push <origin> <branch>
$ cd <parent-repo-path>
$ git add -A # or just the unstaged submodule
$ git commit -m"Updated <submodule>"
$ git push <origin> <branch>
サブモジュールをDETACHED HEAD状態にすることができるケースがいくつかありますが、特定のケースをデバッグする方法についてもう少し理解していただければ幸いです。