Cách cài đặt và cấu hình GitLab trên Ubuntu 18.04 LTS

[theanh]

GitLab là trình quản lý kho lưu trữ GIT nguồn mở dựa trên Rails và được phát triển bởi GitLab Inc. Đây là trình quản lý kho lưu trữ GIT dựa trên web cho phép nhóm của bạn làm việc trên mã, thực hiện các yêu cầu tính năng, theo dõi lỗi và thử nghiệm và triển khai các ứng dụng. GitLab cung cấp các tính năng như wiki, theo dõi sự cố, đánh giá mã, nguồn cấp dữ liệu hoạt động và quản lý hợp nhất. Nó có thể lưu trữ nhiều dự án.

GitLab có bốn phiên bản:

1. Gitlab CE (Phiên bản cộng đồng) - tự lưu trữ, miễn phí và được hỗ trợ từ diễn đàn Cộng đồng.
2. Gitlab EE (Phiên bản doanh nghiệp) - tự lưu trữ, ứng dụng trả phí, đi kèm với các tính năng bổ sung.
3. GitLab.com - SaaS, miễn phí.
4. GitLab.io - Phiên bản GitLab riêng tư do GitLab Inc. quản lý.

Trong hướng dẫn này, tôi sẽ chỉ cho bạn từng bước cách cài đặt GitLab CE (Phiên bản cộng đồng) trên máy chủ Ubuntu 18.04 LTS (Bionic Beaver) của riêng bạn. Tôi sẽ sử dụng gói 'omnibus' do GitLab cung cấp để cài đặt dễ dàng.

Điều kiện tiên quyết​

• Máy chủ Ubuntu 18.04
• Bộ nhớ RAM tối thiểu 4GB - để có hiệu suất tốt hơn, hãy sử dụng 8GB
• Quyền root

Những việc chúng ta sẽ làm​

1. Cập nhật kho lưu trữ và nâng cấp các gói
2. Cài đặt các phụ thuộc
3. Cài đặt GitLab Community Edition
4. Tạo SSL Letsencrypt và DHPARAM Chứng chỉ
5. Cấu hình HTTPS cho GitLab
6. Cấu hình Tường lửa UFW của Ubuntu
7. Kiểm tra sau khi cài đặt GitLab

Bước 1 - Cập nhật Kho lưu trữ và Nâng cấp Gói​

Trước khi cài đặt bất kỳ gói nào trên hệ thống, hãy cập nhật tất cả các kho lưu trữ khả dụng rồi nâng cấp tất cả các gói trên hệ thống.

Chạy lệnh apt bên dưới.

sudo apt update
sudo apt upgrade -y

Chờ các gói cài đặt sẽ được nâng cấp.

Bước 2 - Cài đặt các gói phụ thuộc của Gitlab​

GitLab cần một số gói phụ thuộc để cài đặt, bao gồm curl, postfix và ca-certificates.

Cài đặt các gói phụ thuộc của GitLab bằng lệnh apt bên dưới.

sudo apt install curl openssh-server ca-certificates postfix -y

Trong quá trình cài đặt postfix, bạn sẽ được nhắc về cấu hình, hãy chọn 'Internet Site'.



Sau đó nhập tên miền máy chủ sẽ được sử dụng để gửi email.



Và chúng ta đã sẵn sàng cài đặt GitLab trên máy chủ.

Bước 3 - Cài đặt GitLab​

Trong bước này, chúng ta sẽ cài đặt GitLab bằng các gói omnibus. Omnibus sẽ cài đặt tất cả các gói, dịch vụ và công cụ cần thiết để chạy GitLab trên máy chủ.

Thêm kho lưu trữ GitLab bằng lệnh curl.

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

Sau đó cài đặt GitLab CE Community Edition bằng lệnh apt.

sudo apt install gitlab-ce -y

Lệnh này sẽ tải xuống và cài đặt gói GitLab CE và khi quá trình cài đặt hoàn tất, bạn sẽ thấy kết quả như bên dưới.



Tiếp theo, chúng ta nên cấu hình URL sẽ được sử dụng để truy cập vào máy chủ GitLab của mình. Chúng tôi sẽ sử dụng một tên miền có tên 'git.hakase-labs.pw' cho URL truy cập GitLab và sẽ bật HTTPS trên đó.

