GitHub & GitLab Fundamentals

GitHub dan GitLab sama-sama platform kolaborasi di atas Git. Keduanya menyediakan repository, review, CI/CD, registry, dan manajemen akses, dengan istilah dan penekanan yang sedikit berbeda.

Perbandingan konsepCopy Anchor Link

RepositoryCopy Anchor Link

Struktur repository yang sehat:

repo/
├─ .github/workflows/      # GitHub Actions
├─ .gitlab-ci.yml          # GitLab CI
├─ src/
├─ tests/
├─ Dockerfile
├─ .dockerignore
├─ .gitignore
└─ README.md

Branch utamaCopy Anchor Link

• main — branch produksi, dilindungi.
• develop — opsional untuk Git Flow.
• feature/*, fix/*, hotfix/* — branch kerja.
• release/* — opsional untuk rilis terjadwal.

Issue dan perencanaanCopy Anchor Link

Issue mendokumentasikan bug, fitur, dan tugas. Kebiasaan baik:

• Judul jelas dan spesifik.
• Deskripsi berisi konteks, langkah reproduksi, dan ekspektasi.
• Label: bug, enhancement, documentation, priority:high.
• Assignee dan milestone.
• Tautkan issue ke PR/MR (Closes #42).

Contoh template issue bug:

## Deskripsi
Endpoint /health mengembalikan 500 setelah deploy.

## Langkah reproduksi
1. Deploy versi 1.4.0
2. curl https://app.example.com/health
3. Amati status 500

## Ekspektasi
Status 200 dengan body {"status":"ok"}

Branch protectionCopy Anchor Link

Lindungi branch utama agar tidak bisa diubah sembarangan.

GitHubCopy Anchor Link

Settings → Branches → Add branch protection rule:

• Require a pull request before merging.
• Require approvals (mis. 1–2).
• Require status checks to pass.
• Require conversation resolution.
• Restrict who can push.
• Require linear history (opsional).

GitLabCopy Anchor Link

Settings → Repository → Protected branches:

• Allowed to merge: Maintainers.
• Allowed to push: No one.
• Require approval.

Branch protection adalah kontrol penting, bukan formalitas. Tanpa ini, semua otomasi dan review bisa dilewati.

Code ownersCopy Anchor Link

GitHub CODEOWNERSCopy Anchor Link

*                     @org/backend-team
/src/api/             @org/api-team
/infra/               @org/platform-team

GitLab CODEOWNERSCopy Anchor Link

GitLab mendukung code owners di tier tertentu. Pastikan tim yang tepat otomatis diminta review untuk area kritis.

Release dan tagCopy Anchor Link

GitHub ReleasesCopy Anchor Link

1. Buka Releases → Draft a new release.
2. Pilih tag (v1.4.0).
3. Isi changelog.
4. Lampirkan artifact bila perlu.
5. Publikasikan.

GitLab ReleasesCopy Anchor Link

release:
  stage: deploy
  script:
    - echo "Membuat release"
  release:
    tag_name: v1.4.0
    description: "Rilis 1.4.0"

RegistryCopy Anchor Link

GitHub Container Registry (GHCR)Copy Anchor Link

echo "$GITHUB_TOKEN" | docker login ghcr.io -u USERNAME --password-stdin
docker tag myapp:1.0.0 ghcr.io/USERNAME/myapp:1.0.0
docker push ghcr.io/USERNAME/myapp:1.0.0

GitLab Container RegistryCopy Anchor Link

echo "$CI_JOB_TOKEN" | docker login registry.gitlab.com -u USERNAME --password-stdin
docker tag myapp:1.0.0 registry.gitlab.com/GROUP/PROJECT:1.0.0
docker push registry.gitlab.com/GROUP/PROJECT:1.0.0

Hak aksesCopy Anchor Link

Gunakan least privilege dan autentikasi dua faktor.

Webhook dan integrasiCopy Anchor Link

Webhook memungkinkan platform memberi tahu sistem lain saat ada push, PR, atau release.

Contoh payload push dapat memicu:

• Deployment otomatis.
• Notifikasi Slack/Telegram.
• Sinkronisasi mirror repository.
• Scan keamanan.

Praktik: menyiapkan repository produksiCopy Anchor Link

1. Buat repository dan README.
2. Tambahkan .gitignore, .dockerignore, dan template PR/MR.
3. Lindungi main dengan review dan status check.
4. Tambahkan CODEOWNERS.
5. Aktifkan secret scanning dan dependency alerts.
6. Siapkan environment staging dan production.
7. Simpan konfigurasi CI di repository.
8. Dokumentasikan alur rilis di README.

RingkasanCopy Anchor Link

• GitHub dan GitLab menyediakan repository, issue, review, CI/CD, dan registry.
• Branch protection dan code owners menjaga kualitas branch utama.
• Release/tag membuat versi dapat dilacak.
• Registry menyimpan image container untuk deployment.