Cara set upstream branch GitHub paling cepat adalah git push -u origin nama-branch dari branch lokal yang aktif. Git lalu menautkan branch lokal tersebut ke branch remote sehingga git pull dan git push berikutnya berjalan tanpa menyebut remote dan branch lagi.
Git menyimpan commit di komputer, GitHub menyimpan salinannya di server sebagai remote bernama origin. Upstream adalah tautan tracking antara keduanya, bukan remote cadangan.
Perintah Inti untuk Set Upstream Branch
Untuk branch baru yang belum ada di GitHub, jalankan dari dalam branch tersebut:
git push -u origin fitur-login
Flag -u sama dengan --set-upstream. Untuk branch lama yang sudah ada di kedua sisi, tautkan manual:
git branch --set-upstream-to=origin/fitur-login
Jalankan perintah kedua saat posisi HEAD sudah berada di branch lokal yang ingin ditautkan.
Cek Status Tracking Branch yang Aktif
git branch -vv
git status -sb
Kedua perintah menampilkan relasi tracking secara berbeda. -vv cocok untuk melihat semua branch, -sb cocok untuk cek cepat branch aktif.
[ahead 2]: lokal lebih baru 2 commit dari remote.[behind 1]: remote lebih baru, perlugit pull.[gone]: branch remote sudah dihapus, tracking menunjuk ke tempat kosong.- Tidak ada tanda kurung atau ada tulisan no upstream: branch belum ditautkan.
Tabel Pilihan Command Upstream
| Command | Fungsi | Catatan |
|---|---|---|
git push -u origin nama-branch |
Unggah plus pasang tracking | Pakai untuk branch baru |
git branch --set-upstream-to=origin/nama-branch |
Tautkan tanpa push | Branch remote harus sudah ada |
git branch --unset-upstream |
Lepas tracking aktif | Data lokal dan remote tetap aman |
Hati-hati setelah rename branch. Tracking lama masih menunjuk ke nama remote lama sehingga push berikutnya bisa membuat branch duplikat.
Perbaiki Error No Upstream Branch
Pesan fatal: The current branch has no upstream branch configured muncul karena Git tidak tahu ke mana harus mengirim commit.
- Baca saran yang ditampilkan Git di bawah pesan error.
- Jika branch remote belum ada, jalankan
git push -u origin nama-branch. - Jika branch remote sudah ada, jalankan
git branch --set-upstream-to=origin/nama-branch, lalugit pull. - Untuk hasil fork, pastikan
originmenunjuk ke fork milikmu, bukan ke repositori asal.
Pada workflow fork, origin adalah fork kamu. Nama upstream biasanya dipakai untuk repositori asal dan jangan tertukar dengan tracking upstream branch.
FAQ
Kapan perlu set upstream ulang setelah rename branch?
Setiap rename lokal dengan git branch -m memutus tracking lama, jadi push ulang dengan -u memakai nama baru.
Apakah upstream bisa diganti ke branch remote lain?
Bisa, jalankan --set-upstream-to ke nama remote dan branch tujuan yang sudah ada.
Kenapa git pull tetap gagal setelah set upstream?
Umumnya history bercabang atau branch remote sudah dihapus, cek lewat git fetch dan git status -sb dulu.