Home / github / Teknologi / Teknologi Informasi

Panduan Penggunaan GitHub dengan Contoh Kode Lengkap

Posted by Angga Permana
Panduan Penggunaan GitHub dengan Contoh Kode Lengkap - hostze.net
Panduan Penggunaan GitHub dengan Contoh Kode Lengkap - hostze.net

Panduan Lengkap Penggunaan GitHub dengan Contoh Kode

Pendahuluan:

GitHub, platform hosting repositori Git terbesar, tidak hanya merupakan tempat menyimpan kode sumber, tetapi juga ruang kolaboratif bagi pengembang perangkat lunak. Artikel ini memberikan panduan mendetail dalam menggunakan GitHub, beserta contoh kode untuk membantu pembaca memahami konsep ini secara praktis.

Bagian 1: Pengenalan GitHub

    Sejarah singkat GitHub

    GitHub didirikan oleh pendirinya yaitu Tom Preston-Werner, Chris Wanstrath, dan PJ Hyett pada tahun 2008. Awalnya, tujuan mereka adalah menciptakan platform yang memfasilitasi kolaborasi dan berbagi kode antar pengembang perangkat lunak. Ide ini datang dari pengalaman pribadi mereka bekerja dengan proyek perangkat lunak sumber terbuka.

    Sejak itu, GitHub telah menjadi salah satu platform hosting Git terpopuler di dunia. Repositori Git digunakan untuk menyimpan dan melacak versi kode sumber proyek perangkat lunak. GitHub menyediakan antarmuka web yang ramah untuk menjelajahi repositori, melihat perubahan kode, dan berkolaborasi dengan tim pengembangan Anda.

    Beberapa momen terbesar dalam sejarah GitHub mencakup pertumbuhan pesat dalam jumlah pengguna dan repositori, perubahan kepemimpinan, dan peningkatan fitur. Pada tahun 2018, Microsoft mengakuisisi GitHub dengan jumlah besar, namun GitHub terus beroperasi secara independen sebagai platform hosting repositori.

    GitHub telah menjadi batu loncatan penting dalam dunia pengembangan perangkat lunak, khususnya untuk kolaborasi dan pengembangan perangkat lunak. Fitur seperti permintaan penarikan GitHub, masalah, proyek, dan tugas sangat bagus untuk proyek sumber terbuka dan pribadi di seluruh dunia.

    Peran GitHub dalam pengembangan perangkat lunak

  1. Kerja Tim:

    2. GitHub menyediakan platform bagi pengembang untuk berkolaborasi secara efektif sebagai sebuah tim. Fitur utama dari kolaborasi ini adalah permintaan tarik, yang memungkinkan pengembang mengirimkan perubahan kode untuk ditinjau dan digabungkan oleh tim. Sistem obrolan memungkinkan diskusi dan membantu pengembang berkomunikasi secara efektif.

  2. Manajemen Versi:

    3. Menggunakan Git sebagai sistem kontrol versi, GitHub memungkinkan pengembang melacak perubahan kode dengan mudah. Anda dapat membuat cabang untuk mengembangkan fitur dan memperbaiki bug tanpa mempengaruhi kode utama. Anda dapat menggabungkan perubahan ini ke dalam cabang master Anda.

  3. Proyek Sumber Terbuka:

    4. GitHub adalah rumah bagi ribuan proyek sumber terbuka. Pengembang dapat berkontribusi pada proyek ini dengan membuat permintaan tarik atau mengirimkan masalah untuk memberikan masukan dan melaporkan bug.

  4. Otomatisasi dengan GitHub Actions:

    5. GitHub Actions memungkinkan Anda mengotomatiskan berbagai tugas pengembangan, seperti pengujian otomatis, penerapan, dan banyak lagi. Ini membantu mengotomatiskan proses pengembangan dan memastikan kualitas kode.

  5. Pemantauan Proyek:

    6. Fitur seperti bagan proyek memungkinkan tim merencanakan dan mengelola aktivitas proyek. Anda dapat menggunakan umpan balik (benchmark) untuk menetapkan tujuan dan mengukur kemajuan proyek.

  6. Keamanan dan Integrasi Ekosistem:

    7. GitHub menawarkan fitur keamanan seperti autentikasi dua faktor, pemindaian aman tepercaya, dan integrasi dengan berbagai layanan ekosistem pengembangan perangkat lunak. Ini membantu menjaga keamanan proyek Anda dan meningkatkan integrasi dengan alat dan layanan lain. Dengan menyediakan platform yang kaya dan mudah digunakan, GitHub telah menjadi pusat kolaborasi dan inovasi dalam pengembangan perangkat lunak, memungkinkan komunitas pengembang berkolaborasi dalam menciptakan solusi perangkat lunak berkualitas tinggi.

