Cara Menggunakan GitHub di Ubuntu: Panduan Lengkap dari Pemula hingga Mahir dengan Git, SSH, dan VS Code

目次

1. Pengenalan

Mengapa Menghubungkan Ubuntu dengan GitHub?

Dalam beberapa tahun terakhir, penggunaan Git dan GitHub telah menjadi praktik standar dalam pengembangan perangkat lunak dan operasi sistem. Bagi insinyur dan programmer yang bekerja di lingkungan Linux seperti Ubuntu, integrasi dengan GitHub merupakan bagian dari alur kerja sehari-hari.

Git adalah alat untuk mengelola riwayat versi kode sumber dan sangat penting untuk kolaborasi efisien di antara beberapa pengembang. GitHub, di sisi lain, adalah layanan hosting yang memungkinkan repositori yang dikelola Git untuk dibagikan dan dipublikasikan secara online, berfungsi sebagai pusat global bagi pengembang untuk bertukar kode.

Mengapa Menggunakan GitHub di Ubuntu?

Ubuntu adalah distribusi Linux yang sangat populer di kalangan pengembang dan dikenal karena kompatibilitasnya yang sangat baik dengan pengembangan open-source. Ia menyediakan lingkungan di mana Git dan alat pengembangan lainnya dapat diinstal dengan mudah, membuat integrasi GitHub menjadi lancar dan efisien.

Kasus penggunaan umum untuk menggabungkan Ubuntu dan GitHub meliputi:

  • Mengelola dan berbagi kode sumber Python, C++, dan lainnya di GitHub
  • Berkontribusi pada proyek open-source
  • Mempublikasikan karya Anda sebagai portofolio

Apa yang Akan Anda Pelajari dalam Artikel Ini

Panduan ini menjelaskan semuanya mulai dari penggunaan GitHub dasar hingga lanjutan di Ubuntu melalui langkah-langkah berikut:

  • Cara menginstal Git di Ubuntu
  • Konfigurasi Git awal dan pengaturan SSH
  • Membuat dan mengelola repositori GitHub
  • Pengembangan efisien menggunakan Visual Studio Code
  • Tips pemecahan masalah umum dan FAQ

Bahkan pengguna GitHub pemula dapat mengikuti dengan aman, dengan contoh perintah nyata dan catatan penting yang disertakan. Jika Anda ingin memanfaatkan GitHub di Ubuntu sebaik mungkin, baca hingga akhir.

2. Menginstal Git di Ubuntu

Apa Itu Git? Penyegaran Singkat

Git adalah Sistem Kontrol Versi (VCS) yang digunakan dalam pengembangan perangkat lunak untuk mengelola riwayat perubahan kode sumber. Ia memungkinkan pengembang untuk mengembalikan keadaan sebelumnya dan berkolaborasi secara bersamaan.

Salah satu keuntungan utama lingkungan Linux seperti Ubuntu adalah seberapa mudah Git dapat diinstal. Menggunakan metode di bawah ini, instalasi dapat diselesaikan dalam hitungan menit melalui terminal.

Menginstal Git melalui APT

Cara paling umum untuk menginstal Git di Ubuntu adalah dengan menggunakan APT (Advanced Package Tool). Ikuti langkah-langkah ini:

1. Perbarui Daftar Paket

sudo apt update

Perintah ini mengambil informasi paket terbaru. Selalu jalankan sebelum menginstal perangkat lunak baru.

2. Instal Git

sudo apt install git

Ketika diminta dengan “Y/n”, ketik y dan tekan Enter untuk memulai instalasi.

Memverifikasi Instalasi Git

Setelah instalasi, konfirmasi bahwa Git terinstal dengan benar:

git --version

Jika Anda melihat output seperti berikut, Git terinstal dengan sukses:

git version 2.34.1

Nomor versi mungkin bervariasi tergantung pada rilis Ubuntu Anda, tetapi output versi apa pun mengonfirmasi keberhasilan.

Menginstal melalui Snap (Opsional)

Meskipun Git juga dapat diinstal menggunakan perintah snap, APT umumnya lebih stabil dan banyak digunakan. Kecuali Anda memiliki alasan khusus, APT direkomendasikan.

3. Konfigurasi Git Awal

Pengaturan Esensial Sebelum Menggunakan Git

