Seperti halnya Github pages, Dengan menggunakan gitlab pages kita juga bisa menghosting halaman website statis untuk user, grup/organisasi dan halaman project. Bedanya di gitlab kita bisa menggunakan gitlab ci dan Gitlab runner untuk mendeploy halaman statis kita. Selain itu kita juga bisa menggunakan berbagai macam generator halaman statis dengan menambahkan file konfigurasi .gitlab-ci.yml.

Beberapa generator halaman statis yang bisa digunakan diantaranya (Klik link untuk demo halaman):

Fitur Gitlab pages ini pertama kali diluncurkan pada release Gitlab EE 8.3. Entah apa sudah tersedia untuk pengguna gratis atau tidak, tapi setelah saya coba menggunakan akun gratis tanpa subcribtion ataupun plan fitur ini bisa digunakan.

Nah, untuk teman - teman yang juga tertarik untuk mencoba berikut langkah - langkahnya. Disini saya menggunakan Generator halaman statis Jekyll.

1. Pertama login ke akun Gitlab.com

Jika belum memiliki akun silakan buat dulu.

2. Membuat Repository

Setelah login kemudian buat project / repo baru untuk website yang akan kita buat.

Create repo

Halaman bisa di buat untuk user, grup dan halaman untuk project. untuk membuat halaman user dan grup nama project / repository menggunakan format <username-user/group>.gitlab.io contoh pada gambar. Sedangkan untuk halaman project kita perlu membuat branch baru untuk menyimpan kode generator halamannya. Pada contoh disini membuat halaman untuk grup dan sama halnya dengan halaman user.

Cukup masukkan nama repository, Tambahkan Deskripsi (boleh kosong) dan pilih Visibiliti level untuk reponya. Kita bisa memilih private (gratis) agar reponya bisa terlihat untuk kita sendiri sedangkan halaman statis yang di deploy tetap bisa di akses secara pulik. Setelah selesai klik tombol Create Project.

3. Membuat project jekyll

Setelah selesai membuat repo, selanjutnya kita buat project jekyll di lokal komputer (komputer kita), untuk selanjutnya bisa kita push ke repository yang tadi kita buat di akun gitlab.

Jekyll new

Menginstall jekyll di komputer lokal sangat membatu dan berguna untuk mempreview website sebelum di publikasikan dengan men-deploy-nya langsung di komputer. Jika teman-teman belum atau ingin mencoba menginstall jekyll di komputer silakan baca di artikel Cara Install dan Konfigurasi Jekyll Di Ubuntu Linux

4. Mengkonfigurasi Jekyll.

Jika di github kita bisa menggunakan beberapa plungin jekyll yang telah disediakan, di gitlab kita hanya bisa menggunakan settingan default jekyll tanpa tambahan plungin. Tapi cukup lumayan lah untuk hanya sekedar untuk membuat blog statis atau halaman statis biasa.

Site setting

Untuk settingan jekyllnya seperti pada gambar disesuaikan dengan halaman / website yang akan kamu buat.

5. Menambahkan file konfigurasi Gitlab pages.

Gitlab-ci

Agar halaman statis kita bisa di deploy di server gitlab, maka tambahkan file pengaturan .gitlab-ci.yml di root folder project jekyll kita tadi. lalu isi file tersebut dengan kode untuk mendeploy jekyll, kodenya bisa dicopy dari link ini Atau ketikkan seperti pada gambar.

6. Push ke repository gitlab yang tadi sudah kita buat.

Push

7. Mengunjugi halaman / blog yang telah di deploy

Cek halaman yang kita buat tadi dengan menuliskan nama repo yang kita buat tadi seperti contoh gambar.

deployed

Jika tidak tidak tampil atau error coba cek lagi di status buildnya di repo gitlab, jika failed coba cari kesalahannya untuk diperbaiki dan klik manual tombol retry untuk mencoba mengulang mem-build artifacts-nya.

Build status

Nah, Itulah cara membuat blog dengan menggunakan fasilitas gitlab page. Semoga sukses dengan praktiknya.