Bagian 2: Membuat dan Mengelola Repositori (Kode: Git Command Line)

  1. Membuat repositori baru 
    git init
  2. Kloning repositori 
    git clone <URL repositori>
  3. Menambahkan file ke repositori 
    git add <nama_file>
  4. Melakukan commit perubahan 
    git commit -m "Pesan commit"
  5. Membuat dan mengelola cabang (branch) 
    git branch <nama_branch>
    
git checkout <nama_branch>

Bagian 3: Berkolaborasi dengan Tim (Kode: GitHub Collaboration Workflow)

  1. Menambahkan Kontributor ke Repositori
    1. Buka repositori To-Do List di GitHub.
    2. Pilih tab "Settings" di bagian atas.
    3. Pilih "Manage access" di sebelah kiri.
    4. Klik tombol "Invite a collaborator" dan masukkan nama pengguna GitHub kontributor yang ingin Anda undang.
    5. Kirim undangan.
  2. Menerapkan Pull Request
    1. Kontributor mengklon repositori ke komputernya.
      2. git clone https://github.com/namarepositori/to-do-list.git
    2. Membuat cabang untuk fitur yang akan diimplementasikan.
      3. git checkout -b fitur-tambah-kategori
    3. Membuat perubahan dan melakukan commit.
      4. git add .
      git commit -m "Menambahkan fitur untuk menambahkan kategori tugas"
    4. Mendorong perubahan ke repositori di GitHub.
      5. git push origin fitur-tambah-kategori
    5. Kontributor membuat pull request melalui antarmuka GitHub.
  3. Memberikan dan Menerima Review Kode
    1. Pemilik repositori atau kontributor lain melihat pull request di GitHub.
    2. Memberikan komentar, saran, atau persetujuan pada perubahan.
    3. Kontributor yang membuat pull request membuat perubahan berdasarkan umpan balik yang diberikan.
    4. Proses ini diulang sampai semua pihak puas dengan perubahan.
  4. Mengelola Isu (Issues) dan Permintaan Tarik (Pull Requests)
    1. Pemilik repositori atau kontributor membuat isu untuk menetapkan tugas atau melaporkan masalah.
    2. Kontributor membuat cabang dan perubahan yang memperbaiki isu tersebut.
    3. Mengacu pada isu tersebut dalam pull request.
    4. Setelah pull request di-review dan diterima, isu tersebut dapat ditutup.