Setelah Git terinstal, langkah selanjutnya adalah mengonfigurasi informasi pengguna dan autentikasi. Konfigurasi yang tepat memastikan interaksi yang lancar dengan repositori jarak jauh dan alur kerja tim.

Mengatur Nama Pengguna dan Email Git

Git mencatat siapa yang membuat setiap commit. Oleh karena itu, Anda harus mengonfigurasi nama pengguna dan alamat email.

Perintah Konfigurasi

git config --global user.name "Your Name"
git config --global user.email "you@example.com"

Nilai-nilai ini tidak perlu cocok persis dengan akun GitHub Anda, tetapi menggunakan email yang sama dengan GitHub membantu mengaitkan commit dengan benar.

Memverifikasi Konfigurasi

git config --list

Perintah ini menampilkan konfigurasi Git saat ini Anda.

Menghasilkan dan Mendaftarkan Kunci SSH

Meskipun HTTPS didukung, autentikasi SSH menghilangkan perintah kata sandi yang berulang dan menyediakan alur kerja yang lebih aman dan efisien.

1. Menghasilkan Kunci SSH

ssh-keygen -t ed25519 -C "you@example.com"

Tekan Enter beberapa kali untuk menghasilkan kunci pribadi (~/.ssh/id_ed25519) dan kunci publik (~/.ssh/id_ed25519.pub).

2. Mulai Agen SSH dan Tambahkan Kunci

eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519

Kunci SSH sekarang siap digunakan.

3. Tambahkan Kunci Publik ke GitHub

Salin kunci publik:

cat ~/.ssh/id_ed25519.pub

Kemudian daftarkan di GitHub:

  1. Masuk ke GitHub
  2. Klik gambar profil Anda → Pengaturan
  3. Pilih “Kunci SSH dan GPG”
  4. Klik “Kunci SSH Baru”, tempel kunci, dan simpan

4. Uji Koneksi SSH

ssh -T git@github.com

Ketik yes saat diminta untuk mempercayai host.

Jika berhasil, Anda akan melihat:

Hi your-username! You've successfully authenticated, but GitHub does not provide shell access.

Langkah Selanjutnya yang Direkomendasikan

Dengan pengaturan ini selesai, Anda sekarang dapat kloning, push, dan pull repositori GitHub. Bagian selanjutnya menjelaskan cara membuat dan mengoperasikan repositori GitHub secara praktis.

4. Bekerja dengan Repositori GitHub

Membuat Repositori Baru di GitHub

Setelah masuk ke GitHub, mulailah dengan membuat repositori baru.

Langkah-langkah (melalui Peramban Web)

  1. Klik tombol “+” di sudut kanan atas halaman utama GitHub dan pilih “Repositori baru”.
  2. Masukkan informasi berikut:
  • Nama repositori : Contoh: my-first-repo
  • Deskripsi (opsional) : Penjelasan singkat
  • Publik / Pribadi : Pilih visibilitas repositori
  1. Klik “Buat repositori”.

Setelah dibuat, URL repositori akan ditampilkan. Anda akan menggunakan URL ini untuk kloning dan mengelola repositori.

Mengkloning Repositori GitHub yang Ada

Untuk menyalin repositori ke lingkungan Ubuntu lokal Anda, gunakan perintah git clone.

git clone git@github.com:your-username/my-first-repo.git

Contoh ini menggunakan SSH. Jika Anda menggunakan HTTPS, URL akan berbeda.

Setelah dieksekusi, direktori bernama my-first-repo akan dibuat yang berisi file repositori.

Alur Kerja Perubahan File, Staging, dan Commit

1. Tambahkan atau Edit File

Misalnya, buat file baru:

echo "# My First GitHub Project" > README.md

2. Stage Perubahan

git add README.md

Staging memilih perubahan mana yang akan disertakan dalam commit berikutnya.

3. Commit Perubahan

git commit -m "Initial commit: add README.md"

Perubahan Anda sekarang disimpan dalam riwayat repositori lokal.

Mendorong Perubahan ke GitHub

Untuk mencerminkan perubahan lokal pada repositori GitHub remote, gunakan git push.

git push origin main

Jika cabang default Anda bukan main (misalnya, master), sesuaikan nama cabang dengan demikian.

Menarik Perubahan Remote ke Lokal

Jika pengembang lain telah membuat perubahan, gunakan perintah berikut untuk memperbarui repositori lokal Anda:

git pull origin main

