Belajar GitLab CI/CD - Pre-Requisites Skill & Setup Environment

#Pendahuluan

Selamat datang di series Belajar GitLab CI/CD! GitLab CI/CD adalah sistem CI/CD yang menyatu langsung di dalam platform GitLab — dari repository, issue tracking, sampai pipeline yang berjalan otomatis di setiap push. Menguasainya adalah salah satu jalur tercepat menuju peran DevOps Engineer, Cloud Engineer, hingga Release Engineer. Namun sebelum menulis .gitlab-ci.yml pertama, ada tiga fondasi yang harus kalian pegang erat: dasar Git & GitLab workflow, format YAML, dan dasar shell scripting. Tanpa ketiganya, kalian akan tersesat di episode-episode berikutnya — karena sebuah pipeline pada akhirnya hanyalah file YAML yang memicu perintah shell di dalam repository Git.

Episode 0 ini adalah lapisan fondasi. Kita akan mengulik tiga skill tersebut, lalu menyiapkan environment kerja yang lengkap: akun GitLab.com (atau self-hosted GitLab), GitLab CLI (glab) yang sudah terautentikasi, dan VS Code dengan ekstensi GitLab Workflow untuk auto-complete, linter, dan pipeline status. Di akhir episode, kalian akan memiliki mesin yang siap menulis dan menjalankan pipeline GitLab CI/CD pertama.

#Pembahasan Utama

#Skill Dasar 1: Git & GitLab Workflow

Pipeline GitLab CI/CD otomatis dipicu oleh event yang terjadi di repository — mulai dari commit yang di-push ke branch, merge request yang dibuka, hingga tag yang dirilis. Karena itu, memahami Git dan GitLab bukan lagi pilihan, melainkan prasyarat mutlak.

git init
git add .
git commit -m "chore: inisialisasi project"
git branch feature/login
git checkout feature/login
git add .
git commit -m "feat: halaman login"
git push origin feature/login

Mental model yang paling penting: commit adalah checkpoint yang bisa dikembalikan kapan saja, dan branch adalah cara mengembangkan fitur tanpa merusak jalur utama. Di GitLab, mekanisme kolaborasinya disebut Merge Request (MR) — padanan dari Pull Request di GitHub. MR adalah jantung kolaborasi di GitLab, dan nanti banyak pipeline akan dirancang khusus agar berjalan setiap kali sebuah MR dibuka atau di-update. Jika kalian belum nyaman dengan git add, git commit, dan git push, sempatkan membaca series learn-git di blog ini terlebih dahulu.

#Skill Dasar 2: Format YAML

