KamusNgoding
Pemula Cicd 5 menit baca

Tutorial Jenkins untuk Pemula

#jenkins #cicd #devops #tutorial

Tutorial Jenkins untuk Pemula

Pendahuluan

Bayangkan kamu bekerja di tim pengembang yang memiliki puluhan anggota. Setiap hari, masing-masing developer menulis kode, lalu kode tersebut harus digabung, diuji, dan dideploy ke server. Tanpa alat bantu, proses ini bisa memakan waktu berjam-jam — bahkan berhari-hari. Di sinilah Jenkins hadir sebagai penyelamat.

Jenkins adalah salah satu alat otomasi CI/CD paling populer di dunia. Jika kamu sudah familiar dengan konsep dasar CI/CD, artikel ini akan membantumu mengimplementasikannya secara nyata menggunakan Jenkins. Bagi yang belum familiar, kamu bisa membaca dulu Panduan Lengkap Membuat Action Kustom di GitHub Actions untuk memahami ekosistem otomasi deployment secara lebih luas.

Mengenal Jenkins: Apa itu dan Mengapa Penting?

Jenkins adalah server otomasi open-source berbasis Java yang digunakan untuk mengotomatisasi proses build, test, dan deployment aplikasi. Singkatnya, Jenkins adalah “robot” yang bekerja tanpa lelah — ia akan menjalankan serangkaian tugas secara otomatis setiap kali kamu atau rekan tim melakukan perubahan kode.

Analogi Sederhana

Bayangkan Jenkins seperti seorang mandor di pabrik. Setiap kali ada bahan baku baru (kode baru dari developer), sang mandor langsung:

  1. Mengecek apakah bahan baku tersebut memenuhi standar (menjalankan unit test)
  2. Merakitnya dengan komponen lain (proses build)
  3. Mengirimkan produk jadi ke gudang (proses deploy)

Jika ingin membangun aplikasi seperti Tokopedia yang memiliki ratusan layanan berjalan bersamaan, memahami Jenkins adalah langkah krusial untuk menjaga kualitas kode tetap stabil di setiap rilis.

Keunggulan Jenkins

  • Open-source dan gratis — tidak perlu bayar lisensi
  • Plugin ekosistem besar — lebih dari 1.800 plugin tersedia
  • Fleksibel — bisa dijalankan di server sendiri (on-premise)
  • Mendukung berbagai bahasa — Java, Python, Node.js, PHP, dan lainnya

Instalasi dan Konfigurasi Awal Jenkins

Prasyarat

Sebelum menginstal Jenkins, pastikan sistem kamu memiliki:

  • Java JDK 11 atau 17 (Jenkins berbasis Java)
  • RAM minimal 512 MB (disarankan 1 GB+)
  • Sistem Operasi: Linux (Ubuntu/Debian), macOS, atau Windows

Instalasi di Ubuntu/Debian

# Tambahkan repository Jenkins
curl -fsSL https://pkg.jenkins.io/debian/jenkins.io-2023.key | sudo tee \
  /usr/share/keyrings/jenkins-keyring.asc > /dev/null

echo deb [signed-by=/usr/share/keyrings/jenkins-keyring.asc] \
  https://pkg.jenkins.io/debian binary/ | sudo tee \
  /etc/apt/sources.list.d/jenkins.list > /dev/null

# Update dan install
sudo apt update
sudo apt install jenkins -y

# Jalankan Jenkins dan aktifkan saat startup
sudo systemctl start jenkins
sudo systemctl enable jenkins

# Cek status Jenkins
sudo systemctl status jenkins

Konfigurasi Awal

Setelah instalasi, buka browser dan akses http://localhost:8080. Kamu akan diminta memasukkan initial admin password.

# Tampilkan password awal Jenkins
sudo cat /var/lib/jenkins/secrets/initialAdminPassword

Ikuti wizard instalasi:

  1. Masukkan password yang didapat dari perintah di atas
  2. Pilih “Install suggested plugins” (disarankan untuk pemula)
  3. Buat akun admin pertama
  4. Konfirmasi URL Jenkins kamu

Membuat Pipeline CI/CD Pertama Anda

Jenkins menggunakan Jenkinsfile untuk mendefinisikan alur kerja (pipeline). File ini ditulis dengan sintaks Groovy dan disimpan di root repositori kamu.

Struktur Dasar Jenkinsfile

