Setup Gitlab Runner Menggunakan Container

Gitlab-Runner

Gitlab Runner adalah . . .  
Emmm. . . . .  Emmmm. . . . .

Gampangnya, gitlab runner adalah salah satu tool otomatisasi yang mempermudah developer untuk melakukan kegiatan coding terutama di bagian deployment. Seperti build/compile code yang mereka buat, testing fungsi dan efektifitas code, hingga mengantarkan hasil build ke "zona" production yang siap di konsumsi oleh publik. Tapi kalo mau penjelasan officialnya, bisa anda lihat disini. ;)

Ada banyak metode running/executor untuk gitlab-runner, sperti shell, virtualbox, docker, ssh dan masih ada beberapa metode lainnya. Bisa anda lihat disini.

Nah, karena kebetulan developer lagi perlu unit testing buat android app dan saya repot kalo kudu ngurus generate/destroy avd, saya akan share cara melakukan setup gitlab runner dengan menggunakan executor docker.  :D :P

Environment  :

- Gitlab sebagai tool kolaborasi 

- Host runner terinstall layanan docker
- Linux server (saya menggunakan ubuntu server 14.04)

Gambar dibawah mungkin sedikit berbeda karena Gitlab kadang mengubah tampilan namun esensinya identik bahkan sama. Untuk mendaftarkan runner, buka project yang di inginkan. pada menu settings, pilih CI/CD

Menu Setting Runner

Kemudian pada bagian Runners settings klik expand, pada bagian specific runner terdapat variabel-variabel yang nantinya akan digunakan untuk mendaftarkan runner.

Variabel Register Runner Baru

Setelah itu, dari  remote host yang akan dijadikan sebagai runner, buat container gitlab-runner terlebih dahulu dengan perintah berikut, bagian yang saya tebalkan bebas anda ganti sesuai dengan keinginan atau menyesuaikan dengan sistem anda :

PROJECT_NAME=unittesting
docker run -d --name "$PROJECT_NAME"_runner --restart always \
-h "$PROJECT_NAME"-runner \
-v /var/run/docker.sock:/var/run/docker.sock \
-v /etc/gitlab-runner/config:/etc/gitlab-runner \
gitlab/gitlab-runner:latest

Pastikan container berhasil running terlebih dahulu dengan perintah

docker ps -a

Gitlab Runner Container

Kemudian, daftarkan runner dengan mengikuti langkah berikut :

docker exec -it "$PROJECT_NAME"_runner gitlab-runner register

kemudian isi value yang diminta dengan value yang ditampilkan pada gambar diatas

Konfigurasi Runner

  

Jika konfigurasi berhasil, seharusnya pada menu Runners settings, kita bisa melihat runner yang baru saja kita buat.

Runner Sudah Aktif

Kita juga bisa melihat spesifikasi runner yang kita buat dengan mengklik pada id runner, sehingga muncul seperti gambar berikut

Spesifikasi Runner

Setelah runner berhasil di daftarkan. Tinggal anda menambahkan image: openjdk:8-jdk pada file .gitlab-ci.yml. Image ini yang akan dijadikan base image untuk running container, kemudian perintah shell yang anda definisikan akan di eksekusi di dalam container tersebut. Untuk contoh .gitlab-ci.yml nya bisa anda lihat disini.

Semoga bermanfaat.