Bagian 4: Pemantauan Proyek (Kode: GitHub Project Board)

  1. Membuat Papan Proyek (Project Board)
    1. Buka repositori To-Do List di GitHub.
    2. Pilih tab "Projects" di bagian atas.
    3. Klik tombol "New project" untuk membuat papan proyek baru.
    4. Beri nama proyek (misalnya, "Sprint 1 Board") dan pilih jenis papan proyek yang sesuai (misalnya, "Kanban").
    5. Klik "Create project" untuk membuat papan proyek.
  2. Menetapkan Isu dan Memantau Kemajuan
    1. Buka tab "Issues" di repositori To-Do List.
    2. Buat isu baru dengan mengklik tombol "New issue".
    3. Beri judul dan deskripsi isu, lalu klik "Submit new issue".
    4. Buka papan proyek yang baru dibuat ("Sprint 1 Board").
    5. Seret dan lepas isu ke dalam kolom yang sesuai pada papan proyek, misalnya, "To Do", "In Progress", dan "Done".
  3. Menggunakan Tanggapan (Milestones) untuk Mengatur Target
    1. Buka tab "Issues" di repositori To-Do List.
    2. Klik "Milestones" di sebelah kiri.
    3. Klik tombol "New milestone" untuk membuat tanggapan baru.
    4. Beri nama milestone (misalnya, "Sprint 1") dan atur tanggal tenggat waktu.
    5. Klik "Create milestone" untuk membuat tanggapan.
    6. Buka isu yang sudah dibuat sebelumnya.
    7. Tambahkan isu ke dalam milestone "Sprint 1" untuk menetapkan target untuk sprint tersebut.

    Contoh Kode Git untuk Menetapkan Isu ke Milestone

    # Membuat branch untuk fitur atau perbaikan yang akan diimplementasikan 
    git checkout -b fitur-tambah-kategori
    # Melakukan perubahan dan melakukan commit 
    git add .
    git commit -m "Menambahkan fitur untuk menambahkan kategori tugas"
    # Mendorong perubahan ke repositori di GitHub 
    git push origin fitur-tambah-kategori
    # Membuka pull request di antarmuka GitHub # Setelah pull request di-review dan diterima, kita dapat menetapkan isu ke milestone

    Contoh Kode untuk Menetapkan Isu ke Milestone melalui Antarmuka GitHub

    1. Buka isu yang telah dibuat di repositori To-Do List.
    2. Klik "Set milestone" dan pilih milestone yang sesuai (misalnya, "Sprint 1").

    Bagian 5: GitHub Actions (Kode: Workflow Configuration)

      Pengenalan ke GitHub Actions

      GitHub Actions adalah fitur otomatisasi di GitHub yang memungkinkan Anda membuat alur kerja (workflows) otomatis untuk proyek Anda. Alur kerja ini dapat digunakan untuk mengotomatiskan berbagai tugas seperti pengujian, penerapan, dan banyak lagi.

      Membuat Alur Kerja Otomatis

      Buat file dengan nama .github/workflows/nama-file.yml dalam repositori GitHub Anda. Contoh, build.yml:

      
name: Build and Test

on:
  push:
    branches:
      - main

jobs:
  build:
    runs-on: ubuntu-latest

    steps:
    - name: Checkout repository
      uses: actions/checkout@v2

    - name: Set up Node.js
      uses: actions/setup-node@v3
      with:
        node-version: '14'

    - name: Install dependencies
      run: npm install

    - name: Run tests
      run: npm test
    1. Mengonfigurasi Tugas-tugas dalam Alur Kerja

      2. Dalam contoh di atas, kita memiliki beberapa langkah (steps) yang dijalankan pada setiap push ke branch main. Langkah-langkah ini termasuk mengambil kode sumber, menyiapkan Node.js, menginstal dependensi, dan menjalankan pengujian. Anda dapat menyesuaikan langkah-langkah ini sesuai dengan kebutuhan proyek Anda.

    2. Menyematkan Status Tindakan di README

      3. Untuk menyematkan status tindakan di README, Anda dapat menambahkan tautan atau gambar Markdown yang menampilkan status alur kerja terbaru. Misalnya:

      