Ini menggabungkan perubahan remote ke cabang lokal Anda.

Operasi Tambahan Umum

  • Periksa repositori remote:
    git remote -v
    
  • Tambahkan repositori GitHub lain nanti:
    git remote add origin git@github.com:your-username/another-repo.git
    
  • Mengedit README.md atau .gitignore mengikuti alur kerja yang sama.

5. Integrasi dengan Visual Studio Code

Mengapa VS Code Ideal untuk Operasi Git

Saat menggunakan GitHub di Ubuntu, menggabungkannya dengan Visual Studio Code (VS Code) secara signifikan meningkatkan produktivitas. VS Code adalah editor open-source yang dikembangkan oleh Microsoft dan dikenal karena integrasi Git yang sangat baik. Ini memungkinkan commit, push, dan review diff melalui GUI, membuatnya ramah pemula.

Menginstal VS Code di Ubuntu

Anda dapat dengan mudah menginstal VS Code di Ubuntu menggunakan langkah-langkah berikut.

1. Tambahkan Repositori Microsoft

sudo apt update
sudo apt install wget gpg
wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > packages.microsoft.gpg
sudo install -o root -g root -m 644 packages.microsoft.gpg /usr/share/keyrings/

2. Daftarkan Repository

sudo sh -c 'echo "deb [arch=amd64 signed-by=/usr/share/keyrings/packages.microsoft.gpg] https://packages.microsoft.com/repos/vscode stable main" > /etc/apt/sources.list.d/vscode.list'

3. Instal VS Code

sudo apt update
sudo apt install code

Setelah instalasi, Anda dapat meluncurkan VS Code dengan mengetik code di terminal.

Dukungan Git Bawaan

VS Code menyertakan integrasi Git secara default, jadi tidak diperlukan plugin tambahan untuk operasi Git dasar. Untuk penggunaan lanjutan, ekstensi berikut direkomendasikan:

  • GitHub Pull Requests and Issues Memungkinkan penanganan Pull Request dan Issue berbasis GUI.
  • GitLens Memvisualisasikan riwayat baris demi baris, menunjukkan siapa yang mengubah apa dan kapan.

Operasi Git Dasar di VS Code

Membuka Repository

Arahkan ke repository yang sudah Anda kloning dan jalankan:

code .

Meninjau Perubahan dan Melakukan Commit

  • Klik ikon Source Control di sidebar kiri
  • Lihat daftar file yang dimodifikasi
  • Pilih file untuk melihat perbedaan
  • Masukkan pesan commit dan klik ikon ✓

Operasi Push dan Pull

  • Pilih “Push” atau “Pull” dari menu “…”
  • Atau gunakan status bar di kanan bawah

Menggunakan Terminal Terintegrasi

