Cara Install GitLab di Debian 12 atau 11

GitLab adalah platform DevOps komprehensif yang menyediakan berbagai fitur untuk kontrol versi, integrasi berkelanjutan, penerapan, dan manajemen proyek. Ini mengintegrasikan berbagai tahapan siklus hidup DevOps ke dalam satu aplikasi, memungkinkan tim untuk bekerja secara kolaboratif dan efisien. GitLab Community Edition (CE) adalah versi sumber terbuka GitLab, yang menawarkan alat canggih untuk mengelola repositori, melacak masalah, dan mengotomatiskan pipeline CI/CD.

Untuk menginstal GitLab CE pada Debian 12 atau 11, Anda dapat menggunakan skrip Bash GitLab resmi untuk menyiapkan repositori APT GitLab CE, lalu menginstal dan mengonfigurasi perangkat lunak. Panduan ini akan memandu Anda melalui seluruh proses, memastikan Anda memiliki pengaturan GitLab yang kuat pada sistem Debian Anda.

Perbarui Debian Sebelum Instalasi Gitlab

Selalu memperbarui sistem operasi Debian Anda sangat penting untuk menjaga stabilitas dan keamanannya. Untuk memastikan bahwa semua paket yang ada di sistem Debian Anda adalah yang terbaru, disarankan untuk melakukan pembaruan untuk memberikan pembaruan keamanan terkini dan perbaikan bug, memastikan stabilitas dan keandalan sistem Anda.

Anda dapat dengan mudah memperbarui sistem operasi Debian Anda dengan menjalankan perintah berikut:

sudo apt update && sudo apt upgrade 

Instal Paket yang Diperlukan untuk GitLab

Memastikan bahwa semua dependensi untuk GitLab telah terinstal merupakan langkah penting dalam proses instalasi. Ketergantungan ini adalah komponen penting yang diandalkan GitLab agar berfungsi dengan benar. Untungnya, menginstal dependensi ini adalah proses yang sederhana.

Anda dapat menginstalnya dengan mudah dengan membuka terminal dan menjalankan perintah berikut:

sudo apt install curl ca-certificates apt-transport-https tzdata perl

Impor Repositori APT GitLab CE

Secara default, GitLab tidak tersedia di repositori default Debian. Artinya Anda harus membuat repositori secara manual untuk menginstal GitLab. Namun, GitLab menyediakan skrip APT untuk membantu proses ini, sehingga memudahkan pengguna untuk menginstal platform tersebut. Dengan skrip ini, Anda dapat membuat repositori GitLab, yang memungkinkan Anda menginstal GitLab menggunakan manajer paket APT standar.

Untuk mengunduh skrip, masukkan perintah berikut di terminal Anda:

curl -s https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash

Setelah Anda menjalankan perintah ini, skrip akan mengunduh dan menambahkan repositori GitLab ke sistem Debian Anda. Ini juga akan memperbarui daftar paket, memungkinkan Anda menginstal GitLab menggunakan manajer paket APT standar.

Selesaikan Instalasi GitLab melalui Perintah APT

Langkah selanjutnya adalah menginstal GitLab. Ingatlah bahwa skrip telah menggunakan perintah “apt update” untuk menyinkronkan repositori yang baru dibuat dan dimodifikasi. Setelah selesai, Anda sekarang dapat melanjutkan untuk menjalankan perintah instalasi dengan menjalankan perintah berikut:

sudo apt install gitlab-ce

Perintah ini akan menginstal GitLab Community Edition (CE), GitLab versi gratis dan sumber terbuka. Proses instalasi mungkin memerlukan waktu, tergantung pada kecepatan internet dan spesifikasi sistem Anda.

Contoh output jika instalasi GitLab berhasil di Debian:

Konfigurasikan GitLab

Untuk mengkonfigurasi GitLab di Debian, beberapa langkah harus diikuti dengan cermat. Bagian ini akan menjelaskan proses langkah demi langkah, termasuk mengonfigurasi nama host, menyiapkan firewall, dan mengonfigurasi pengaturan email.

Konfigurasikan Nama Host