[![Build and Test](https://github.com/username/repo-name/actions/workflows/build.yml/badge.svg)](https://github.com/username/repo-name/actions/workflows/build.yml)

      Gantilah username/repo-name dengan nama pengguna GitHub dan nama repositori Anda. Dengan menambahkan tautan ini ke README, setiap kali ada push ke branch main, status tindakan terkini akan terlihat di README.

    Bagian 6: Keamanan dan Privasi (Kode: Repository Settings)

    1. Mengonfigurasi Akses Repositori
      1. Buka repositori di GitHub.
      2. Pilih tab "Settings" di bagian atas halaman repositori.
      3. Pilih opsi "Manage access" di menu sebelah kiri.
      4. Di bagian "Collaborators & teams," Anda dapat menambahkan kolaborator baru atau mengelola tim dengan mengundang anggota baru atau menyesuaikan hak akses.
    2. Menggunakan OAuth untuk Otentikasi
      1. Buka GitHub Developer Settings.
      2. Klik "New OAuth App" untuk membuat aplikasi baru.
      3. Isi informasi aplikasi, termasuk URL callback.
      4. Setelah aplikasi dibuat, Anda akan mendapatkan Client ID dan Client Secret.
      5. Gunakan informasi ini untuk mengonfigurasi otentikasi OAuth dalam aplikasi atau proyek Anda.
    3. Memanfaatkan Fitur Keamanan seperti Dependabot
      1. Buka repositori di GitHub.
      2. Pilih tab "Settings" di bagian atas halaman repositori.
      3. Pilih opsi "Security & analysis" di menu sebelah kiri.
      4. Aktifkan Dependabot Alerts dan Dependabot Security Updates.

      Contoh Notifikasi Dependabot di README:

              [![Dependabot Status](https://api.dependabot.com/badges/status?host=github&repo=username/repo-name)](https://dependabot.com)

      Gantilah username/repo-name dengan nama pengguna GitHub dan nama repositori Anda.

    Bagian 7: Menyimpan dan Berbagi Kode Sumber (Kode: Git Commands)

    1. Menggunakan Git Secara Lokal
      2. 
# Clone repositori ke mesin lokal
git clone https://github.com/username/repo-name.git

# Pindah ke direktori repositori
cd repo-name

# Membuat dan pindah ke branch baru
git checkout -b fitur-baru

# Membuat perubahan pada file
# ...

# Menambahkan perubahan untuk dicommit
git add .

# Melakukan commit dengan pesan
git commit -m "Menambahkan fitur baru"

# Mendorong branch ke repositori di GitHub
git push origin fitur-baru
    2. Mengelola Revisi Kode dengan git commit
      3. 
# Melihat riwayat commit
git log

# Melihat perubahan pada commit tertentu
git show <commit-hash>

# Mengganti pesan commit terakhir
git commit --amend -m "Pesan baru"
    3. Menggunakan .gitignore untuk Mengabaikan File atau Direktori
      4. 
# Buat file .gitignore di direktori repositori dan tambahkan pola-pola file atau direktori yang ingin diabaikan.
# Contoh .gitignore:

# File yang diabaikan
*.log
*.tmp

# Direktori yang diabaikan
node_modules/
build/
    4. Menerapkan Tag untuk Merilis Versi
      5. 
# Melihat daftar tag
git tag

# Membuat tag untuk versi baru
git tag -a v1.0.0 -m "Versi 1.0.0"

# Mendorong tag ke repositori di GitHub
git push origin v1.0.0

    Bagian 8: Penutup dan Sumber Daya

      Ringkasan

      Artikel ini membahas langkah-langkah penggunaan GitHub dan Git secara komprehensif. Berikut adalah ringkasan singkat dari topik-topik yang telah dibahas:

      • Pengenalan ke GitHub dan peran pentingnya dalam pengembangan perangkat lunak.
      • Membuat dan mengelola repositori menggunakan Git command line.
      • Berkolaborasi dengan tim melalui pull request, review kode, dan manajemen isu.
      • Pemantauan proyek menggunakan GitHub Project Board dan tanggapan (milestones).
      • Menggunakan GitHub Actions untuk otomatisasi alur kerja pengembangan.
      • Keamanan dan privasi repositori dengan konfigurasi akses, OAuth, dan Dependabot.
      • Menyimpan dan berbagi kode sumber dengan Git commands dan penerapan tag untuk merilis versi.

      Referensi

      Untuk sumber daya lebih lanjut tentang GitHub dan Git, Anda dapat mengunjungi situs web resmi dan dokumentasi berikut:

    Kesimpulan:

    Dengan memahami fitur dasar dan lanjutan GitHub, pengembang dapat mengoptimalkan pengalaman kolaborasi mereka dan meningkatkan efisiensi pengembangan perangkat lunak. Kami berharap artikel dan contoh kode ini membantu pembaca memahami dan menerapkan praktik terbaik di GitHub.

Angga Permana
Angga Permana Spesialis Web Desain dari tahun 2013 sebagai Front End specialist, Desain Grafis dan system/network technician.