Hướng dẫn cài đặt và cấu hình GitLab trên Ubuntu

GitLab là một nền tảng mã nguồn mở dùng để quản lý mã nguồn thông qua Git, đồng thời cung cấp các tính năng hỗ trợ quy trình phát triển phần mềm như quản lý issue, CI/CD và nhiều tính năng khác. Bài viết này sẽ hướng dẫn bạn chi tiết từng bước cài đặt GitLab trên Ubuntu.

Xem thêm:

Hướng dẫn cài đặt và cấu hình Jenkins trên Ubuntu 22.04

Hướng dẫn triển khai CI/CD với Apache, Jenkins

1. Yêu Cầu Hệ Thống

Trước khi bắt đầu, bạn cần chuẩn bị:

  • Một máy chủ chạy Ubuntu (khuyên dùng Ubuntu 20.04 trở lên).
  • Một người dùng có quyền sudo.
  • Cấu hình phần cứng tối thiểu:
    • CPU: 4 cores
    • RAM: 4GB (không khuyến khích thay thế bằng swap)

2. Cài Đặt Các Gói Phụ Thuộc

Trước khi cài GitLab, bạn cần cài đặt một số gói phần mềm cần thiết:

sudo apt update
sudo apt install -y ca-certificates curl openssh-server postfix tzdata perl

Khi được hỏi trong quá trình cài postfix, chọn Internet Site, sau đó nhập tên miền máy chủ.

3. Cài Đặt GitLab

Bước 1: Tải script cài đặt

cd /tmp
curl -LO https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh

Bước 2: Chạy script cài đặt

sudo bash /tmp/script.deb.sh

Bước 3: Cài đặt GitLab Community Edition

sudo apt install -y gitlab-ce

4. Cấu Hình GitLab

Mở file cấu hình:

sudo nano /etc/gitlab/gitlab.rb

Chỉnh sửa 2 dòng sau:

external_url 'https://gitlab.yourdomain.com'
letsencrypt['contact_emails'] = ['youremail@example.com']

Lưu và chạy lệnh reconfigure:

sudo gitlab-ctl reconfigure

5. Truy Cập Giao Diện Web Lần Đầu

Mở trình duyệt và truy cập:

https://gitlab.yourdomain.com

Tên đăng nhập mặc định: root
Lấy mật khẩu ban đầu:

sudo cat /etc/gitlab/initial_root_password

Đăng nhập và đổi mật khẩu ngay sau đó trong phần Edit Profile > Password.

6. Cài Đặt GitLab Runner Cho CI/CD

Cài đặt Runner:

# Download the binary for your system
sudo curl -L --output /usr/local/bin/gitlab-runner https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-linux-amd64

# Give it permission to execute
sudo chmod +x /usr/local/bin/gitlab-runner

# Create a GitLab Runner user
sudo useradd --comment 'GitLab Runner' --create-home gitlab-runner --shell /bin/bash

# Install and run as a service
sudo gitlab-runner install --user=gitlab-runner --working-directory=/home/gitlab-runner
sudo gitlab-runner start

# If using a `deb` package based distribution
curl -s https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.deb.sh | sudo bash
apt install -y gitlab-runner

Đăng ký Runner:

sudo gitlab-runner register --url https://gitlab-server.southeastasia.cloudapp.azure.com/ --registration-token kzT1i2TsF-_128dRuusf

Excutor: shell

Cài Đặt GitLab Runner Cho CI/CD

Troubleshoot

Job fail:

sudo rm /home/gitlab-runner/.bash_logout

Bài viết cùng chủ đề:

Hướng dẫn triển khai CI/CD với Apache, Docker, Jenkins, Ansible

Triển khai CI/CD ứng dụng Java với Jenkins, Ansible và Tomcat

Triển khai CI/CD với Jenkins Pipeline, Agent, Docker

Nguyễn Tiến Trường

Mình viết về những điều nhỏ nhặt trong cuộc sống, Viết về câu chuyện những ngày không có em