Git Submodules

Просунуте Git

Amanda Crawford-Adamo

Software and Data Engineer

Що таке підмодуль Git?

Підмодуль Git

git submodule

Схематичне зображення репозиторію з кількома репозиторіями всередині.

Додавання підмодуля за посиланням або каталогом у вказаний шлях.

git submodule add <repository link|dir> <path>

Приклад

Додає бібліотеку перевірки даних до проєкту ETL у теку libs/validator в репозиторії ETL.

git submodule add https://github.com/example/data-validator.git libs/validator

Список усіх підмодулів у проєкті

git submodule status

Приклад

$ git submodule status
e1f2...7w8x9 data_cleaning_lib
a1b2...q7r8 api_connector
d9e8...t3u2 visualization_toolkit

Оновлення підмодуля до останніх змін

Є кілька варіантів:

Оновлює всі підмодулі, вихідний код яких на вашому локальному комп'ютері.
```
git submodule update --init 
```
Оновлює всі підмодулі, вихідний код яких у віддаленому репозиторії.
```
git submodule update --init --remote 
```
Оновлює конкретний підмодуль
```
git submodule update --init <path_to_submodule>
```

Процес видалення підмодуля

Скопіюйте всі файли, які мають бути в новому репозиторії підмодуля, в іншу теку поза репозиторієм.
У новій теці створіть новий репозиторій для підмодуля:
```
git init <new-submodule>
```
Використайте git filter-repo, щоб виділити потрібні файли та історію з основного проєкту:
```
git filter-repo --path <extract_path> --invert-paths
```
Додайте виділений репозиторій як підмодуль до основного проєкту:
```
git submodule add <new-submodule_path> <path_to_store_submodule>
```

Коли корисно:

Найкращі практики:

Просунуте Git