Cara clone repository besar GitHub dengan cepat adalah membatasi history dan file yang diunduh sejak awal. Git menyimpan semua versi file, GitHub hanya meng-host repository itu. Pakai shallow clone untuk mengambil commit terakhir saja:
git clone --depth 1 https://github.com/OWNER/NAMA-REPO.git
Untuk repo dengan banyak file besar, tambah filter agar blob menyusul saat dibutuhkan. History penuh hanya perlu untuk audit, bisect lama, atau arsip offline.
Pakai Shallow dan Filter agar Clone Repository Besar Tidak Berat
Clone biasa menarik semua commit, tree, dan blob. Pada repo besar, ini yang membuat proses lama dan gagal di tengah jalan.
- Clone dangkal untuk kebutuhan kerja harian:
git clone --depth 1 https://github.com/OWNER/NAMA-REPO.git - Clone blobless untuk kode lengkap tanpa isi file lama:
git clone --filter=blob:none https://github.com/OWNER/NAMA-REPO.git - Masuk ke folder, cek branch dan remote:
cd NAMA-REPO git branch -a git remote -v - Ambil file Git LFS bila repo memakainya:
git lfs pull
- Gunakan –depth 1 bila hanya perlu kode terbaru untuk build atau baca kode.
- Gunakan –filter=blob:none bila perlu history commit tetapi tidak perlu semua versi file.
- Ambil history penuh belakangan hanya bila benar-benar perlu.
Pilihan Command untuk Repository Besar GitHub
Setiap opsi memangkas bagian berbeda. Pilih sesuai hambatan utama: history panjang, file banyak, atau branch besar.
git clone --depth 1 --branch main https://github.com/OWNER/NAMA-REPO.git
git clone --filter=tree:0 https://github.com/OWNER/NAMA-REPO.git
git clone --depth 1 --filter=blob:none --sparse https://github.com/OWNER/NAMA-REPO.git
- Clone branch tertentu memakai –branch main agar branch lain tidak ikut diunduh.
- Sparse-checkout cocok untuk monorepo karena hanya checkout folder yang dikerjakan.
- Treeless lebih agresif dari blobless, cocok untuk browsing cepat lalu ambil file menyusul.
| Command | Fungsi | Catatan |
|---|---|---|
| –depth 1 | Ambil 1 commit terakhir | Paling cepat untuk build |
| –filter=blob:none | Tunda isi file lama | History tetap ada |
| –filter=tree:0 | Tunda tree dan blob | Perlu fetch menyusul |
Atasi Clone Besar yang Putus atau Lambat
Clone besar biasanya putus karena koneksi tidak stabil, memori habis saat kompresi, file raksasa, atau objek LFS belum terambil. Ulangi dengan beban lebih kecil, bukan dengan command yang sama.
git fetch --depth 1
git fetch --unshallow
git lfs pull
- RPC failed atau connection reset: ulangi clone dengan –depth 1, hindari WiFi publik.
- Early EOF atau unpack gagal: tutup aplikasi berat, clone branch tertentu dulu.
- Smudge error LFS: jalankan git lfs pull setelah clone selesai.
- Repo terasa kosong setelah treeless: ambil file dengan git checkout atau git sparse-checkout set.
FAQ
Apakah shallow clone bisa jadi history penuh?
Ya. Jalankan git fetch –unshallow dari dalam repo untuk melengkapi history.
Kapan perlu Git LFS saat clone besar?
Perlu bila repo menyimpan file biner besar seperti dataset, video, atau arsip yang dilacak LFS.
Apakah sparse-checkout mengurangi ukuran download?
Ya, karena Git hanya checkout folder yang dipilih meski metadata lain mungkin tetap diambil.