Để thay đổi quyền truy cập URL GitLab, hãy chỉnh sửa tệp '/etc/gitlab/gitlab.rb'.

sudo vim /etc/gitlab/gitlab.rb

Bây giờ hãy thay đổi giá trị 'external_url' bằng tên miền của riêng bạn.

external_url 'http://git.hakase-labs.pw'

Lưu và thoát.

Bước 4 - Tạo chứng chỉ SSL Let's encrypt và chứng chỉ DHPARAM​

Trong bước này, chúng tôi sẽ tạo chứng chỉ Letsencrypt và chứng chỉ DHPARAM mới cho tên miền GitLab 'git.hakase-labs.pw'.

Cài đặt công cụ lets encrypt bằng lệnh apt bên dưới.

sudo apt install letsencrypt -y

Sau khi cài đặt hoàn tất, hãy chạy lệnh letsencrypt bên dưới.

sudo letsencrypt certonly --standalone --agree-tos --no-eff-email --agree-tos --email [emailprotected] -d git.hakase-labs.pw

Khi hoàn tất, bạn sẽ nhận được kết quả như hình bên dưới.



Chứng chỉ SSL Letsencrypt đã được tạo, nằm trong thư mục '/etc/letsencyrpt/'.

Tiếp theo, chúng ta sẽ tạo chứng chỉ DHPARAM bằng lệnh OpenSSL.

Tạo thư mục mới '/etc/gitlab/ssl' và chạy lệnh OpenSSL bên dưới.

sudo mkdir -p /etc/gitlab/ssl/
sudo openssl dhparam -out /etc/gitlab/ssl/dhparams.pem 2048

Bây giờ hãy thay đổi quyền của thư mục SSL.

