Overview
Git membantu developer melacak perubahan, bekerja secara paralel, melakukan code review, dan memulihkan versi sebelumnya. Tanpa workflow yang jelas, tim rentan mengalami konflik kode, commit berisi file yang tidak seharusnya, atau credential yang tidak sengaja dipublikasikan.
Artikel ini membahas inisialisasi repository, koneksi ke GitHub, branch fitur, commit, pull request, serta penanganan secret. Tujuannya adalah membuat workflow yang aman dan mudah diulang untuk proyek Laravel.
Prerequisites
- Git terpasang.
- Akun GitHub dan repository tujuan.
- Proyek Laravel.
- SSH key atau HTTPS authentication yang dikonfigurasi dengan aman.
- Pemahaman dasar terminal dan konsep branch.
Periksa Git:
git --version
Step-by-step tutorial
1. Periksa .gitignore
Proyek Laravel biasanya sudah memiliki .gitignore. Pastikan file environment dan artefak lokal sensitif tidak dilacak. Hal yang umumnya tidak dikomit antara lain .env, vendor/, node_modules/, file log/cache lokal, serta upload runtime yang memang dihasilkan oleh aplikasi. Strategi file build bergantung pada workflow deployment.
2. Inisialisasi repository
git init
git status
git add .
git status
git commit -m "chore: initial Laravel application"
Baca git status sebelum commit dan pastikan tidak ada secret. Jika .env sudah pernah dilacak, menambahkannya ke .gitignore saja tidak menghapusnya dari history.
3. Hubungkan ke GitHub
Buat repository kosong di GitHub, lalu gunakan URL yang disediakan GitHub:
git remote add origin https://github.com/USERNAME/NAMA-REPO.git
git branch -M main
git push -u origin main
Ganti placeholder dengan repository milik sendiri. Jangan menempelkan access token ke URL remote atau menyimpannya dalam file proyek. Gunakan mekanisme autentikasi yang direkomendasikan GitHub.
4. Buat branch fitur
git switch -c feature/product-management
Kerjakan perubahan kecil dan commit dengan pesan jelas:
git add app routes tests
git commit -m "feat: add product management routes"
Sesuaikan path yang di-stage. Hindari git add . tanpa meninjau status pada proyek yang berisi file sensitif atau artefak besar.
5. Sinkronkan branch dan tangani konflik
Contoh workflow merge sederhana:
git switch main
git pull
git switch feature/product-management
git merge main
Tim juga dapat menggunakan rebase jika disepakati. Jangan rebase branch bersama yang sudah digunakan developer lain tanpa koordinasi.
Jika konflik muncul, baca setiap file yang berkonflik, bandingkan perubahan, hapus marker konflik setelah menyelesaikannya, lalu jalankan test. Stage file yang sudah selesai dan lanjutkan operasi merge atau rebase sesuai status Git.
6. Buat Pull Request
git push -u origin feature/product-management
Buat Pull Request di GitHub dan jelaskan tujuan perubahan, cara menguji, risiko, screenshot bila relevan, serta catatan migration. Minta review sebelum menggabungkan perubahan ke branch utama. Jalankan test otomatis pada CI jika workflow tersedia.
7. Tangani secret yang telanjur ter-commit
Jika credential masuk ke repository, anggap credential tersebut terekspos. Cabut atau rotasi credential sesegera mungkin, periksa log akses, dan ikuti prosedur penghapusan dari history bila diperlukan. Menghapus file dari commit terbaru tidak menghapus secret dari history lama.
Troubleshooting
Permission denied (publickey): periksa SSH key dan akun GitHub yang aktif.- Push ditolak karena remote lebih baru: fetch/pull lalu integrasikan perubahan sesuai workflow tim.
.envtetap muncul: file mungkin telah dilacak; hentikan tracking dengan prosedur aman dan rotasi credential jika pernah dipublikasikan.- Merge conflict: selesaikan manual, jalankan test, kemudian lanjutkan operasi Git.
- Folder dependency sangat besar: periksa
.gitignoredan apakah folder generated sudah terlanjur dilacak. - Commit salah: pilih metode koreksi berdasarkan apakah commit sudah dipush dan apakah branch dipakai bersama.
Best practices
Gunakan branch fitur, commit kecil, pesan commit deskriptif, Pull Request, dan code review. Jangan commit secret, dump database, atau data pelanggan. Lindungi branch utama, jalankan test sebelum merge, dan dokumentasikan setup proyek di README. Jangan mengubah history branch bersama tanpa koordinasi.
Related articles
Last tested
Tanggal penyusunan: 19 Oktober 2026. Command Git merupakan workflow umum dan belum dijalankan pada repository pengguna. Sesuaikan nama branch, URL remote, dan kebijakan merge dengan tim.