Belajar Jenkins - Menulis Jenkins Pipeline Pertama (Jenkinsfile - Declarative vs Scripted)

#Pendahuluan

Di episode 1 kita menutup dengan kesimpulan: kode lebih baik daripada klik. Episode 2 adalah saatnya membuktikan kalimat itu. Kita akan menulis Jenkins Pipeline pertama dalam bentuk file Jenkinsfile — dan di sinilah kalian merasakan perbedaan filosofis dengan Freestyle Project yang dibahas sebelumnya. Semua alur build, mulai dari checkout sampai notifikasi, akan hidup di dalam Git repository sebagai kode yang bisa di-review, diuji, dan di-versioning.

Konsep ini bernama Pipeline as Code, dan ia adalah fondasi dari hampir semua hal yang akan kalian bangun di series ini. Pada episode kali ini kita akan membahas konsepnya, membandingkan dua sintaks — Declarative dan Scripted — lalu membedah anatomi blok Declarative dan menulis pipeline Hello World yang dijalankan langsung dari repository lewat SCM checkout.

#Pembahasan Utama

#Konsep Pipeline as Code

Ide utamanya sederhana: definisi pipeline bukan lagi konfigurasi yang tersimpan di database Jenkins, melainkan sebuah file bernama Jenkinsfile yang diletakkan di root direktori repository kalian, bersama kode aplikasi.

Mengapa ini perubahan besar? Karena pipeline menjadi bagian dari codebase:

• Audit trail. Setiap perubahan pada alur build tercatat di riwayat commit, lengkap dengan penulisnya.
• Peer review. Perubahan pipeline bisa di-review lewat pull request seperti perubahan kode biasa — tidak ada lagi orang mengubah konfigurasi diam-diam lewat UI.
• Reproducible. Repository baru cukup diclone dan Jenkinsfile-nya langsung bisa dijalankan; tidak perlu menyalin konfigurasi dari UI satu jenkins ke jenkins lain.

Dengan satu repository, kalian bahkan bisa memakai Jenkinsfile yang sama untuk diuji di jenkins testing dan dijalankan di jenkins produksi — konfigurasi tidak mungkin "lupa disinkronkan".

#Declarative vs Scripted Pipeline

Jenkins menyediakan dua sintaks untuk menulis pipeline:

Declarative Pipeline adalah sintaks modern yang diperkenalkan tahun 2017. Ia terstruktur, berbasis blok yang sudah ditentukan, dan sangat mudah dibaca. Strukturnya selalu dimulai dengan kata kunci pipeline dan menggunakan blok seperti stages dan steps.

Scripted Pipeline adalah sintaks asli berbasis Groovy murni. Ia imperatif — ditulis seperti program biasa dengan node { ... }, stage yang dipanggil sebagai method, dan kebebasan penuh untuk menulis loop, exception handling, dan logika programatik apapun.

#Anatomi Declarative Pipeline

Pipeline Declarative tersusun dari blok-blok yang selalu dimulai dengan kata kunci pipeline. Empat blok wajib yang menjadi kerangka dasar:

Struktur dasarnya seperti kotak yang bersarang: di dalam pipeline ada agent, lalu stages yang berisi daftar stage, dan setiap stage berisi steps. Kalian bisa membacanya seperti outline: "Pipeline ini jalan di mana saja, dengan fase-fase berikut, dan di fase ini kita melakukan hal ini."

#Hello World: Jenkinsfile Pertama

Mari kita tulis pipeline paling sederhana. Buat file bernama Jenkinsfile di repository kalian:

Jenkinsfile: Hello World

pipeline {
    agent any
    stages {
        stage('Hello') {
            steps {
                echo 'Hello dari Jenkins Pipeline!'
            }
        }
    }
}

Bedah satu per satu:

• agent any berarti pipeline boleh dijalankan di executor manapun yang tersedia. Di episode 3 kita akan menggantinya dengan label spesifik (agent dengan label docker-runner) agar pekerjaan terarah ke agent yang tepat.
• stages mendefinisikan fase-fase. Di sini hanya ada satu stage('Hello').
• steps berisi langkah eksekusi — dalam hal ini echo yang mencetak pesan ke log build.

