Wie Entferne ich ein Submodul?

Seit git1.8.3 (April 22nd, 2013):

Es wurde kein Porzellan Art zu sagen: "ich bin nicht mehr interessiert in diesem Submodul", sobald Sie Ihr Interesse an einem Submodul mit "submodule init".

"submodule deinit" ist die Art und Weise, dies zu tun.

Den Löschvorgang auch verwendet git rm (seit git1.8.5. Oktober 2013).

Zusammenfassung

Dem 3-Schritte-Entfernung-Prozess würde dann sein:

0. mv a/submodule a/submodule_tmp

1. git submodule deinit -f -- a/submodule    
2. rm -rf .git/modules/a/submodule
3. git rm -f a/submodule
# Note: a/submodule (no trailing slash)

# or, if you want to leave it in your working tree and have done step 0
3.   git rm --cached a/submodule
3bis mv a/submodule_tmp a/submodule

Erklärung

rm -rf: Dieses wird erwähnt in Daniel Schroeder's Antwort, zusammengefasst und durch Eonil in die Kommentare:

Diese Blätter .git/modules/<path-to-submodule>/ unverändert.

Wenn Sie also einmal löschen ein Submodul mit dieser Methode und re-fügen Sie Sie erneut, wird es nicht möglich sein, weil repository bereits beschädigt.

git rm: Siehe commit 95c16418:

Derzeit mit "git rm" auf ein Submodul entfernt die submodule arbeiten Baum aus, dass der superproject und die gitlink aus dem index.

Aber das Submodul Abschnitt in .gitmodules ist unberührt gelassen, das ist ein überbleibsel des jetzt entfernt, submodule und die eventuell reizen Benutzer (im Gegensatz zu der Einstellung im .git/config, das muss bleiben als Erinnerung, dass die Nutzer zeigten Interesse an diesem Submodul, so wird es neu besiedelt, später, wenn eine ältere commit ausgecheckt ist).

Lassen "git rm" helfen dem Benutzer, indem Sie nicht nur das entfernen der submodule aus der Arbeit Baum aber auch durch entfernen der "submodule.<submodule name>" Abschnitt des .gitmodules Datei und Phase sowohl.

git submodule deinit: Es ergibt sich aus dieser patch:

Mit "git submodule init" der Benutzer ist in der Lage zu sagen git-Sie kümmern sich über ein oder mehrere teilmodule und möchte es haben aufgefüllt der nächste Aufruf von "git submodule update".

Aber momentan gibt es keinen einfachen Weg, Sie können sagen, git es kümmert Sie nicht über ein Submodul nicht mehr und will, um loszuwerden, die lokalen Arbeits-Baum (es sei denn, der Benutzer weiß eine Menge über das Submodul Einbauten und entfernt die "submodule.$name.url" Einstellung von .git/config zusammen mit der Arbeit, der Baum selbst).

Helfen, die Benutzer durch Bereitstellung eines " deinit " - Befehl.

Diese entfernt die ganze submodule.<name> Abschnitt von .git/config entweder für die vorgegebenen
Submodul(s) (oder für all diejenigen, die schon initialisiert, wenn '.' gegeben ist).

Fehlschlagen, wenn die aktuellen arbeiten Baum enthält änderungen, es sei denn gezwungen.

Beschweren, wenn Sie für ein Submodul in der Befehlszeile angegeben wird die url-Einstellung nicht gefunden werden kann in .git/config, aber dennoch nicht scheitern.

Dieser kümmert sich, wenn die (de -) Initialisierung die Schritte (.git/config und .git/modules/xxx)

Seit git1.8.5, die git rm nimmt auch Pflege der:

• 'add' Schritt, das zeichnet die url von einem Submodul in der .gitmodules Datei: es müssen entfernt für Sie.
• das Submodul besonderen Eintrag (dargestellt durch diese Frage): die git rm entfernt Sie aus dem index:
  
  git rm --cached path_to_submodule (no trailing slash)
  
  Entfernt das Verzeichnis gespeichert in dem index mit einem speziellen Modus "160000", die ihn als ein Submodul root-Verzeichnis.

