GitLab adalah manajer repositori GIT open source berdasarkan Rails dan dikembangkan oleh GitLab Inc. Ini adalah manajer repositori GIT berbasis web yang memungkinkan tim Anda untuk bekerja pada kode, melakukan permintaan fitur, melacak bug, dan menguji dan mengimplementasikan aplikasi. GitLab menyediakan fitur seperti wiki, pelacakan masalah, tinjauan kode, umpan aktivitas, dan manajemen gabungan. Itu dapat meng-host beberapa proyek.
GitLab tersedia dalam empat edisi:
- Gitlab CE (Edisi Komunitas) - dihosting sendiri, gratis, dan dukungan dari forum Komunitas.
- Gitlab EE (Edisi Perusahaan) - aplikasi berbayar yang dihosting sendiri, dilengkapi dengan fitur tambahan.
- GitLab.com - SaaS, gratis.
- GitLab.io - Instance GitLab pribadi yang dikelola oleh GitLab Inc.
Dalam tutorial ini, saya akan menunjukkan kepada Anda langkah demi langkah cara menginstal GitLab CE (Edisi Komunitas) di server Ubuntu 18.04 LTS (Bionic Beaver) Anda sendiri. Saya akan menggunakan paket 'omnibus' yang disediakan oleh GitLab untuk kemudahan instalasi.
Prasyarat
- Server Ubuntu 18.04
- Memori RAM minimal 4GB - untuk performa yang lebih baik, gunakan 8GB
- Hak istimewa root
Apa yang akan kami lakukan
- Perbarui Repositori dan Paket Peningkatan
- Instal Dependensi
- Instal Edisi Komunitas GitLab
- Buat SSL Letsencrypt dan Sertifikat DHPARAM
- Konfigurasikan HTTPS untuk GitLab
- Konfigurasikan Firewall UFW Ubuntu
- Pasca-Instalasi GitLab
- Pengujian
Langkah 1 - Perbarui Repositori dan Paket Upgrade
Sebelum menginstal paket apa pun di sistem, perbarui semua repositori yang tersedia, lalu perbarui semua paket di sistem.
Jalankan perintah apt di bawah ini.
sudo apt update
sudo apt upgrade -y
Tunggu paket instalasi yang akan diupgrade.
Langkah 2 - Instal Dependensi Gitlab
GitLab memerlukan beberapa dependensi paket untuk penginstalan, termasuk curl, postfix, dan ca-certificates.
Instal dependensi paket GitLab menggunakan perintah apt di bawah ini.
sudo apt install curl openssh-server ca-certificates postfix -y
Selama instalasi postfix, Anda akan ditanya tentang konfigurasi, pilih 'Situs Internet'.
Kemudian masukkan nama domain server yang akan digunakan untuk mengirim email.
Dan kami siap untuk menginstal GitLab di server.
Langkah 3 - Instal GitLab
Pada langkah ini, kita akan menginstal GitLab menggunakan paket omnibus. Omnibus akan menginstal semua paket, layanan, dan alat yang diperlukan untuk menjalankan GitLab di server.
Tambahkan repositori GitLab dengan perintah curl.
curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash
Kemudian instal GitLab CE Community Edition dengan perintah apt.
sudo apt install gitlab-ce -y
Perintah tersebut akan mengunduh dan menginstal paket GitLab CE, dan ketika instalasi selesai, Anda akan melihat hasilnya seperti di bawah ini.
Selanjutnya, kita harus mengkonfigurasi URL yang akan digunakan untuk mengakses server GitLab kita. Kami akan menggunakan domain bernama 'git.hakase-labs.pw' untuk URL akses GitLab dan akan mengaktifkan HTTPS di dalamnya.
Untuk mengubah akses URL GitLab, edit file '/etc/gitlab/gitlab.rb'.
sudo vim /etc/gitlab/gitlab.rb
Sekarang ubah nilai 'external_url' dengan nama domain Anda sendiri.
external_url 'http://git.hakase-labs.pw'
Simpan dan keluar.
Langkah 4 - Buat Mari mengenkripsi Sertifikat SSL dan Sertifikat DHPARAM
Pada langkah ini, kami akan membuat sertifikat Letsencrypt dan sertifikat DHPARAM baru untuk nama domain GitLab 'git.hakase-labs.pw'.
Instal alat memungkinkan enkripsi menggunakan perintah apt di bawah ini.
sudo apt install letsencrypt -y
Dan setelah instalasi selesai, jalankan perintah letsencrypt di bawah ini.
sudo letsencrypt certonly --standalone --agree-tos --no-eff-email --agree-tos --email [email protected] -d git.hakase-labs.pw
Dan jika sudah selesai maka akan mendapatkan hasil seperti gambar dibawah ini.
Sertifikat SSL Letsencrypt telah dibuat, terletak di direktori '/etc/letsencyrpt/'.
Selanjutnya, kita akan membuat sertifikat DHPARAM menggunakan perintah OpenSSL.
Buat direktori baru '/etc/gitlab/ssl' dan jalankan perintah OpenSSL di bawah ini.
sudo mkdir -p /etc/gitlab/ssl/
sudo openssl dhparam -out /etc/gitlab/ssl/dhparams.pem 2048
Sekarang ubah izin direktori SSL.
chmod 600 /etc/gitlab/ssl/*
Dan semua sertifikat yang diperlukan untuk konfigurasi HTTPS GitLab telah dibuat.
Langkah 5 - Konfigurasi HTTPS untuk GitLab
Untuk mengaktifkan HTTPS untuk instalasi GitLab, kita perlu mengedit file 'gitlab.rb'.
Edit file '/etc/gitlab/gitlab.rb' menggunakan perintah vim di bawah.
sudo vim /etc/gitlab/gitlab.rb
Ubah 'external_url' Gitlab menjadi 'https://git.hakase-labs.pw'.
external_url 'https://git.hakase-labs.pw'
Sekarang rekatkan konfigurasi di bawah ini ke bagian '#GitLab Nginx'.
nginx['redirect_http_to_https'] = true nginx['ssl_certificate'] = "/etc/letsencrypt/live/git.hakase-labs.pw/fullchain.pem" nginx['ssl_certificate_key'] = "/etc/letsencrypt/live/git.hakase-labs.pw/privkey.pem" nginx['ssl_dhparam'] = "/etc/gitlab/ssl/dhparams.pem"
Simpan dan keluar.
Sekarang jalankan perintah 'gitlab-ctl' di bawah ini.
sudo gitlab-ctl reconfigure
Perintah ini akan menginstal dan mengkonfigurasi GitLab berdasarkan file konfigurasi '/etc/gitlab/gitlab.rb'.
Dan jika sudah selesai maka akan terlihat hasilnya seperti dibawah ini.
Instalasi GitLab selesai, dan HTTPS untuk GitLab telah diaktifkan.
Langkah 6 - Konfigurasikan Firewall UFW Ubuntu
Pada langkah ini, kita akan mengaktifkan firewall UFW Ubuntu. Ini sudah diinstal pada sistem, kita hanya perlu memulai layanan. Kami akan menjalankan GitLab di belakang firewall UFW Ubuntu, jadi kami harus membuka port HTTP dan HTTPS.
Tambahkan layanan ssh, http, dan https ke konfigurasi.
sudo ufw allow ssh
sudo ufw allow http
sudo ufw allow https
Dan aktifkan firewall UFW Ubuntu dengan perintah di bawah ini.
sudo ufw enable
Ketik 'y' untuk ya untuk mengaktifkannya.
Sekarang periksa semua layanan dan daftar port pada daftar.
sudo ufw status
Dan Anda akan mendapatkan layanan ssh, http, dan https dalam daftar.
Langkah 7 - Pasca-Instalasi GitLab
Buka browser web dan ketik URL gitlab 'git.hakase-labs.pw', dan Anda akan diarahkan ke koneksi HTTPS.
Buat Kata Sandi Root GitLab Baru
Ketik kata sandi baru Anda untuk pengguna root GitLab, dan klik tombol 'Ubah kata sandi Anda'.
Sekarang Login sebagai pengguna 'root' dengan kata sandi Anda sendiri dan klik tombol 'Login'.
Sekarang Anda akan mendapatkan Dasbor GitLab.
Ubah Profil
Klik tombol profil dan pilih 'Pengaturan'.
Pada bagian 'Setelan Utama', ketik nama profil 'hakase' lalu klik opsi 'perbarui setelan profil'.
Ubah Nama Pengguna
Klik tab 'Akun' dan ketik nama pengguna 'hakase'.
Sekarang tekan tombol 'Perbarui nama pengguna'.
Tambahkan Kunci SSH
Buat kunci baru menggunakan perintah ssh-keygen seperti di bawah ini.
ssh-keygen
cat ~/.ssh/id_rsa.pub
Salin kunci 'id_rsa.pub'.
Sekarang kembali ke dasbor pengguna GitLab dan klik menu 'Kunci SSH' di sebelah kiri.
Rekatkan kunci publik ssh 'id_rsa.pub' dan klik tombol 'Tambahkan kunci'.
Batasan Pendaftaran
Klik tombol 'Admin area' di tengah, lalu klik 'Settings'.
Hapus centang pada opsi 'pendaftaran diaktifkan' dan klik tombol 'Simpan perubahan'.
Batas Akun
Klik pada bagian 'Akun dan batas' dan setel batas proyek default menjadi 20.
Dan klik tombol 'Simpan perubahan'.
Langkah 8 - Menguji Gitlab
Terakhir, kami akan melakukan beberapa pengujian untuk memastikan bahwa sistem GitLab kami berfungsi dengan baik.
Buat Proyek Baru
Klik ikon plus di bagian tengah atas untuk membuat repositori proyek baru. Ketik nama proyek Anda, deskripsi, dan atur pengaturan visibilitas proyek Anda. Kemudian klik tombol 'Buat proyek'.
Proyek baru telah dibuat.
Uji Komit dan Dorong Pertama
Sekarang kita akan mulai menambahkan konten baru ke repositori. Pastikan Git terinstal di komputer Anda, dan kita perlu menyiapkan nama pengguna dan email global untuk git dengan perintah di bawah ini.
git config --global user.name "hakase"
git config --global user.email "[email protected]"
Kloning Repositori dan tambahkan file README.md.
git clone https://git.hakase-labs.pw/hakase/project01.git
cd project01/
vim README.md
Anda akan dimintai kata sandi pengguna 'hakase'. Silakan ketikkan kata sandi yang sama dengan yang Anda gunakan saat kami mengakses GitLab pertama kali.
Komit file baru ke repositori 'project01'.
git add .
git commit -m 'Add README.md file by hakase-labs'
Selanjutnya, dorong perubahan ke repositori di server GitLab.
git push origin master
Ketikkan kata sandi Anda dan tekan Enter untuk melanjutkan. Anda akan melihat hasilnya seperti di bawah ini.
Sekarang buka proyek 'project01' dari browser web Anda, dan Anda akan melihat bahwa file README.md baru telah ditambahkan ke repositori.
Panduan instalasi GitLab di Ubuntu 18.04 telah berhasil diselesaikan.