Cara Shallow Clone Repository GitHub agar Unduhan Lebih Ringan

Pakai git clone --depth 1 URL_REPOSITORY kalau mau unduh repository GitHub tanpa seluruh riwayat commit. Git memangkas history lokal jadi satu commit terakhir, GitHub sebagai hosting tetap menyimpan history lengkap di server. Hasilnya folder lebih kecil dan proses clone jauh lebih cepat, cocok untuk repo besar yang hanya perlu dipakai atau dibangun.

Perintah Shallow Clone yang Paling Sering Dipakai

Shallow clone membuat file .git hanya berisi sebagian history. Isi file kerja tetap lengkap pada commit yang diambil.

git clone --depth 1 https://github.com/OWNER/NAMA-REPO.git
cd NAMA-REPO
git log --oneline -5
  1. Jalankan perintah clone dengan --depth 1 dan URL HTTPS atau SSH repository.
  2. Masuk ke folder hasil clone dengan cd lalu pastikan file project sudah lengkap.
  3. Cek riwayat pendek dengan git log --oneline untuk memastikan hanya satu commit yang terunduh.
  • Gunakan URL HTTPS bila login memakai token atau credential manager.
  • Gunakan URL SSH bila komputer sudah menyimpan kunci SSH untuk GitHub.
  • Ganti OWNER dan NAMA-REPO sesuai repository tujuan.

Opsi Depth, Branch, dan Single-Branch untuk Repo Besar

Untuk repo besar, batasi juga branch yang diunduh agar transfer data tidak membengkak.

  • --depth 1 mengambil satu commit terakhir.
  • --depth 10 atau 50 mengambil riwayat secukupnya untuk melihat perubahan terbaru.
  • --branch NAMA-BRANCH --single-branch hanya mengambil satu branch tertentu.
  • --no-single-branch mengambil semua branch walau history tetap dangkal.
Command Fungsi Catatan
--depth 1 Ambil commit terakhir Paling ringan untuk build
--branch main --single-branch Ambil satu branch Hemat untuk repo banyak branch
--depth 50 Ambil 50 commit terakhir Perlu konteks history pendek
git clone --depth 1 --branch main --single-branch https://github.com/OWNER/NAMA-REPO.git

Pendalaman History dan Batasan Shallow Clone

History shallow bisa dilengkapi lagi tanpa clone ulang dari awal.

git fetch --depth 50
git fetch --unshallow
  • git fetch --depth 50 menambah history sampai 50 commit terakhir.
  • git fetch --unshallow mengubah shallow clone menjadi full clone.
  • Tag lama dan commit di luar depth mungkin belum tersedia sebelum pendalaman history.
  • Kolaborasi yang butuh arkeologi commit, blame lama, atau rebase panjang lebih aman memakai full clone.

Jangan jalankan git reset --hard atau force push sebelum paham dampaknya. Reset hard membuang perubahan lokal yang belum di-commit, force push menulis ulang history di remote dan bisa menghapus kerja orang lain.

FAQ

Apakah shallow clone bisa jadi full clone lagi?

Ya, jalankan git fetch --unshallow dari branch yang terhubung ke remote origin.

Kapan shallow clone tidak cocok dipakai?

Tidak cocok bila perlu menelusuri seluruh history, memakai tag lama, atau melakukan rebase dan audit commit secara rutin.