Untuk mengakses instans GitLab Anda, penting untuk mengonfigurasi nama host untuk server GitLab Anda, jadi pilihlah nama yang mudah diingat dan diakses. Ikuti langkah-langkah berikut untuk mengonfigurasi nama host:

Buka file konfigurasi GitLab menggunakan editor teks:

sudo nano /etc/gitlab/gitlab.rb

Temukan pengaturan external_url dan ganti URL contoh dengan nama host yang Anda inginkan:

external_url 'https://gitlab.example.com'

Simpan file dan keluar dari editor teks.

Sekarang konfigurasikan ulang GitLab untuk menerapkan perubahan:

sudo gitlab-ctl reconfigure

Siapkan Firewall UFW untuk Gitlab

GitLab menggunakan port 80 untuk HTTP dan port 443 untuk HTTPS secara default. Sangat penting untuk mengonfigurasi firewall Anda untuk mengizinkan lalu lintas pada port ini dan memastikan bahwa instans GitLab Anda dapat diakses.

Ikuti langkah-langkah berikut untuk menyiapkan firewall:

Pertama, instal firewall UFW, karena firewall ini tidak diinstal di Debian secara default, dengan perintah berikut:

sudo apt install ufw

Selanjutnya, setelah instalasi selesai, aktifkan firewall UFW dengan perintah berikut:

sudo ufw enable

Buka file konfigurasi firewall menggunakan editor teks:

sudo nano /etc/ufw/applications.d/gitlab

Salin dan tempel baris berikut ke dalam file:

[GitLab]
title=GitLab
description=GitLab application
ports=80,443/tcp

Simpan file dan keluar dari editor teks.

Aktifkan aplikasi GitLab di firewall:

sudo ufw app update GitLab
sudo ufw allow GitLab

Konfigurasikan Pengaturan Email

GitLab menggunakan notifikasi email untuk memberi tahu pengguna tentang aktivitas proyek, seperti masalah baru, permintaan penggabungan, dan komentar.

Ikuti langkah-langkah berikut untuk mengonfigurasi pengaturan email:

Buka file konfigurasi GitLab menggunakan editor teks:

sudo nano /etc/gitlab/gitlab.rb

Temukan pengaturan gitlab_rails['smtp_enable'] dan atur ke true:

gitlab_rails['smtp_enable'] = true

Tambahkan baris berikut ke file untuk mengonfigurasi pengaturan server SMTP untuk penyedia email Anda, seperti Gmail:

gitlab_rails['smtp_address'] = "smtp.gmail.com"
gitlab_rails['smtp_port'] = 587
gitlab_rails['smtp_user_name'] = "example@gmail.com"
gitlab_rails['smtp_password'] = "your_password"
gitlab_rails['smtp_domain'] = "smtp.gmail.com"
gitlab_rails['smtp_authentication'] = "login"
gitlab_rails['smtp_enable_starttls_auto'] = true

Simpan file dan keluar dari editor teks.

Konfigurasi ulang GitLab untuk menerapkan perubahan:

sudo gitlab-ctl reconfigure

Penting untuk dicatat bahwa setelah menjalankan perintah “gitlab-ctl reconfigure”, Anda mungkin mengamati bahwa keluaran terminal diakhiri dengan pesan berikut:

Notes:
Default admin account has been configured with following details:
Username: root
Password: You didn't opt-in to print initial root password to STDOUT.
Password stored to /etc/gitlab/initial_root_password. This file will be cleaned up in first reconfigure run after 24 hours.

Untuk melihat kata sandi root (GitLab), jalankan perintah berikut di terminal Anda:

sudo cat /etc/gitlab/initial_root_password

Menjalankan perintah ini akan menampilkan kata sandi root di terminal. Sangat penting untuk menjaga keamanan kata sandi ini dan tidak membagikannya kepada pengguna yang tidak berwenang.

Jika Anda perlu mereset kata sandi root, Anda dapat menggunakan perintah berikut:

sudo gitlab-rake "gitlab:password:reset[root]"

