Instalasi GitLab Runner di Server Ubuntu

Agar development yang sedang berjalan semakin lancar, kita bisa memanfaatkan fitur CI/CD (continuous integration and continuous delivery/continuous deployment) yang ada di GitLab. Namun, agar fitur tersebut jalan kita perlu instalasi sebuah gitlab-runner yang bertugas untuk menjalankan script deployment atau testing.

Photo by Gabriel Heinzer on Unsplash

Yang perlu dipersiapkan ialah:

1. Repository GitLab
2. Server Ubuntu

login ke server

Langkah-langkah instalasi runner

Login ke server sebagai root

• Unduh binary gitlab-runner dengan command curl

curl -L --output /usr/local/bin/gitlab-runner "https://gitlab-runner-downloads.s3.amazonaws.com/v13.3.0/binaries/gitlab-runner-linux-amd64"

• Buat binary yang kita unduh menjadi executable

chmod +x /usr/local/bin/gitlab-runner

• Tambahkan user baru dengan command

useradd --comment 'GitLab Runner' --create-home gitlab-runner --shell /bin/bash

• Lakukan instalasi dengan command

/usr/local/bin/gitlab-runner install --user=gitlab-runner --working-directory=/home/gitlab-runner

• Coba jalankan gitlab-runner

/usr/local/bin/gitlab-runner start

• Daftarkan ke GitLab

Siapkan {TOKEN} dari repository yang tadi sudah disiapkan, bisa kalian check di menu Settings > CI/CD > Runners

/usr/local/bin/gitlab-runner register --url "https://gitlab.javan.co.id/" --registration-token "{TOKEN}" --executor "shell" --shell "bash"

• Validasi instalasi dengan command:

/usr/local/bin/gitlab-runner list

Pastikan runner description pada langkah registrasi tadi muncul.

Coba buat gitlab-ci.yml yang sederhana untuk memastikan bahwasanya GitLab runner bisa executing task yang diberikan.

Troubleshooting

Apabila percobaan gitlab-ci.yml mendapatkan kendala seperti ini:

ERROR: Job failed (system failure): prepare environment: exit status 1.

• Login ke server sebagai root
• Ganti user ke gitlab-runner dengan command su gitlab-runner
• Buka berkas ~/.bash_logout
• Berikan tanda # pada masing-masing baris, sehingga akan jadi seperti ini