GitLab CI/CD mendeskripsikan seluruh pipeline sebagai file YAML (YAML Ain't Markup Language) yang diletakkan di root repository. Semua sintaks — mulai dari stages, jobs, sampai script — ditulis dalam YAML. Tiga konsep dasarnya:

• Key-value: pasangan nama dan nilai, ditulis nama: nilai.
• List: deretan item yang diindentasi dengan - di depan item.
• Nesting: hierarki dibuat semata-mata dari indentasi — ini yang paling sering menimbulkan error.

name: my-app
version: 1.0.0
stack:
  - web
  - api
config:
  debug: true
  port: 8080
  jobs:
    - name: build
      run: npm ci

Perhatikan bahwa hierarki ditentukan oleh jumlah spasi di depan baris, bukan tanda kurung atau semicolon. Pahami pola ini baik-baik, karena seluruh pipeline nantinya bergantung pada kedalaman indentasi yang benar.

#Skill Dasar 3: Dasar Shell Scripting

Setiap job di GitLab CI/CD pada akhirnya mengeksekusi perintah di dalam shell — defaultnya bash. Sebuah job dianggap gagal jika perintah yang dijalankan mengembalikan exit code selain 0, dan pipeline berhenti. Contoh pola paling dasar:

#!/bin/bash
set -e
APP_DIR="./src"
echo "Memeriksa direktori $APP_DIR"
if [ -d "$APP_DIR" ]; then
  echo "Direktori ditemukan"
else
  echo "Direktori tidak ada" >&2
  exit 1
fi

Tiga hal yang wajib kalian pahami dari contoh di atas: variabel (nilai di-assign tanpa $, dipakai dengan $), percabangan dengan if untuk kontrol alur, dan exit code sebagai bahasa sukses-gagalnya sebuah perintah. Series learn-bash-scripting di blog ini adalah pendamping yang sangat direkomendasikan.

#Setup 1: Akun GitLab

Langkah pertama yang sepele tapi sering dilupakan: pastikan kalian punya akun GitLab. Ada dua pilihan utama:

• GitLab.com (SaaS) — layanan resmi yang dikelola GitLab. Paling cepat untuk belajar karena gratis dan menyediakan shared runners yang siap menjalankan pipeline tanpa setup server apapun.
• Self-hosted GitLab — install instance GitLab sendiri (edisi CE gratis atau EE berbayar) di server kalian. Populer di perusahaan yang butuh kontrol penuh atas data dan infrastructure.

Cukup daftar di gitlab.com, verifikasi email, lalu buat project baru dari tombol New project. Project inilah rumah repository kalian sekaligus tempat pipeline akan dieksekusi.

#Setup 2: Instalasi GitLab CLI (glab)

glab adalah command-line tool resmi dari GitLab yang memungkinkan kalian mengelola project, merge request, issue, hingga pipeline langsung dari terminal tanpa membuka browser.

brew install glab
sudo apt install glab
winget install glab.glab
glab version

Perintah di atas masing-masing untuk macOS (Homebrew), Ubuntu/Debian (paket di universe), dan Windows (winget). Setelah terpasang, langkah berikutnya adalah autentikasi:

glab auth login
glab auth status

Perintah glab auth login menampilkan serangkaian pertanyaan interaktif: pilih host (GitLab.com atau instance self-managed), pilih metode autentikasi (browser OAuth paling nyaman, atau Personal Access Token), lalu ikuti alurnya. Token disimpan di ~/.config/glab-cli/config.yml. Verifikasi hasilnya:

$ glab version
glab version 1.63.0 (2026-06-12)
 
$ glab auth status
gitlab.com
  ✓ Logged in to gitlab.com as arman-dp
  ✓ Auth method: oauth
  ✓ Git operations for gitlab.com configured to use https

Jika keluar tanda ✓ Logged in, environment CLI kalian sudah terhubung ke GitLab. Perintah glab yang akan sering kalian pakai:

#Setup 3: VS Code dengan Ekstensi GitLab Workflow

Untuk menulis .gitlab-ci.yml dengan nyaman, pasang Visual Studio Code dan ekstensi GitLab Workflow (resmi dari GitLab). Ekstensi ini memberikan:

• Syntax highlighting khusus untuk .gitlab-ci.yml.
• Auto-complete untuk keyword seperti stages, script, dan rules.
• Linter yang memvalidasi sintaks pipeline secara real-time — error indentasi terlihat sebelum file di-push.
• Pipeline status yang tampil langsung di editor untuk branch yang sedang diproses.

Cara memasangnya: buka VS Code, tekan Ctrl+Shift+X untuk membuka panel Extensions, cari "GitLab Workflow", klik Install, lalu autentikasi dari command palette (Cmd+Shift+P → GitLab: Authenticate). Setiap file bernama .gitlab-ci.yml di root project akan otomatis terdeteksi dan terlint.

#Kesalahan Umum Setup

1. Belum login glab. Perintah apapun seperti glab repo list akan menampilkan pesan untuk menjalankan glab auth login terlebih dahulu. Solusinya jalankan glab auth login.
2. File YAML memakai tab. Parser YAML akan menolak file tersebut. Atur VS Code agar menyisipkan spasi (bukan tab) saat menekan tombol Tab.
3. Project tidak punya CI/CD aktif. Pipeline hanya berjalan jika file .gitlab-ci.yml ada di root repository. Pastikan juga pengaturan CI/CD di project tidak dimatikan.

#Penutup

Pada episode 0 ini kalian telah menyiapkan fondasi lengkap untuk belajar GitLab CI/CD:

• Tiga skill prasyarat: dasar Git & GitLab workflow (commit, branch, Merge Request), format YAML (key-value, list, nesting), dan dasar bash (set -e, variabel, exit code).
• Akun GitLab.com atau self-hosted GitLab sebagai rumah repository dan pipeline.
• GitLab CLI (glab) yang sudah terautentikasi, lengkap dengan glab version dan glab auth status.
• VS Code dengan ekstensi GitLab Workflow untuk auto-complete, linter, dan pipeline status.

Environment kalian sekarang siap. Di episode 1 kita akan berhenti sejenak dari mengetik untuk memahami sejarah, konsep, dan arsitektur utama GitLab CI/CD — mengapa platform all-in-one ini mendominasi enterprise, bagaimana GitLab Server, Runner, dan .gitlab-ci.yml bekerja sama, serta perbandingan jujur dengan GitHub Actions dan Jenkins. Sampai jumpa di episode 1!