Статус кво
Давайте предположим , что у нас есть хранилище под названием , repo-old
который содержит вспомогательный каталог sub
, который мы хотели бы преобразовать в суб модуль со своим собственным репоrepo-sub
.
Кроме того, предполагается, что исходное репо repo-old
должно быть преобразовано в модифицированное репо, repo-new
где все коммиты, касающиеся ранее существовавшего подкаталога sub
, теперь будут указывать на соответствующие коммиты нашего извлеченного репо подмодуля repo-sub
.
Давай меняться
Этого можно добиться с помощью git filter-branch
двухэтапного процесса:
- Извлечение подкаталога из
repo-old
в repo-sub
(уже упоминалось в принятом ответе )
- Замена подкаталога с
repo-old
на repo-new
(с правильным сопоставлением фиксации)
Замечание : я знаю, что этот вопрос старый, и уже упоминалось, что git filter-branch
он устарел и может быть опасен. Но, с другой стороны, это может помочь другим с личными репозиториями, которые легко проверить после преобразования. Так что будьте осторожны ! И, пожалуйста, дайте мне знать, есть ли другой инструмент, который делает то же самое, но не является устаревшим и безопасен в использовании!
Я объясню, как я реализовал оба шага в linux с git версии 2.26.2 ниже. Старые версии могут работать в некоторой степени, но это необходимо протестировать.
Для простоты я ограничусь случаем, когда в исходном репо есть только master
ветка и origin
пульт repo-old
. Также имейте в виду, что я полагаюсь на временные теги git с префиксом, temp_
которые будут удалены в процессе. Итак, если уже есть теги с одинаковыми именами, вы можете изменить префикс ниже. И, наконец, имейте в виду, что я тщательно не тестировал это, и могут быть крайние случаи, когда рецепт не работает. Поэтому, пожалуйста, сделайте резервную копию всего, прежде чем продолжить !
Следующие ниже фрагменты bash можно объединить в один большой скрипт, который затем должен быть выполнен в той же папке, где находится репо repo-org
. Не рекомендуется копировать и вставлять все прямо в командное окно (хотя я успешно это протестировал)!
0. Подготовка
переменные
# Root directory where repo-org lives
# and a temporary location for git filter-branch
root="$PWD"
temp='/dev/shm/tmp'
# The old repository and the subdirectory we'd like to extract
repo_old="$root/repo-old"
repo_old_directory='sub'
# The new submodule repository, its url
# and a hash map folder which will be populated
# and later used in the filter script below
repo_sub="$root/repo-sub"
repo_sub_url='https://github.com/somewhere/repo-sub.git'
repo_sub_hashmap="$root/repo-sub.map"
# The new modified repository, its url
# and a filter script which is created as heredoc below
repo_new="$root/repo-new"
repo_new_url='https://github.com/somewhere/repo-new.git'
repo_new_filter="$root/repo-new.sh"
Скрипт фильтра
# The index filter script which converts our subdirectory into a submodule
cat << EOF > "$repo_new_filter"
#!/bin/bash
# Submodule hash map function
sub ()
{
local old_commit=\$(git rev-list -1 \$1 -- '$repo_old_directory')
if [ ! -z "\$old_commit" ]
then
echo \$(cat "$repo_sub_hashmap/\$old_commit")
fi
}
# Submodule config
SUB_COMMIT=\$(sub \$GIT_COMMIT)
SUB_DIR='$repo_old_directory'
SUB_URL='$repo_sub_url'
# Submodule replacement
if [ ! -z "\$SUB_COMMIT" ]
then
touch '.gitmodules'
git config --file='.gitmodules' "submodule.\$SUB_DIR.path" "\$SUB_DIR"
git config --file='.gitmodules' "submodule.\$SUB_DIR.url" "\$SUB_URL"
git config --file='.gitmodules' "submodule.\$SUB_DIR.branch" 'master'
git add '.gitmodules'
git rm --cached -qrf "\$SUB_DIR"
git update-index --add --cacheinfo 160000 \$SUB_COMMIT "\$SUB_DIR"
fi
EOF
chmod +x "$repo_new_filter"
1. Извлечение подкаталога
cd "$root"
# Create a new clone for our new submodule repo
git clone "$repo_old" "$repo_sub"
# Enter the new submodule repo
cd "$repo_sub"
# Remove the old origin remote
git remote remove origin
# Loop over all commits and create temporary tags
for commit in $(git rev-list --all)
do
git tag "temp_$commit" $commit
done
# Extract the subdirectory and slice commits
mkdir -p "$temp"
git filter-branch --subdirectory-filter "$repo_old_directory" \
--tag-name-filter 'cat' \
--prune-empty --force -d "$temp" -- --all
# Populate hash map folder from our previously created tag names
mkdir -p "$repo_sub_hashmap"
for tag in $(git tag | grep "^temp_")
do
old_commit=${tag#'temp_'}
sub_commit=$(git rev-list -1 $tag)
echo $sub_commit > "$repo_sub_hashmap/$old_commit"
done
git tag | grep "^temp_" | xargs -d '\n' git tag -d 2>&1 > /dev/null
# Add the new url for this repository (and e.g. push)
git remote add origin "$repo_sub_url"
# git push -u origin master
2. Замена подкаталога
cd "$root"
# Create a clone for our modified repo
git clone "$repo_old" "$repo_new"
# Enter the new modified repo
cd "$repo_new"
# Remove the old origin remote
git remote remove origin
# Replace the subdirectory and map all sliced submodule commits using
# the filter script from above
mkdir -p "$temp"
git filter-branch --index-filter "$repo_new_filter" \
--tag-name-filter 'cat' --force -d "$temp" -- --all
# Add the new url for this repository (and e.g. push)
git remote add origin "$repo_new_url"
# git push -u origin master
# Cleanup (commented for safety reasons)
# rm -rf "$repo_sub_hashmap"
# rm -f "$repo_new_filter"
Примечание: если вновь созданное репо repo-new
зависает во время, git submodule update --init
попробуйте вместо этого рекурсивно повторно клонировать репозиторий:
cd "$root"
# Clone the new modified repo recursively
git clone --recursive "$repo_new" "$repo_new-tmp"
# Now use the newly cloned one
mv "$repo_new" "$repo_new-bak"
mv "$repo_new-tmp" "$repo_new"
# Cleanup (commented for safety reasons)
# rm -rf "$repo_new-bak"