GitLab adalah manajer Gitrepository open-source berbasis web yang ditulis dalam Ruby termasuk wiki, manajemen masalah, tinjauan kode, pemantauan, dan integrasi dan penyebaran berkelanjutan. Ini memungkinkan pengembang untuk membuat, meninjau, dan menerapkan proyek mereka.
Ada tiga edisi berbeda dari GitLab yang tersedia, Community Edition (CE), Enterprise Edition (EE), dan versi yang dihosting oleh GitLab.
GitLabis pilihan nomor satu jika Anda ingin menjauh dari GitHub. Itu dapat mengimpor proyek dan masalah dari berbagai sumber termasuk GitHub, yang membuat proses migrasi tidak merepotkan. Antarmuka GitLab dirancang dengan baik, bersih, intuitif, dan dekat dengan GitHub dalam hal pengalaman dan fungsionalitas pengguna.
Ada beberapa cara untuk menginstal GitLab tergantung pada kasus penggunaan yang diperlukan. Tutorial ini mencakup langkah-langkah yang diperlukan untuk menginstal dan mengkonfigurasi GitLab (CE) pada sistem Ubuntu 18.04 menggunakan paket Omnibus.
Prasyarat #
Tutorial ini mengasumsikan bahwa Anda memiliki instalasi Ubuntu 18.04 yang baru. Menurut halaman persyaratan GitLab, disarankan untuk menggunakan server dengan:
- memori RAM minimal 4 GB.
- 2 inti CPU.
- setidaknya 2 GB ruang swap.
- (opsional) Domain atau subdomain menunjuk ke alamat IP server.
Untuk lapisan keamanan tambahan, disarankan untuk menyiapkan firewall dasar. Anda dapat mengikuti langkah-langkah di Panduan Cara Mengatur Firewall dengan UFW di Ubuntu 18.04.
Sebelum memulai tutorial, pastikan Anda masuk sebagai pengguna dengan hak istimewa sudo.
Menginstal Dependensi yang Diperlukan #
Refresh indeks paket lokal dan instal dependensi dengan perintah berikut:
sudo apt updatesudo apt install curl openssh-server ca-certificates
Agar GitLab dapat mengirim email pemberitahuan, Anda dapat menginstal dan menggunakan Postfix atau menggunakan beberapa layanan surat transaksional seperti SendGrid, MailChimp, MailGun atau SES dalam hal ini Anda dapat melewati langkah berikut dan mengonfigurasi [pengaturan SMTP GitLab] (https://docs.gitlab.com/omnibus/settings/smtp.html) setelah penginstalan selesai.
Jalankan perintah berikut untuk menginstal Postfix di server Ubuntu Anda:
debconf-set-selections <<< "postfix postfix/mailname string $(hostname -f)"debconf-set-selections <<< "postfix postfix/main_mailer_type string 'Internet Site'"sudo apt install postfix
Untuk informasi lebih rinci tentang cara menyiapkan server email Anda sendiri, periksa seri ini.
Menginstal GitLab #
Instalasi GitLab adalah proses yang cukup mudah. Kami akan menginstal paket GitLab CE menggunakan apt pengelola paket.
Mulailah dengan menambahkan repositori GitLab ke daftar sumber sistem Anda menggunakan perintah curl berikut:
curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bashSetelah repositori diaktifkan, instal paket GitLab dengan menjalankan perintah berikut.
sudo apt install gitlab-ceProses instalasi mungkin memakan waktu cukup lama dan setelah instalasi berhasil, Anda akan melihat output berikut:
Thank you for installing GitLab!
Menyesuaikan Aturan Firewall #
Panduan tentang menyiapkan firewall dasar ditautkan di bagian prasyarat. Untuk dapat mengakses antarmuka GitLab kita perlu membuka port 80 dan 443 :
sudo ufw allow OpenSSHsudo ufw allow httpsudo ufw allow https
Untuk memastikan port yang diperlukan terbuka, Anda dapat memeriksa status firewall dengan:
sudo ufw statusStatus: active
To Action From
-- ------ ----
80/tcp ALLOW Anywhere
443/tcp ALLOW Anywhere
OpenSSH ALLOW Anywhere
80/tcp (v6) ALLOW Anywhere (v6)
443/tcp (v6) ALLOW Anywhere (v6)
OpenSSH (v6) ALLOW Anywhere (v6)
Setel URL GitLab #
Sebelum mengakses antarmuka web GitLab, kita perlu menyetel URL tempat GitLab dapat dijangkau. Buka file konfigurasi Gitlab dan buat perubahan berikut:
sudo nano /etc/gitlab/gitlab.rb
Di dekat bagian atas file konfigurasi, Anda akan melihat baris yang dimulai dengan external_url . Ubah nilainya agar sesuai dengan domain/subdomain atau alamat IP Anda. Jika Anda memiliki domain gunakan https dan jika Anda ingin mengakses antarmuka GitLab melalui alamat IP server Anda, gunakan http .
external_url 'https://gitlab.example.com'
Selanjutnya cari “Let’s Encrypt integration”, batalkan komentar pada baris yang dimulai dengan letsencrypt['enable'] dan setel ke true. Opsional jika Anda ingin menerima email dari Let's Encrypt mengenai domain Anda, batalkan komentar pada baris yang dimulai dengan letsencrypt['contact_emails'] dan tambahkan alamat email Anda.
Jika Anda menyetel external_url ke alamat IP maka jangan aktifkan integrasi Let's Encrypt.
letsencrypt['enable'] = true
letsencrypt['contact_emails'] = ['[email protected]'] # This should be an array of email addresses to add as contacts
Terakhir, simpan dan tutup file dan jalankan perintah berikut untuk mengkonfigurasi ulang Gitlab:
sudo gitlab-ctl reconfigurePerintah tersebut akan mengonfigurasi ulang pengaturan GitLab Anda dan menghasilkan sertifikat SSL Let's encrypt gratis.
Konfigurasi GitLab melalui Antarmuka Web #
Sekarang setelah Anda mengonfigurasi URL GitLab, Anda dapat memulai dengan konfigurasi awal melalui antarmuka web GitLab.
Luncurkan browser web Anda dan navigasikan ke:
https://your_gitlab_domain_or_server_IP.com
1. Mengatur kata sandi akun administratif #
Saat pertama kali mengakses antarmuka web, Anda akan diminta menyetel sandi untuk akun administratif.
Masukkan kata sandi yang aman dan klik Change your password tombol saat Anda selesai.
Anda akan diarahkan ke halaman login:
Nama pengguna akun administratif default adalah root . Nanti dalam tutorial ini, kami akan menunjukkan cara mengubah nama pengguna.
- Nama pengguna:root
- Sandi:[sandi yang telah Anda tetapkan]
Setelah Anda memasukkan kredensial login dan klik tombol Sign in Anda akan dibawa ke halaman Selamat Datang GitLab.
2. Mengedit Profil pengguna #
Hal pertama yang ingin Anda lakukan adalah mengedit profil pengguna Anda. Klik avatar pengguna (pojok kanan atas) dan dari menu tarik-turun, pilih Settings :
Di sini Anda dapat mengubah Nama, Email, dan informasi serta pengaturan profil lainnya. Lakukan perubahan sesuai keinginan Anda.
Setelah selesai, klik Update Profile settings tombol dan segera Anda akan menerima email konfirmasi ke alamat yang Anda berikan. Untuk mengonfirmasi akun Anda, ikuti petunjuk yang diberikan dalam email.
3. Mengubah Nama Pengguna #
Untuk mengakses halaman Profil, klik Account tautan dari menu navigasi vertikal sebelah kiri.
Seperti yang sudah Anda ketahui, nama pengguna default dari akun administratif pertama adalah root . Untuk mengubahnya cukup ketik nama pengguna baru Anda dan klik Update username tombol.
Di layar ini, Anda juga dapat mengaktifkan autentikasi dua faktor.
Saat berikutnya Anda masuk ke dasbor GitLab, Anda harus memasukkan nama pengguna baru.
4. Menambahkan Kunci SSH #
Untuk dapat mendorong perubahan git lokal Anda ke server GitLab, Anda harus menambahkan kunci publik SSH ke akun GitLab Anda.
Jika Anda sudah memiliki pasangan kunci SSH yang dibuat di sistem lokal Anda, Anda dapat menampilkan kunci publik dengan mengetik:
cat ~/.ssh/id_rsa.pubOutputnya akan terlihat seperti berikut:
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAACAQDd/mnMzHwjUzK8g3ldfsfRpJuC16mhWamaXRk8ySQrD/dzpbRLfDnZsLxCzRoq+ZzFHGwcQlJergtergdHGRrO8FE5jl3IWRRp+mP12qYw== [email protected]
Jika perintah di atas mencetak No such file or directory itu berarti Anda tidak memiliki pasangan kunci SSH yang dibuat di mesin Anda.
Untuk menghasilkan pasangan kunci SSH baru, gunakan perintah berikut:
ssh-keygen -t rsa -b 4096 -C "[email protected]"
Salin output dari perintah cat dan kembali ke antarmuka web GitLab. Klik SSH Keys dari menu navigasi vertikal sebelah kiri untuk mengakses halaman konfigurasi SSH Keys.
Di Key textarea tempel kunci publik yang sebelumnya Anda salin dari mesin lokal Anda, tetapkan judul deskriptif dan klik Add key tombol:
Sekarang Anda seharusnya dapat mendorong dan menarik perubahan proyek Anda dari komputer lokal Anda tanpa harus memberikan kredensial akun GitLab Anda.