Setelah menjalankan perintah ini, kata sandi root akan diatur ulang ke string acak yang ditampilkan di keluaran terminal. Penting untuk diingat bahwa menyetel ulang kata sandi root akan membatalkan semua token akses yang ada dan pribadi, sehingga pengguna harus membuat yang baru setelah menyetel ulang kata sandi.

Demi alasan keamanan, disarankan agar Anda mengubah kata sandi root menjadi kata sandi yang kuat dan unik sesegera mungkin setelah pengaturan awal dan hindari penggunaan kata sandi default. Anda dapat mengubah kata sandi root dengan masuk ke antarmuka web GitLab, masuk ke “Pengaturan Pengguna”> “Akun,” dan memilih opsi “Ubah Kata Sandi”.

Akses Antarmuka Pengguna GitLab

Setelah konfigurasi backend selesai, saatnya masuk dan mengakses GitLab. Untuk mencapai hal ini, buka jalur domain yang ditetapkan ke GitLab di file konfigurasi.

https://gitlab.example.com

Selanjutnya, masuk ke GitLab menggunakan nama pengguna “root” dan kata sandi yang Anda terima saat instalasi. Seperti disebutkan dalam cetakan kata sandi bagian sebelumnya, kata sandi panduan ini adalah “4zB2mbBLCcRLRAkv3qHfmSZULJ/6ocJNe2XK8zNx9nU=” pada gambar.

Anda telah berhasil login sebagai akun root dan akan tiba di halaman arahan default.

Tip Tambahan

Berikut adalah beberapa rekomendasi untuk mengamankan, menyesuaikan, atau tip umum lainnya saat pertama kali Anda masuk ke antarmuka pengguna GitLab:

• Ubah kata sandi default: Untuk meningkatkan keamanan instance GitLab Anda, penting untuk mengubah kata sandi default pengguna root. Masuk ke GitLab menggunakan nama pengguna dan kata sandi default, navigasikan ke “Pengaturan Pengguna”> “Kata Sandi,” dan masukkan kata sandi baru Anda.
• Siapkan otentikasi dua faktor (2FA): Menambahkan faktor autentikasi, seperti kode yang dikirim ke ponsel Anda atau dihasilkan oleh aplikasi, ke proses login merupakan lapisan keamanan tambahan yang disediakan oleh 2FA. Untuk mengaktifkan 2FA di GitLab, navigasikan ke “Pengaturan Pengguna”> “Akun”> “Otentikasi Dua Faktor” dan ikuti petunjuknya.
• Buat proyek: Untuk membuat proyek baru di GitLab, buka halaman “Proyek” dan klik tombol “Proyek Baru”. Anda dapat membuat proyek kosong atau mengimpor proyek yang sudah ada dari repositori Git.
• Sesuaikan antarmuka pengguna: GitLab memungkinkan beberapa opsi penyesuaian, seperti mengubah tema, menambahkan logo khusus, dan mengonfigurasi bilah navigasi. Navigasikan ke “Area Admin”> “Pengaturan” dan pilih opsi yang sesuai untuk menyesuaikan antarmuka pengguna.
• Konfigurasikan kontrol akses: Fitur kontrol akses GitLab yang canggih memungkinkan Anda mengontrol siapa yang dapat mengakses proyek Anda dan apa yang dapat mereka lakukan. Navigasikan ke “Pengaturan Proyek”> “Anggota” dan tambahkan atau hapus anggota dengan tingkat akses berbeda untuk mengonfigurasi kontrol akses.
• Gunakan GitLab CI/CD: Kemampuan CI/CD GitLab yang kuat mengotomatiskan pengujian dan penerapan kode Anda. Konfigurasikan pipeline CI/CD dengan membuat file “.gitlab-ci.yml” di direktori root proyek Anda dan tentukan tahapan dan tugas untuk pipeline Anda.
• Siapkan Pelari GitLab: GitLab Runner adalah agen ringan yang menjalankan tugas CI/CD dan mengirimkan hasilnya kembali ke GitLab. Ikuti instruksi dalam dokumentasi GitLab untuk menginstal dan mengkonfigurasi GitLab Runner di sistem Debian Anda.
• Cadangkan instance GitLab Anda: Cadangkan instance GitLab Anda secara rutin untuk mencegah kehilangan data jika terjadi kegagalan perangkat keras atau bencana lainnya. Jalankan perintah “gitlab-rake gitlab:backup:create” di terminal Anda untuk membuat cadangan instance GitLab Anda.

