Tutorial

Cara install dan konfigurasi Git untuk tim development

Git jadi alat wajib bagi tim development untuk mengelola perubahan kode secara rapi dan dapat dilacak. Berikut alur memasang Git, mengatur konfigurasi awal, hingga alur kerja dasar menyimpan dan mengirim perubahan kode ke repositori tim.

Tutorial: Cara Install dan Konfigurasi Git untuk Tim Development
Tutorial7 menit baca

Hampir semua masalah Git di tim baru muncul dari pemasangan yang setengah jadi: identitas commit kosong sehingga riwayat tidak bisa ditelusuri, kata sandi diminta setiap kali push, atau kode langsung didorong ke branch utama. Panduan ini adalah prosedur yang kami pakai saat menyiapkan laptop developer baru, dari instalasi sampai push pertama ke branch fitur. Contohnya memakai Ubuntu, dengan catatan untuk Windows dan macOS.

Yang akan Anda pelajari:

  • Memasang Git dan memastikan versinya.
  • Mengatur identitas dan pengaturan global yang konsisten untuk seluruh tim.
  • Membuat SSH key ed25519 dan mendaftarkannya ke GitHub atau GitLab.
  • Menguji koneksi, meng-clone repositori, dan bekerja di branch fitur.
  • Menyiapkan aturan tim: nama branch, pesan commit, dan .gitignore.

Prasyarat

  • Akses administrator di komputer (sudo di Linux, admin di Windows dan macOS).
  • Akun di platform repositori tim (GitHub, GitLab, atau Gitea internal) yang sudah diundang ke organisasi atau proyek.
  • Email kantor yang akan dipakai sebagai identitas commit. Sebaiknya sama dengan email akun platform agar commit tertaut ke profil.
  • Terminal: Terminal di Ubuntu dan macOS, atau Git Bash yang ikut terpasang bersama Git for Windows.

Langkah 1: Pasang Git dan periksa versinya

Di Ubuntu dan turunan Debian, Git tersedia di repositori resmi.

  1. Jalankan sudo apt update, lalu sudo apt install git -y.
  2. Pastikan terpasang dengan git --version. Versi 2.3x ke atas sudah memadai untuk semua perintah di panduan ini, termasuk git switch.

Di Windows, unduh installer dari git-scm.com. Pada layar pilihan, pertahankan opsi bawaan kecuali dua hal: pilih editor yang Anda kuasai (misalnya VS Code atau Notepad++) dan pilih Checkout Windows-style, commit Unix-style line endings. Di macOS, jalankan xcode-select --install atau brew install git bila memakai Homebrew.

Terminal Ubuntu yang menjalankan sudo apt install git lalu git --version dengan hasil git version 2.43.0
(1) Perintah instalasi, (2) pemeriksaan versi.

Gambar dalam artikel ini adalah mockup dengan data contoh, bukan tangkapan layar sistem milik klien.

Langkah 2: Atur identitas dan pengaturan global

Pengaturan global berlaku untuk semua repositori di komputer tersebut dan disimpan di file ~/.gitconfig.

  1. git config --global user.name "Nama Lengkap": nama yang tampil di riwayat commit. Pakai nama lengkap, bukan nama panggilan, agar mudah dikenali di tim besar.
  2. git config --global user.email "email@perusahaan.id": harus sama dengan email yang terdaftar di akun GitHub atau GitLab.
  3. git config --global init.defaultBranch main: repositori baru langsung memakai branch main, sesuai standar platform saat ini.
  4. Periksa semuanya dengan git config --global --list.

Pengaturan pull.rebase false membuat perilaku git pull seragam di seluruh tim dan menghilangkan peringatan yang sering membingungkan developer baru.

Terminal yang menjalankan git config global untuk user.name, user.email, init.defaultBranch, lalu menampilkan isi konfigurasi dan file gitconfig
(1) Nama, (2) email, (3) branch bawaan, (4) pemeriksaan hasil.

Langkah 3: Buat SSH key

SSH key menggantikan kata sandi saat berkomunikasi dengan server repositori. Kunci privat tetap di laptop Anda, kunci publik didaftarkan ke platform.

  1. Jalankan ssh-keygen -t ed25519 -C "email@perusahaan.id". Tekan Enter untuk lokasi bawaan.
  2. Isi passphrase. Passphrase melindungi kunci bila laptop hilang. Agar tidak diminta setiap kali push, tambahkan kunci ke ssh-agent dengan ssh-add.
  3. Tampilkan kunci publik dengan cat ~/.ssh/id_ed25519.pub, lalu salin seluruh barisnya. Jangan pernah membagikan file tanpa akhiran .pub.
Terminal yang menjalankan ssh-keygen ed25519 dengan passphrase, ssh-add ke ssh-agent, dan menampilkan kunci publik
(1) Pembuatan kunci, (2) passphrase, (3) kunci publik yang disalin.

Langkah 4: Daftarkan kunci publik ke platform

Di GitHub, buka Settings › SSH and GPG keys › New SSH key. Di GitLab, menunya ada di Preferences › SSH Keys.

  1. Title: beri nama perangkat, misalnya "Laptop kantor Rina (Ubuntu)". Saat laptop diganti atau hilang, Anda tahu kunci mana yang harus dihapus.
  2. Key: tempel kunci publik dari langkah 3, mulai dari ssh-ed25519 sampai alamat email.
  3. Klik Add SSH key. Platform mungkin meminta konfirmasi kata sandi atau kode 2FA.
Halaman Add new SSH Key dengan judul Laptop kantor Rina, isi kunci publik ssh-ed25519, dan tombol Add SSH key
Pendaftaran kunci. (1) Nama perangkat, (2) kunci publik, (3) simpan.

Langkah 5: Uji koneksi, clone, dan push pertama

