Gunakan git clone --recurse-submodules supaya folder submodule langsung terisi. Clone biasa dari GitHub hanya mengunduh repository utama plus pointer commit submodule, bukan isi file di dalamnya. Itu sebabnya folder submodule sering terlihat kosong.
Clone Langsung Terisi dengan Satu Command
Git menyimpan submodule sebagai repository Git terpisah yang ditautkan ke repository utama. GitHub hanya menampung kedua repository tersebut, proses pengisiannya tetap dilakukan Git di komputer kamu.
- Salin URL HTTPS atau SSH repository utama dari GitHub.
- Jalankan clone dengan flag recurse:
git clone --recurse-submodules https://github.com/OWNER/NAMA-REPO.git - Masuk ke folder hasil clone, lalu verifikasi:
git submodule status
- Baris diawali spasi berarti submodule sudah terisi dan sesuai commit.
- Baris diawali
-berarti folder submodule masih kosong. - Baris diawali
+berarti commit lokal berbeda dari catatan repository utama.
Perintah Wajib Saat Submodule Sudah Terlanjur Kosong
Kalau repository sudah terlanjur di-clone tanpa flag, tidak perlu clone ulang. Jalankan inisialisasi dari dalam repository utama:
git submodule update --init --recursive
- Gunakan
--initsaja bila submodule hanya satu level dan belum pernah diisi. - Tambahkan
--recursivebila submodule di dalamnya masih memuat submodule lain. - Jalankan perintah dari root repository utama, bukan dari dalam folder submodule.
Tabel Perintah Submodule dan Fungsinya
| Command | Fungsi | Catatan |
|---|---|---|
git clone URL |
Mengunduh repository utama | Isi submodule belum ikut |
git clone --recurse-submodules URL |
Clone utama plus isi submodule | Sesuaikan URL HTTPS atau SSH dengan akses kamu |
git submodule update --init --recursive |
Mengisi submodule yang kosong | Mengikuti commit yang dicatat repository utama |
Untuk repository privat, pastikan autentikasi HTTPS atau SSH sudah valid sebelum clone. Origin tetap menunjuk ke repository utama hasil clone, bukan otomatis ke setiap submodule.
Kendala Umum Setelah Clone Submodule
- Folder tetap kosong karena clone awal tanpa
--recurse-submodulesdan belum menjalankan update. - Akses ditolak ke submodule privat karena akun belum punya izin atau kredensial belum terpasang.
- Submodule berada pada detached HEAD karena ia mengikuti commit tertentu, bukan branch aktif.
- Perubahan di dalam submodule perlu commit dan push dari repository submodule itu sendiri.
Hindari reset --hard dan force push untuk memperbaiki submodule kosong. Keduanya menulis ulang history dan bisa menghapus pekerjaan orang lain di branch yang sama.
FAQ
Apakah submodule ikut otomatis saat clone biasa?
Tidak. Clone biasa hanya membawa pointer commit, isi submodule baru terunduh setelah perintah update atau flag recurse.
Bagaimana update isi submodule ke versi terbaru?
Masuk ke folder submodule, pull branch yang diinginkan, lalu commit perubahan pointer tersebut di repository utama.
Apa yang dilakukan jika akses submodule ditolak?
Periksa izin akun ke repository submodule dan perbaiki autentikasi HTTPS atau SSH yang dipakai untuk URL tersebut.