Terminal bawaan (Ctrl + `) memungkinkan perpindahan mulus antara alur kerja GUI dan CLI. Misalnya, Anda dapat melakukan commit melalui GUI dan mengelola cabang melalui terminal.

Tips Pemecahan Masalah

  • Jika terjadi error SSH, pastikan VS Code merujuk ke kunci SSH yang benar
  • Anda mungkin perlu mengkonfigurasi ulang autentikasi atau menggunakan GitHub Personal Access Token (PAT)

6. Pemecahan Masalah Umum

Error SSH: “Permission denied (publickey).”

Penyebab yang Mungkin

  • Kunci SSH tidak dibuat dengan benar
  • Kunci publik tidak terdaftar di GitHub
  • Agen SSH tidak memuat kunci

Solusi

  1. Periksa apakah ada kunci SSH yang sudah ada:
    ls ~/.ssh/id_ed25519.pub
    

Jika tidak ada, buat satu:

ssh-keygen -t ed25519 -C "your_email@example.com"
  1. Mulai agen SSH dan tambahkan kunci:
    eval "$(ssh-agent -s)"
    ssh-add ~/.ssh/id_ed25519
    
  1. Tambahkan kunci publik ke GitHub:
    cat ~/.ssh/id_ed25519.pub
    

Tambahkan di bawah “SSH and GPG keys” di GitHub.

  1. Uji koneksi:
    ssh -T git@github.com
    

Error Autentikasi dengan HTTPS

Penyebab

  • Autentikasi password telah dihentikan; autentikasi berbasis token diperlukan

Solusi

  1. Buat Personal Access Token di GitHub https://github.com/settings/tokens Centang ruang lingkup repo saat membuat token
  2. Gunakan nama pengguna GitHub Anda dan string token sebagai password
  3. Aktifkan caching kredensial jika diinginkan:
    git config --global credential.helper cache
    

Error: “fatal: not a git repository”

Penyebab

  • Direktori saat ini bukan repository Git

Solusi

  • Pindah ke direktori repository yang sudah ada:
    cd ~/your-project-directory
    
  • Atau inisialisasi repository baru:
    git init
    

Menangani Konflik Merge

Penyebab

  • Konflik terjadi ketika beberapa pengguna mengedit bagian yang sama dari sebuah file secara bersamaan

Solusi

  1. Buka file yang konflik setelah error git pull
  2. Cari penanda konflik:
    <<<<<<< HEAD
    Your changes
    =======
    Other changes
    >>>>>>> origin/main
    
  1. Edit konten, hapus penanda, dan simpan
  2. Lalu jalankan:
    git add .
    git commit
    

Error: “remote: Repository not found.”

Penyebab

  • URL repository tidak tepat
  • Tidak memiliki izin akses ke repository

Solusi

  • Periksa URL remote:
    git remote -v
    
  • Reset URL jika diperlukan:
    git remote set-url origin git@github.com:your-username/your-repo.git
    

Masalah-masalah ini sering terjadi pada pemula. Namun, dengan penyebab dan solusi yang jelas, masalah tersebut dapat diselesaikan dengan tenang. Anggap kesalahan sebagai peluang belajar dan secara bertahap bangun kepercayaan diri.

7. FAQ

Q1. Apa Perbedaan Antara Git dan GitHub?

A:
Git adalah alat pengendalian versi yang mengelola riwayat perubahan secara lokal. GitHub adalah layanan cloud yang menghosting repositori Git dan memungkinkan berbagi serta kolaborasi.

  • Git: Pengelolaan riwayat lokal dan offline
  • GitHub: Penghosting repositori online dan kolaborasi

Q2. Haruskah Saya Menggunakan SSH atau HTTPS?

A:
SSH direkomendasikan karena:

  • Tidak perlu memasukkan kata sandi berulang kali
  • Lebih aman dan nyaman dalam jangka panjang

Namun, HTTPS mungkin diperlukan di lingkungan perusahaan atau jaringan tertentu.

Q3. Bagaimana Cara Menggunakan Beberapa Akun GitHub di Ubuntu?

A:
Buat kunci SSH terpisah untuk setiap akun dan konfigurasikan secara eksplisit.

  1. Buat kunci SSH terpisah Contoh: ~/.ssh/id_ed25519_work , ~/.ssh/id_ed25519_personal
  2. Edit ~/.ssh/config :
    Host github.com-work
        HostName github.com
        User git
        IdentityFile ~/.ssh/id_ed25519_work
    
    Host github.com-personal
        HostName github.com
        User git
        IdentityFile ~/.ssh/id_ed25519_personal
    
  1. Perbarui URL remote:
    git remote set-url origin git@github.com-work:your-work-user/your-repo.git
    

Q4. Bisakah Saya Menggunakan Git dengan GUI?

A:
Ya. Visual Studio Code menyediakan operasi Git berbasis GUI, termasuk commit, push, diff, dan pengelolaan branch. Sangat direkomendasikan untuk pemula.

Q5. Apa yang Terjadi Jika Saya Menghapus Repositori Remote?

A:
Menghapus repositori remote tidak memengaruhi repositori lokal. Namun, git push akan gagal.

Anda dapat terhubung kembali ke remote baru sebagai berikut:

git remote set-url origin git@github.com:new-user/new-repo.git

Q6. Apakah Mungkin Menghindari Terminal Sepenuhnya?

A:
Ya. Klien Git GUI memungkinkan alur kerja tanpa terminal:

  • GitKraken
  • Sourcetree (tidak didukung secara resmi di Linux)
  • Visual Studio Code (dukungan Git bawaan)

Untuk pengguna Ubuntu, kombinasi VS Code + GitLens adalah yang paling praktis dan ramah pengguna.

Q7. Seberapa Jauh ke Belakang Riwayat Git Dapat Dilacak?

A:
Git menyimpan seluruh riwayat sejak commit pertama. Anda dapat melihatnya menggunakan:

git log

Untuk melihat riwayat file tertentu:

git log path/to/file