Buat Cronjob untuk Pencadangan Otomatis GitLab

Menyiapkan cronjob untuk pencadangan otomatis GitLab di Debian sangat penting untuk memastikan keselamatan dan keamanan data Anda. Cronjob adalah tugas terjadwal yang secara otomatis berjalan pada interval tertentu untuk melakukan pencadangan instans GitLab Anda. Ikuti langkah-langkah berikut untuk membuat cronjob untuk pencadangan otomatis GitLab di Debian.

Buat Skrip Cadangan Gitlab

Langkah pertama adalah membuat skrip cadangan untuk melakukan pencadangan instans GitLab Anda. Ikuti langkah-langkah berikut:

Menggunakan editor teks, buat file baru untuk skrip cadangan Anda. Berikut ini contohnya:

sudo nano /usr/local/bin/gitlab-backup.sh

Rekatkan kode berikut ke dalam file:

#!/bin/bash

BACKUP_DIR=/var/opt/gitlab/backups
TIMESTAMP=$(date +%s)

sudo gitlab-rake gitlab:backup:create

sudo cp ${BACKUP_DIR}/$(ls -t ${BACKUP_DIR} | head -1) ${BACKUP_DIR}/gitlab_backup_${TIMESTAMP}.tar

• Simpan file dan keluar dari editor teks.

Skrip ini akan membuat cadangan instans GitLab Anda dengan menjalankan perintah gitlab-rake gitlab:backup:create. Setelah membuat cadangan, skrip ini akan menduplikasi cadangan terbaru ke file baru dengan stempel waktu di nama file.

Menetapkan Izin dan Kepemilikan

Langkah selanjutnya adalah menetapkan izin dan kepemilikan yang sesuai untuk skrip cadangan guna memastikan cronjob dapat menjalankannya. Ikuti langkah-langkah berikut:

Tetapkan pemilik skrip cadangan ke pengguna yang terkait dengan GitLab:

sudo chown git:git /usr/local/bin/gitlab-backup.sh

Tetapkan izin skrip cadangan untuk mengaktifkan eksekusi:

sudo chmod +x /usr/local/bin/gitlab-backup.sh

Membuat Cronjob

Langkah selanjutnya adalah membuat cronjob untuk menjadwalkan skrip cadangan agar berjalan secara teratur. Ikuti langkah-langkah berikut:

Untuk membuka file konfigurasi crontab untuk pengguna GitLab, ikuti langkah-langkah berikut:

sudo crontab -u git -e

Untuk menjadwalkan skrip pencadangan agar dijalankan setiap hari pada pukul 01.00, tambahkan baris berikut ke file konfigurasi crontab untuk pengguna GitLab:

0 1 * * * /path/to/backup/script.sh

Simpan file dan keluar dari editor teks.

Cronjob ini akan secara otomatis mengeksekusi skrip pencadangan setiap hari pada pukul 01.00, menghasilkan file cadangan baru dengan stempel waktu di nama file.

Menguji Cronjob

Anda dapat memverifikasi fungsi cronjob dengan benar dengan menjalankan skrip pencadangan secara manual dan memastikan file cadangan dibuat tanpa kesalahan. Untuk melakukan tes ini, masukkan perintah berikut di terminal Anda:

sudo /usr/local/bin/gitlab-backup.sh

Perintah ini akan menghasilkan file cadangan baru di direktori”/var/opt/gitlab/backups”. Nama file akan menyertakan stempel waktu untuk menunjukkan kapan cadangan dibuat.

Perintah Terminal GitLab