Langkah terakhir memastikan seluruh rantai bekerja, sekaligus memperkenalkan alur kerja harian tim.

  1. Uji koneksi dengan ssh -T git@github.com. Pesan "successfully authenticated" berarti kunci sudah dikenali.
  2. Clone repositori dengan alamat SSH: git clone git@github.com:organisasi/repo.git.
  3. Buat branch untuk setiap pekerjaan: git switch -c fitur/nama-fitur. Jangan bekerja langsung di main.
  4. Setelah mengubah kode, periksa dengan git status, lalu git add dan git commit -m "pesan yang jelas".
  5. Kirim branch dengan git push -u origin fitur/nama-fitur, lalu buka pull request lewat tautan yang ditampilkan.
Terminal yang menguji koneksi SSH ke GitHub, meng-clone repositori erp-addons, membuat branch fitur, commit, dan push dengan tautan pull request
Alur pertama. (1) Uji SSH, (2) clone, (3) branch fitur, (4) commit, (5) push.

Aturan tim yang sebaiknya disepakati sejak hari pertama

Nama branch

AwalanDipakai untukContoh
fitur/Fitur atau modul barufitur/approval-cuti
perbaikan/Perbaikan bugperbaikan/pembulatan-ppn
hotfix/Perbaikan mendesak di produksihotfix/login-portal
rilis/Persiapan rilis versirilis/2026.11

Pesan commit

Tulis pesan dalam bentuk perintah yang menjelaskan apa yang berubah: "Tambah delegasi approver saat atasan cuti", bukan "update" atau "fix". Bila perlu penjelasan, tambahkan paragraf di bawah baris judul tentang alasannya. Riwayat seperti ini menghemat banyak waktu saat menelusuri kapan dan mengapa sebuah perilaku berubah.

File yang tidak boleh masuk repositori

Buat .gitignore di akar repositori sebelum commit pertama. Untuk proyek Python dan Odoo, isi minimalnya:

__pycache__/
*.pyc
.venv/
.env
*.log
filestore/
.vscode/
.idea/

File .env berisi kata sandi database dan kunci API. Sekali masuk riwayat Git, kata sandi itu harus dianggap bocor dan diganti, meskipun file dihapus di commit berikutnya.

Mengatasi masalah yang paling sering muncul

Pesan errorPenyebabSolusi
Permission denied (publickey)Kunci belum didaftarkan atau ssh-agent tidak memuat kunciJalankan ssh-add -l; bila kosong, jalankan ssh-add ~/.ssh/id_ed25519 dan pastikan kunci publik sudah terdaftar.
Please tell me who you areuser.name dan user.email belum diaturUlangi langkah 2.
rejected: non-fast-forwardBranch di server punya commit yang belum Anda tarikgit pull, selesaikan konflik bila ada, lalu push ulang.
Semua baris file terlihat berubahPerbedaan akhir baris Windows (CRLF) dan Linux (LF)Atur core.autocrlf sesuai sistem operasi dan tambahkan file .gitattributes di repositori.

Tips dan kesalahan umum

  • Satu SSH key per perangkat, bukan satu kunci yang disalin ke banyak laptop. Bila satu laptop hilang, cukup hapus kunci perangkat itu.
  • Jalankan git pull di branch utama sebelum membuat branch baru agar mulai dari kode terbaru.
  • Commit kecil dan sering lebih mudah ditinjau dan dibatalkan daripada satu commit besar di akhir minggu.
  • Lindungi branch main di pengaturan platform: wajib lewat pull request dan minimal satu peninjau.
  • Jalankan test otomatis sebelum push. Dasarnya dibahas di artikel pentingnya unit testing.

Ringkasan

Menyiapkan Git dengan benar hanya butuh lima langkah: memasang Git, mengatur identitas dan pengaturan global, membuat SSH key, mendaftarkannya ke platform, lalu menguji alur clone, branch, commit, dan push. Ditambah aturan tim tentang nama branch, pesan commit, dan .gitignore, setiap developer baru bisa berkontribusi dengan rapi sejak hari pertama.

Langkah selanjutnya: hubungkan repositori dengan test otomatis dan deployment agar setiap push diperiksa sebelum sampai ke server. Prosesnya kami jelaskan di layanan infrastruktur dan DevOps Odoo dan layanan QA testing. Bila Anda menyiapkan server Odoo sendiri, lanjutkan ke cara install Odoo di Ubuntu Server.

Pertanyaan yang sering diajukan

Apa beda Git dan GitHub?

Git adalah perangkat lunak pengelola versi yang berjalan di komputer Anda. GitHub, GitLab, dan Gitea adalah layanan yang menyimpan repositori Git di server dan menambahkan fitur kolaborasi seperti pull request dan review.

Lebih baik SSH atau HTTPS?

Keduanya aman. SSH lebih praktis untuk developer karena tidak perlu memasukkan token setiap kali push. HTTPS dengan personal access token cocok untuk jaringan yang memblokir port SSH.

Apakah passphrase SSH key wajib?

Tidak wajib, tetapi sangat disarankan. Tanpa passphrase, siapa pun yang mendapatkan file kunci privat Anda bisa mengakses repositori. ssh-agent membuat passphrase cukup diketik sekali per sesi.

Bagaimana jika email commit salah?

Perbaiki dengan git config untuk commit berikutnya. Commit lama yang belum di-push bisa diperbaiki dengan git commit --amend --reset-author. Commit yang sudah di-push sebaiknya dibiarkan agar tidak mengubah riwayat bersama.

Belum ada penilaian
Seberapa membantu artikel ini?

Butuh bantuan menata alur kerja development tim Anda?

Kami bantu setup repositori, branching strategy, dan proses deployment yang rapi untuk tim development Anda.

WhatsApp