Saat pipeline ini berjalan, Jenkins akan menampilkan satu stage bernama Hello di UI, dan di bawahnya log berisi pesan yang kita cetak. Ini mungkin terlihat remeh, tapi kerangka inilah yang akan menampung ratusan langkah di pipeline produksi kalian nanti.

#Menjalankan via SCM Checkout

Jenkinsfile tidak dijalankan dengan menyalin isinya ke UI — ia diambil langsung dari repository. Cara yang benar:

1. Buat repository Git baru (misal di GitHub atau GitLab), commit Jenkinsfile, lalu git push.
2. Di Jenkins, pilih New Item, beri nama misal hello-world, dan pilih tipe Pipeline.
3. Pada bagian Pipeline, pilih opsi Pipeline script from SCM.
4. Isi SCM dengan Git, isi Repository URL dengan URL repo kalian, dan biarkan Branch Specifier mengarah ke branch utama.
5. Pada Script Path, isi Jenkinsfile (nama file di root repository).
6. Simpan, lalu klik Build Now.

Pipeline dengan checkout eksplisit dari SCM

pipeline {
    agent any
    stages {
        stage('Checkout') {
            steps {
                checkout scm
            }
        }
        stage('Hello') {
            steps {
                echo 'Kode berhasil diambil dari repository'
            }
        }
    }
}

Perhatikan langkah checkout scm — ini perintah eksplisit untuk mengambil source code ke workspace. Pada pipeline dari SCM, Jenkins otomatis men-checkout saat build dimulai, tapi menyebutkannya sebagai stage eksplisit membuat alur lebih transparan dan memudahkan kalian menambahkan checkout ulang di konfigurasi multi-branch (episode 4).

#Mengamati Hasil di UI

Setelah build selesai, perhatikan beberapa hal di halaman build:

• Build Number — setiap build mendapat nomor berurutan, ini variabel penting yang akan dipakai di episode 5.
• Stage View — diagram visual dari setiap stage dengan durasi dan status masing-masing.
• Console Output — log lengkap build. Biasakan membacanya: log ini adalah alat debugging utama kalian selama bertahun-tahun ke depan.

Jika ada sintaks yang salah, pipeline Declarative akan menampilkan error parsing secara jelas di Console Output — salah satu keuntungan sintaks yang terstruktur.

#Kesalahan Umum Pemula

1. Jenkinsfile tidak terdeteksi. Pastikan nama file persis Jenkinsfile (tanpa ekstensi) dan berada di root repo, atau sesuaikan Script Path.
2. Branch salah. Branch Specifier harus sesuai branch yang berisi Jenkinsfile, misal */main atau */master.
3. agent any disalahpahami. Ini berarti "jalankan di mana saja", bukan "jalankan di controller saja" — Jenkins tetap akan memilih executor yang cocok.
4. Menggabungkan Declarative dan Scripted sembarangan. Blok pipeline (Declarative) tidak bisa bercampur bebas dengan node { } (Scripted) di level teratas — pilih satu sintaks sebagai kerangka.

#Penutup

Pada episode 2 ini kalian telah:

• Memahami Pipeline as Code: definisi build hidup di Jenkinsfile di dalam repository, bisa di-review dan di-versioning seperti kode biasa.
• Membandingkan Declarative (terstruktur, mudah dibaca, direkomendasikan) dan Scripted (Groovy murni, fleksibel, kompleks).
• Membedah anatomi blok Declarative: pipeline, agent, stages, stage, dan steps.
• Menulis Jenkinsfile Hello World dan menjalankannya dari repository melalui Pipeline script from SCM.

Inti yang harus kalian bawa: pipeline adalah kode, dan kode itu disimpan di repository. Di episode 3 kita akan memperluas arsitektur ini — menyusun distributed architecture dengan agent-agent yang terpisah, memahami mengapa controller tidak boleh menjalankan build produksi, dan mengkonfigurasi SSH agent, Docker agent, hingga Kubernetes agent. Sampai jumpa di episode 3!