Folder submodule kosong setelah clone biasanya berarti repo utama berhasil diunduh, tapi isi submodule belum diinisialisasi. Jalankan perintah init dan update ulang, lalu periksa akses ke repository submodule tersebut.
git submodule update --init --recursive
Penyebab Clone Submodule Gagal di GitHub
Git menangani repo utama dan submodule sebagai dua repository berbeda. Clone utama bisa sukses sementara submodule tetap gagal.
- URL di .gitmodules tidak bisa diakses, repository sudah dihapus, dipindah, atau berubah jadi private.
- Akun kamu punya akses ke repo utama, tapi tidak punya akses ke repository submodule.
- Autentikasi tidak konsisten. Repo utama di-clone pakai SSH, sedangkan submodule memakai HTTPS, atau sebaliknya.
- Submodule menunjuk commit tertentu yang sudah dihapus atau history-nya ditulis ulang.
Tabel Troubleshooting Clone Submodule Gagal
Baca pesan error di terminal sebagai petunjuk awal. Bedakan origin milik repo utama dengan URL submodule yang tercatat di .gitmodules.
| Masalah | Penyebab | Solusi |
|---|---|---|
| Folder kosong | Belum init | Jalankan update init recursive |
| Authentication failed | Credential beda | Samakan SSH atau HTTPS |
| Repository not found | Akses kurang | Minta akses submodule |
Cara Memperbaiki Clone Submodule yang Gagal
- Periksa konfigurasi submodule dan pastikan URL masih benar.
cat .gitmodules git submodule status - Pastikan kamu bisa membuka repository submodule di GitHub dengan akun yang sama.
- Inisialisasi ulang semua submodule yang kosong.
git submodule update --init --recursive - Untuk clone baru, unduh repo utama beserta submodulenya sekaligus.
git clone --recurse-submodules <URL-REPO-UTAMA> - Kalau remote berubah dari HTTPS ke SSH atau sebaliknya, perbarui URL submodule.
git submodule set-url <path-submodule> <URL-baru> git submodule sync git submodule update --init --recursive
FAQ
Kenapa folder submodule kosong setelah clone?
Karena git clone biasa hanya mengunduh repo utama tanpa mengisi isi submodule.
Apakah submodule perlu akses terpisah dari repo utama?
Ya, Git meminta izin terpisah untuk setiap repository submodule, terutama yang private.
Kapan memakai clone ulang –recurse-submodules?
Pakai saat kamu butuh salinan baru yang langsung menyertakan semua isi submodule.