GitLab-ctl adalah alat baris perintah untuk mengelola GitLab di Debian. Ini menyediakan serangkaian perintah terminal untuk memulai, menghentikan, memulai ulang, dan mengelola layanan GitLab, antara lain. Berikut adalah bagian mendetail tentang perintah terminal GitLab-ctl, beserta contoh perintah dan keluaran beserta penjelasannya.

Memulai dan menghentikan layanan GitLab

Untuk memulai dan menghentikan layanan GitLab, gunakan perintah berikut:

Mulai semua layanan GitLab:

sudo gitlab-ctl start

Hentikan semua layanan GitLab:

sudo gitlab-ctl stop

Mulai ulang semua layanan GitLab:

sudo gitlab-ctl restart

Muat ulang layanan GitLab:

sudo gitlab-ctl reload

Perintah ini akan memulai, menghentikan, memulai ulang, atau memuat ulang semua layanan GitLab. Outputnya akan menunjukkan layanan mana yang dimulai atau dihentikan dan apakah operasi berhasil.

Memeriksa status layanan GitLab

Untuk memeriksa status layanan GitLab, gunakan perintah berikut:

sudo gitlab-ctl status

Perintah ini akan memulai, menghentikan, memulai ulang, atau memuat ulang semua layanan GitLab. Setelah menjalankan perintah, output akan menunjukkan layanan mana yang terpengaruh dan apakah operasi berhasil.

Mencadangkan dan memulihkan data GitLab

Anda dapat membuat cadangan data GitLab dengan menggunakan perintah berikut:

Buat cadangan data GitLab:

sudo gitlab-rake gitlab:backup:create

Perintah yang diberikan akan membuat file cadangan yang berisi semua data GitLab, seperti repositori, data pengguna, dan file konfigurasi. File cadangan akan disimpan di direktori: “/var/opt/gitlab/backups”.

Pulihkan cadangan data GitLab:

sudo gitlab-rake gitlab:backup:restore BACKUP=<backup_file>

Dengan menggunakan perintah ini, Anda dapat memulihkan cadangan data GitLab dari file cadangan tertentu. File cadangan harus berada di direktori “var/opt/gitlab/backups”, atau Anda dapat menunjukkan path lengkap ke file cadangan.

Memeriksa konfigurasi GitLab

Anda dapat menggunakan perintah berikut untuk memeriksa konfigurasi GitLab:

sudo gitlab-rake gitlab:check

Perintah ini dapat memindai kesalahan atau peringatan dalam konfigurasi GitLab, termasuk versi yang sudah ketinggalan zaman, dependensi yang hilang, dan pengaturan yang salah dikonfigurasi. Outputnya akan merangkum hasil pemindaian dan informasi rinci tentang masalah apa pun yang terdeteksi.

Memeriksa log GitLab

Berikut cara memeriksa log GitLab menggunakan perintah berikut:

Lihat log GitLab:

sudo gitlab-ctl tail gitlab-rails/production.log

Anda dapat menggunakan perintah berikut untuk melihat sepuluh baris terakhir log produksi GitLab, yang merinci tindakan pengguna, peringatan, dan kesalahan.

Lihat log GitLab NGINX:

sudo gitlab-ctl tail nginx/gitlab_access.log

Perintah ini akan menampilkan sepuluh baris terakhir log akses GitLab NGINX yang berisi detail mengenai permintaan dan respons HTTP.

Lihat log GitLab PostgreSQL:

sudo gitlab-ctl tail postgresql/current

Perintah ini akan menampilkan sepuluh baris terakhir log GitLab PostgreSQL, yang berisi informasi tentang kueri dan transaksi database.

Kesimpulan

Dengan GitLab CE berhasil diinstal pada sistem Debian Anda menggunakan skrip pengaturan resmi, Anda dapat memanfaatkan sepenuhnya kemampuan DevOps yang kuat. Metode ini memastikan Anda memiliki versi terbaru dan akses mudah ke pembaruan. Pelihara dan perbarui instans GitLab Anda secara rutin untuk mendapatkan manfaat dari fitur terbaru dan peningkatan keamanan. Nikmati integrasi tanpa batas dan alat kolaboratif yang ditawarkan GitLab CE untuk proyek pengembangan Anda.