Wenn Sie vergessen, diesen letzten Schritt, und versuchen zu ergänzen, was war ein Submodul als regelmäßige Verzeichnis, erhalten Sie Fehlermeldung wie:

git add mysubmodule/file.txt 
Path 'mysubmodule/file.txt' is in submodule 'mysubmodule'

Hinweis: da Git 2.17 (Q2 2018), git submodule deinit ist nicht länger ein shell-Skript.

Es ist ein Aufruf einer C-Funktion.

Sehen commit 2e61273, commit 1342476 (14 Jan 2018) von Prathamesh Chavan (pratham-pc).

^{(Zusammengefasst von Junio C Hamano -- gitster -- in commit ead8dbe, 13 Feb 2018)}

git ${wt_prefix:+-C "$wt_prefix"} submodule--helper deinit \
  ${GIT_QUIET:+--quiet} \
  ${prefix:+--prefix "$prefix"} \
  ${force:+--force} \
  ${deinit_all:+--all} "$@"

InformationsquelleAutor VonC

Nur ein Hinweis. Da git 1.8.5.2, zwei Befehle machen:

git rm the_submodule
rm -rf .git/modules/the_submodule

Als @Mark Cheverton ' s Antwort richtig darauf hingewiesen, wenn die zweite Zeile nicht verwendet, auch wenn Sie entfernt das Submodul für jetzt, den Rest .git/modules/the_submodule Ordner wird verhindern, dass die gleichen Submodul wird wieder Hinzugefügt oder ersetzt werden, in der Zukunft. Auch, wie @VonC erwähnt, git rm werden die meisten der job auf einem Submodul.

--Update (07/05/2017)--

Nur um zu klären, the_submodule ist der relative Pfad von der submodule innerhalb des Projekts. Zum Beispiel, es ist subdir/my_submodule wenn das Submodul in einem Unterverzeichnis subdir.

Wie schon richtig in den Kommentaren und andere Antworten, die beiden Befehle (obwohl funktional ausreichend, um zu entfernen a-Submodul), hinterlassen eine Spur in der [submodule "the_submodule"] Abschnitt .git/config (Juli 2017), die entfernt werden können, mit einem Dritten Befehl:

git config -f .git/config --remove-section submodule.the_submodule 2> /dev/null

InformationsquelleAutor tinlyx

Einfachen Schritten

1. Entfernen, config-Einträge:
   git config -f .git/config --remove-section submodule.$submodulename
git config -f .gitmodules --remove-section submodule.$submodulename
2. Verzeichnis entfernen aus dem index:
   git rm --cached $submodulepath
3. Begehen
4. Löschen Sie nicht verwendete Dateien:
   rm -rf $submodulepath
rm -rf .git/modules/$submodulename

Bitte beachten Sie: $submodulepath nicht enthalten führende oder nachgestellte Schrägstriche.

Hintergrund

Wenn Sie git submodule add es nur fügt es zu .gitmodules, aber
wenn du das getan hast git submodule init, es Hinzugefügt, um .git/config.

Also, wenn Sie möchten, entfernen Sie die Module, aber in der Lage sein, um es wieder schnell,
dann tun genau dies:

git rm --cached $submodulepath
git config -f .git/config --remove-section submodule.$submodulepath

Ist es eine gute Idee, das zu tun git rebase HEAD ersten und git commit
am Ende, wenn man diese in einem Skript.

Haben auch einen Blick auf eine Antwort auf Kann ich unpopulate ein Git-submodule?.

InformationsquelleAutor

Entfernen Submodul Hinzugefügt:

git submodule add [email protected]:repos/blah.git lib/blah

Run:

git rm lib/blah

Das ist es.

Für ältere Versionen von git (circa ~1.8.5) verwenden:

git submodule deinit lib/blah
git rm lib/blah
git config -f .gitmodules --remove-section submodule.lib/blah

InformationsquelleAutor Doug

Können Sie ein alias verwenden, um zu automatisieren, die Lösungen, die von Dritten bereitgestellt werden:

[alias]
  rms = "!f(){ git rm --cached \"$1\";rm -r \"$1\";git config -f .gitmodules --remove-section \"submodule.$1\";git config -f .git/config --remove-section \"submodule.$1\";git add .gitmodules; }; f"

