Статус кво
Давайте припустимо , що у нас є сховище під назвою , 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"