pipeline {
    agent any

    stages {
        stage('Checkout') {
            steps {
                checkout scm
            }
        }

        stage('Install Dependencies') {
            steps {
                sh 'npm install'
            }
        }

        stage('Run Tests') {
            steps {
                sh 'npm test'
            }
        }

        stage('Build') {
            steps {
                sh 'npm run build'
            }
        }

        stage('Deploy') {
            when {
                branch 'main'
            }
            steps {
                sh './deploy.sh'
            }
        }
    }

    post {
        success {
            echo 'Pipeline berhasil! Deployment selesai.'
        }
        failure {
            echo 'Pipeline gagal! Periksa log di atas.'
        }
    }
}

Penjelasan Setiap Bagian

BagianFungsi
agent anyJalankan pipeline di agent mana pun yang tersedia
stagesWadah untuk semua tahapan pipeline
stage('Nama')Satu tahapan dalam pipeline
stepsPerintah yang dijalankan dalam sebuah stage
postAksi setelah pipeline selesai (sukses/gagal)

Membuat Job di Jenkins

  1. Buka dashboard Jenkins (http://localhost:8080)
  2. Klik “New Item”
  3. Masukkan nama project (misalnya: my-app-pipeline)
  4. Pilih “Pipeline” lalu klik OK
  5. Di bagian “Pipeline”, pilih “Pipeline script from SCM”
  6. Pilih Git dan masukkan URL repositori kamu
  7. Pastikan Script Path menunjuk ke Jenkinsfile
  8. Klik Save

Untuk mengelola secrets seperti API key atau token deployment, kamu bisa mempelajari konsepnya di artikel Secrets vs Variables di GitHub Actions — konsep yang sama berlaku di Jenkins melalui fitur Credentials.

Contoh Kasus Nyata

Pipeline untuk Aplikasi Node.js

Berikut contoh Jenkinsfile yang lebih lengkap untuk aplikasi Node.js dengan environment staging dan production:

pipeline {
    agent any

    environment {
        APP_NAME = 'my-nodejs-app'
        DOCKER_IMAGE = "registry.example.com/${APP_NAME}"
    }

    stages {
        stage('Checkout') {
            steps {
                git branch: 'main', url: 'https://github.com/username/my-app.git'
            }
        }

        stage('Install') {
            steps {
                sh 'npm ci'
            }
        }

        stage('Lint') {
            steps {
                sh 'npm run lint'
            }
        }

        stage('Test') {
            steps {
                sh 'npm test -- --coverage'
            }
            post {
                always {
                    junit 'coverage/junit.xml'
                }
            }
        }

        stage('Build Docker Image') {
            steps {
                script {
                    docker.build("${DOCKER_IMAGE}:${BUILD_NUMBER}")
                }
            }
        }

        stage('Deploy ke Staging') {
            when {
                branch 'develop'
            }
            steps {
                sh "docker run -d -p 3001:3000 ${DOCKER_IMAGE}:${BUILD_NUMBER}"
                echo "Deployed ke Staging!"
            }
        }

        stage('Deploy ke Production') {
            when {
                branch 'main'
            }
            steps {
                input message: 'Deploy ke Production?', ok: 'Deploy!'
                sh "docker run -d -p 80:3000 ${DOCKER_IMAGE}:${BUILD_NUMBER}"
                echo "Deployed ke Production!"
            }
        }
    }

    post {
        always {
            cleanWs()
        }
    }
}

Bayangkan jika ingin membangun layanan seperti Gojek — pipeline seperti ini memastikan setiap perubahan kode telah melewati serangkaian pengujian sebelum sampai ke tangan pengguna.

Troubleshooting: Error yang Sering Muncul

Permission denied saat menjalankan script

Penyebab: File script (misalnya deploy.sh) tidak memiliki izin eksekusi, sehingga Jenkins tidak bisa menjalankannya.

Solusi:

# Berikan izin eksekusi pada script di server
chmod +x deploy.sh

# Atau langsung dari Jenkinsfile
steps {
    sh 'chmod +x ./deploy.sh && ./deploy.sh'
}

Jenkins tidak bisa mengakses repositori Git (Authentication Failed)

Penyebab: Credentials Git belum dikonfigurasi di Jenkins, atau personal access token sudah kedaluwarsa.

Solusi:

// Tambahkan credentials di Jenkinsfile
stage('Checkout') {
    steps {
        git(
            url: 'https://github.com/username/repo.git',
            branch: 'main',
            credentialsId: 'github-token'  // ID credentials yang disimpan di Jenkins
        )
    }
}

Untuk menambahkan credentials: buka Dashboard → Manage Jenkins → Credentials → Add Credentials, lalu masukkan username dan personal access token GitHub kamu.

Pipeline gagal dengan error “No space left on device”

Penyebab: Disk server Jenkins penuh, sering terjadi karena build artifacts dan Docker images lama tidak dibersihkan.

Solusi:

# Hapus Docker images yang tidak terpakai
docker system prune -af

# Tambahkan di Jenkinsfile untuk membersihkan workspace otomatis
post {
    always {
        cleanWs()
    }
}

Build stuck di stage “Waiting for executor”

Penyebab: Tidak ada executor yang tersedia — semua agent sedang sibuk atau konfigurasi jumlah executor terlalu sedikit.

Solusi:

1. Buka Dashboard → Manage Jenkins → Configure System
2. Cari bagian "# of executors"
3. Tambah jumlahnya (misalnya dari 2 menjadi 4)
4. Klik Save

Pertanyaan yang Sering Diajukan

Apa perbedaan Jenkins dan GitHub Actions?

Jenkins adalah server CI/CD yang berjalan di infrastruktur milikmu sendiri (self-hosted), memberikan kontrol penuh namun memerlukan pemeliharaan server. GitHub Actions adalah layanan CI/CD berbasis cloud yang terintegrasi langsung dengan GitHub dan tidak memerlukan infrastruktur tambahan. Pilih Jenkins jika kamu butuh kontrol penuh dan privasi data; pilih GitHub Actions jika ingin kemudahan setup.

Apakah Jenkins gratis untuk digunakan secara komersial?

Ya, Jenkins sepenuhnya open-source di bawah lisensi MIT, sehingga bebas digunakan untuk proyek pribadi maupun komersial tanpa biaya lisensi. Kamu hanya perlu menyiapkan infrastruktur server untuk menjalankannya.

Bagaimana cara menjalankan Jenkins secara paralel untuk mempercepat build?

Gunakan blok parallel di dalam Jenkinsfile untuk menjalankan beberapa stage secara bersamaan:

stage('Test Paralel') {
    parallel {
        stage('Unit Test') {
            steps { sh 'npm run test:unit' }
        }
        stage('Integration Test') {
            steps { sh 'npm run test:integration' }
        }
        stage('Lint Check') {
            steps { sh 'npm run lint' }
        }
    }
}

Mengapa saya harus menggunakan Jenkinsfile dibanding konfigurasi langsung di UI Jenkins?

Jenkinsfile memungkinkan pipeline-as-code — konfigurasi pipeline disimpan bersama kode di repositori Git. Ini berarti perubahan pipeline bisa direview, di-version-control, dan direproduksi dengan mudah. Konfigurasi di UI rentan hilang jika server Jenkins direset atau perlu dipindahkan.

Bagaimana cara mengirim notifikasi ke Slack jika build gagal?

Install plugin Slack Notification di Jenkins, lalu tambahkan kode berikut di Jenkinsfile:

post {
    failure {
        slackSend(
            channel: '#dev-alerts',
            color: 'danger',
            message: "Build GAGAL: ${env.JOB_NAME} #${env.BUILD_NUMBER}"
        )
    }
}

Kesimpulan

Jenkins adalah fondasi yang kuat untuk membangun sistem CI/CD yang andal dan fleksibel. Dalam artikel ini, kamu telah mempelajari cara menginstal Jenkins, memahami struktur Jenkinsfile, membuat pipeline CI/CD pertama, hingga mengatasi error umum yang sering muncul. Dengan memahami Jenkins, kamu selangkah lebih maju dalam membangun proses pengembangan software yang profesional dan efisien.

Selamat belajar dan terus berlatih! Jangan takut untuk bereksperimen dengan berbagai plugin dan konfigurasi — semakin banyak kamu mencoba, semakin mahir kamu menguasai Jenkins. Jika ada pertanyaan lain seputar DevOps dan otomasi, jangan ragu untuk eksplorasi artikel-artikel lainnya di KamusNgoding.

Artikel Terkait

laravel CI/CD Laravel dengan GitHub Actions: Test Otomatis dan Deploy ke VPS cicd Apa itu CI/CD? Penjelasan Lengkap untuk Pemula cicd Cara Membuat Pipeline CI/CD Sederhana dengan GitHub Actions