Setzen, dass in der git-config, und dann können Sie tun: git rms path/to/submodule

InformationsquelleAutor Charles

Wenn das Submodul wurde versehentlich Hinzugefügt, weil Sie Hinzugefügt haben, engagiert und schob einen Ordner, der war bereits ein Git-repository (enthalten .git), werden Sie nicht haben eine .gitmodules - Datei zu Bearbeiten, oder irgendetwas in .git/config. In diesem Fall brauchst du ist :

git rm --cached subfolder
git add subfolder
git commit -m "Enter message here"
git push

FWIW, Ich habe auch entfernt die .git Ordner, bevor Sie die git add.

InformationsquelleAutor Oli Studholme

Nach dem Experimentieren mit all den verschiedenen Antworten, die auf dieser Website, landete ich mit dieser Lösung:

#!/bin/sh
path="$1"
if [ ! -f "$path/.git" ]; then
  echo "$path is no valid git submodule"
  exit 1
fi
git submodule deinit -f $path &&
git rm --cached $path &&
rm -rf .git/modules/$path &&
rm -rf $path &&
git reset HEAD .gitmodules &&
git config -f .gitmodules --remove-section submodule.$path

Dieser wieder die exakt gleichen Zustand, wie vor dem hinzufügen der submodule. Sie können sofort fügen Sie das Submodul wieder, das war nicht möglich mit den meisten der Antworten hier.

git submodule add $giturl test
aboveScript test

Dies lässt Sie mit einem sauberen checkout ohne änderungen zu Begehen.

Getestet wurde dies mit:

$ git --version
git version 1.9.3 (Apple Git-50)

InformationsquelleAutor udondan

Hier ist was ich getan habe :

1.) Löschen Sie den entsprechenden Abschnitt aus der .gitmodules-Datei. Sie können unten Befehl:

git config -f .gitmodules --remove-section "submodule.submodule_name"

2.) Bühne die .gitmodules änderungen

git add .gitmodules

3.) Löschen Sie den entsprechenden Abschnitt aus .git/config. Sie können unten Befehl:

git submodule deinit -f "submodule_name"

4.) Entfernen Sie die gitlink (no trailing slash):

git rm --cached path_to_submodule

5.) Bereinigung der .git/modules:

rm -rf .git/modules/path_to_submodule

6.) Commit:

git commit -m "Removed submodule <name>"

7.) Löschen Sie die jetzt nicht Submodul Dateien

rm -rf path_to_submodule

InformationsquelleAutor Ishan Liyanage

Musste ich nehmen John Douthat ist weicht einen Schritt weiter und cd in der Submodul-Verzeichnis, und entfernen Sie dann das Git-repository:

cd submodule
rm -fr .git

Dann konnte ich die Dateien wieder Einchecken als Teil des übergeordneten Git-repository, ohne den alten Bezug zu einem Submodul.

InformationsquelleAutor Kyle Clegg

project dir:     ~/foo_project/
submodule:       ~/foo_project/lib/asubmodule
- - - - - - - - - - - - - - - - - - - - - - - - -
run:
  1.   cd ~/foo_project
  2.   git rm lib/asubmodule && 
          rm .git/modules/lib/asubmodule && 
            git submodule lib/asubmodule deinit --recursive --force

InformationsquelleAutor

Wenn Sie haben soeben das Submodul, und zum Beispiel, Sie einfach Hinzugefügt, die falsche Submodul oder Sie fügte hinzu, es an der falschen Stelle, einfach git stash dann den Ordner löschen. Dies wird vorausgesetzt, dass das hinzufügen der submodule ist die einzige Sache, die Sie haben in der jüngsten repo.

InformationsquelleAutor botbot

Habe ich ein bash-Skript zu erleichtern, die Beseitigung Prozess. Es wird auch überprüft, ob es änderungen in der repo Links, nicht gespeicherte und um Bestätigung bittet.
Es wurde getestet auf os x wäre interessant zu wissen, ob es funktioniert, wie auf gängigen linux-Distributionen sowie:

https://gist.github.com/fabifrank/cdc7e67fd194333760b060835ac0172f

InformationsquelleAutor Techradar