chmod 600 /etc/gitlab/ssl/*

Và tất cả các chứng chỉ cần thiết cho cấu hình GitLab HTTPS đã được tạo.

Bước 5 - Cấu hình HTTPS cho GitLab​

Để bật cài đặt HTTPS cho GitLab, chúng ta cần chỉnh sửa tệp 'gitlab.rb'.

Chỉnh sửa tệp '/etc/gitlab/gitlab.rb' bằng lệnh vim bên dưới.

sudo vim /etc/gitlab/gitlab.rb

Thay đổi 'external_url' của Gitlab thành 'https://git.hakase-labs.pw'.

external_url 'https://git.hakase-labs.pw'

Bây giờ hãy dán cấu hình bên dưới vào phần '#GitLab Nginx'.

nginx['redirect_http_to_https'] = truenginx['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"

Lưu và exit.



Bây giờ hãy chạy lệnh 'gitlab-ctl' bên dưới.

sudo gitlab-ctl reconfigure

Lệnh này sẽ cài đặt và cấu hình GitLab dựa trên tệp cấu hình '/etc/gitlab/gitlab.rb'.

Và khi hoàn tất, bạn sẽ thấy kết quả như bên dưới.



Quá trình cài đặt GitLab đã hoàn tất và HTTPS cho GitLab đã được bật.

Bước 6 - Cấu hình Tường lửa UFW của Ubuntu​

Trong bước này, chúng ta sẽ bật tường lửa UFW của Ubuntu. Tường lửa này đã được cài đặt trên hệ thống, chúng ta chỉ cần khởi động dịch vụ. Chúng ta sẽ chạy GitLab sau tường lửa Ubuntu UFW, vì vậy chúng ta phải mở các cổng HTTP và HTTPS.

Thêm các dịch vụ ssh, http và https vào cấu hình.

sudo ufw allow ssh
sudo ufw allow http
sudo ufw allow https

Và bật tường lửa Ubuntu UFW bằng lệnh bên dưới.

sudo ufw enable

Nhập 'y' cho yes để bật.

Bây giờ hãy kiểm tra tất cả các dịch vụ và danh sách cổng trong danh sách.

sudo ufw status

Và bạn sẽ nhận được các dịch vụ ssh, http và https trong danh sách.

Bước 7 - GitLab sau khi cài đặt​

Mở trình duyệt web và nhập URL gitlab 'git.hakase-labs.pw', và bạn sẽ được chuyển hướng đến kết nối HTTPS.

Tạo mật khẩu gốc GitLab mới​

Nhập mật khẩu mới cho người dùng GitLab gốc và nhấp vào nút 'Thay đổi mật khẩu'.



Bây giờ hãy đăng nhập với tư cách là người dùng 'root' bằng mật khẩu của riêng bạn và nhấp vào nút 'Đăng nhập'.



Bây giờ bạn sẽ nhận được Bảng điều khiển GitLab.

Thay đổi hồ sơ​

Nhấp vào nút hồ sơ và chọn 'Cài đặt'.



Trong phần 'Cài đặt chính', nhập tên hồ sơ 'hakase' rồi nhấp vào tùy chọn 'cập nhật cài đặt hồ sơ'.

Thay đổi Tên người dùng​

Nhấp vào tab 'Tài khoản' và nhập tên người dùng 'hakase'.



Bây giờ hãy nhấn nút 'Cập nhật tên người dùng'.

Thêm Khóa SSH​

Tạo khóa mới bằng lệnh ssh-keygen như bên dưới.

ssh-keygen
cat ~/.ssh/id_rsa.pub

Sao chép khóa 'id_rsa.pub'.



Bây giờ hãy quay lại bảng điều khiển người dùng GitLab và nhấp vào menu 'Khóa SSH' ở bên trái.



Dán khóa công khai ssh 'id_rsa.pub' và nhấp vào nút 'Thêm khóa'.

Đăng ký Hạn chế​

Nhấp vào Nút 'Khu vực quản trị' ở giữa, sau đó nhấp vào 'Cài đặt'.



Bỏ chọn tùy chọn 'đã bật đăng ký' và nhấp vào nút 'Lưu thay đổi'.

Giới hạn tài khoản​

Nhấp vào phần 'Tài khoản và giới hạn' và đặt giới hạn dự án mặc định là 20.



Và nhấp vào nút 'Lưu thay đổi'.

Bước 8 - Kiểm tra Gitlab​

Cuối cùng, chúng ta sẽ thực hiện một số thử nghiệm để đảm bảo hệ thống GitLab của chúng ta hoạt động bình thường.

Tạo dự án mới​

Nhấp vào biểu tượng dấu cộng ở giữa trên cùng để tạo kho lưu trữ dự án mới. Nhập tên dự án, mô tả và thiết lập cài đặt hiển thị cho dự án của bạn. Sau đó nhấp vào nút 'Tạo dự án'.



Dự án mới đã được tạo.

Kiểm tra lần cam kết và đẩy đầu tiên​

Bây giờ chúng ta sẽ bắt đầu thêm nội dung mới vào kho lưu trữ. Đảm bảo Git được cài đặt trên máy tính của bạn và chúng ta cần thiết lập tên người dùng và email toàn cục cho git bằng lệnh bên dưới.

git config --global user.name "hakase"
git config --global user.email "[emailprotected]"

Sao chép Kho lưu trữ và thêm tệp README.md.

git clone https://git.hakase-labs.pw/hakase/project01.git
cd project01/
vim README.md

Bạn sẽ được yêu cầu nhập mật khẩu người dùng 'hakase'. Vui lòng nhập cùng mật khẩu mà bạn đã sử dụng khi chúng ta truy cập GitLab lần đầu tiên.

Cam kết tệp mới vào kho lưu trữ 'project01'.

git add .
git commit -m 'Thêm tệp README.md của hakase-labs'

Tiếp theo, đẩy thay đổi vào kho lưu trữ trên máy chủ GitLab.

git push origin master

Nhập mật khẩu của bạn và nhấn Enter để tiếp tục. Bạn sẽ thấy kết quả như bên dưới.



Bây giờ hãy mở dự án 'project01' từ trình duyệt web của bạn và bạn sẽ thấy tệp README.md mới đã được thêm vào kho lưu trữ.



Hướng dẫn cài đặt GitLab trên Ubuntu 18.04 đã hoàn tất thành công.

Tham khảo​

• https://docs.gitlab.com/omnibus/