Install Gitlab-Runner di komputer

Gitlab Runner adalah proses yang bertugas untuk mengeksekusi jobs yang ada pada gitlab pipelines. Shared runner sudah tersedia di Gitlab dan dapat digunakan gratis, tapi anda tetap dapat menghubungkan private runner anda ke gitlab jika kurang puas dengan Shared Runner yang disediakan.

Gitlab runner tidak harus diinstall pada server yang online. Ia dapat diinstall pada komputer/laptop yang berada di belakang NAT tanpa perlu IP Publik karena katanya pengecekan jobs nya menggunakan metode pooling (ngecek jobs dalam interval tertentu).

Installer gitlab runner ada dalam beberapa bentuk: exe, deb, rpm, docker images, dll. Nah, karena saya development pakai docker, maka pada artikel ini saya akan menuliskan cara install nya dari docker images.

Install Docker

pada artikel ini saya pakai OS Ubuntu, kalo pakai yang lain silahkan disesuaikan

$ apt-get install docker docker-compose

tambahin user ke group docker supaya bisa ngakses sock nya.

$ usermod -aG docker $nama_user

Setup Gitlab Runner Images

Image gitlab docker ada di gitlab/gitlab-runner, setelah Docker terinstall anda dapat menjalankan image gitlab runner tersebut dengan perintah docker run, tapi pada artikel ini saya akan men-define service terlebih dahulu dengan docker-compose.

Buatlah folder dengan nama gitlab-runner atau apalah terserah, didalamnya buat file docker-compose.yml

$ mkdir ~/gitlab-runner && cd ~/gitlab-runner
$ nano docker-compose.yml

isi file docker-compose.yml kurang lebih seperti dibawah ini:

version: '3'
  services:
    gitlab-runner:
      image: gitlab/gitlab-runner:latest
      environment:
        - CI_SERVER_URL=https://gitlab.com
        - REGISTRATION_TOKEN=<REGISTRATION_TOKEN>
        - RUNNER_NAME=local-runner
        - REGISTER_NON_INTERACTIVE=true
        - RUNNER_EXECUTOR=docker
        - DOCKER_IMAGE=alpine
      volumes:
        # Docker sock
        - /var/run/docker.sock:/var/run/docker.sock:rw

REGISTRATION_TOKEN bisa kamu dapatkan pada salah satu repository gitlab, tepatnya di menu Settings -> CI/CD -> Runners -> Set up a specific Runner manually

setelah environment lengkap, jalankan container tersebut

$ docker-compose up -d gitlab-runner

setelah container tersebut jalan, masuk ke shell container tersebut untuk melakukan registrasi

$ docker-compose exec gitlab-runner bash

setelah berhasil masuk, jalan kan perintah ini untuk register

$ gitlab-runner register

Jika berhasil runner akan muncul pada repository Gitlab kamu. Runner yang diregister akan dikunci hanya untuk satu repository saja, untuk dapat menggunakan runner tersebut direpository lain, kamu perlu meng-edit runner tersebut kemudian hapus centang Lock to current projects