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 membangun, menyebarkan, dan menjalankan aplikasi mereka.
Ada tiga edisi berbeda dari GitLab yang tersedia, Community Edition (CE), Enterprise Edition (EE), dan versi yang dihosting oleh GitLab.
Jika Anda ingin memindahkan proyek Anda dari GitHubthen, Anda harus mencoba GitLab. 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 kebutuhan dan preferensi Anda. Tutorial ini mencakup langkah-langkah yang diperlukan untuk menginstal dan mengonfigurasi GitLab (CE) pada sistem CentOS 7 menggunakan paket Omnibus.
Prasyarat #
Tutorial ini mengasumsikan bahwa Anda memiliki instalasi CentOS 7 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.
Pengguna yang Anda masuki harus memiliki hak sudo untuk dapat menginstal paket.
Menginstal Dependensi yang Diperlukan #
Refresh indeks paket lokal dan instal dependensi dengan perintah berikut:
sudo yum install curl policycoreutils-python openssh-serverAgar 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 CentOS Anda:
sudo yum install postfix
Selama instalasi, Anda akan diminta untuk memilih jenis konfigurasi server surat. Opsi default adalah Internet Site . Itu opsi yang disarankan cukup tekan TAB , lalu ENTER .
Selanjutnya, Anda akan diminta untuk memasukkan System mail name yang harus sama dengan nama host server Anda.
Setelah instalasi selesai, mulai dan aktifkan layanan postfix dengan menjalankan perintah berikut:
sudo systemctl start postfixsudo systemctl enable postfix
Menginstal GitLab #
Instalasi GitLab adalah proses yang cukup mudah. Kami akan menginstal paket GitLab CE menggunakan yum 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.rpm.sh | sudo bashScript akan mengaktifkan repositori dan menginstal dependensi yang diperlukan. Setelah selesai, instal paket GitLab dengan menjalankan perintah berikut:
sudo yum install gitlab-ce
Anda akan diminta untuk menerima kunci GPG repositori GitLab. Ketik y dan tekan Enter .
Proses instalasi mungkin memakan waktu cukup lama dan setelah instalasi berhasil, Anda akan melihat output berikut:
Thank you for installing GitLab!
...
Complete!
Menyesuaikan Aturan Firewall #
Panduan tentang menyiapkan firewall dasar ditautkan di bagian prasyarat. Untuk dapat mengakses antarmuka GitLab, Anda harus membuka port 80 dan 443 . Untuk melakukannya jalankan perintah berikut:
sudo firewall-cmd --permanent --zone=public --add-service=httpsudo firewall-cmd --permanent --zone=public --add-service=httpssudo firewall-cmd --reload
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 vim /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 Anda tidak boleh mengaktifkan 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 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]
Masukkan kredensial login, klik tombol Sign in dan Anda akan diarahkan 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.