Cách cài đặt GitBucket với Nginx trên Ubuntu 18.04 LTS

[theanh]

GitBucket là một nền tảng Git miễn phí và mã nguồn mở được hỗ trợ bởi Scala với khả năng tương thích với Github API. Nó đơn giản, nhẹ và là sự thay thế cho Github hoặc BitBucket. Nó đi kèm với một loạt các tính năng bao gồm hỗ trợ GitLFS, sự cố, yêu cầu kéo, thông báo, hệ thống plug-in, kho lưu trữ Git công khai và riêng tư. Nó có thể dễ dàng tích hợp với LDAP để quản lý tài khoản và nhóm.

Trong hướng dẫn này, chúng ta sẽ tìm hiểu cách cài đặt và cấu hình GitBucket trên máy chủ Ubuntu 18.04.

Yêu cầu​

• Một máy chủ mới với Ubuntu 18.04.
• Mật khẩu gốc được cấu hình trên phiên bản của bạn.

Bắt đầu​

Trước khi bắt đầu, hãy cập nhật hệ thống của bạn lên phiên bản ổn định mới nhất. Bạn có thể thực hiện bằng lệnh sau:

apt-get update -y
 apt-get upgrade -y

Sau khi cập nhật, hãy khởi động lại máy chủ của bạn để áp dụng tất cả các thay đổi cấu hình.

Cài đặt Java​

GitBucket yêu cầu phải cài đặt Java 8 trở lên trên máy chủ của bạn. Vì vậy, bạn sẽ cần cài đặt Java trên máy chủ của mình.

Để cài đặt Java, hãy chạy lệnh sau:

apt-get install default-jdk -y

Sau khi Java được cài đặt, bạn có thể kiểm tra phiên bản Java bằng lệnh sau:

java -version

Bạn sẽ thấy đầu ra sau:

openjdk version "10.0.2" 2018-07-17Môi trường chạy thời gian OpenJDK (bản dựng 10.0.2+13-Ubuntu-1ubuntu0.18.04.2)Máy ảo máy chủ OpenJDK 64-Bit (bản dựng 10.0.2+13-Ubuntu-1ubuntu0.18.04.2, chế độ hỗn hợp)

Sau khi hoàn tất, bạn có thể tiến hành bước tiếp theo.

Cài đặt GitBucket​

Trước khi cài đặt GitBucket, bạn sẽ cần tạo một người dùng không có đặc quyền để chạy GitBucket.

Chạy lệnh sau để tạo một người dùng hệ thống có tên là gitbucket.

groupadd -g 555 gitbucket
 useradd -g gitbucket --no-user-group --home-dir /opt/gitbucket --no-create-home --shell /usr/sbin/nologin --system --uid 555 gitbucket

Tiếp theo, tải xuống GitBucket từ kho lưu trữ Git bằng lệnh sau:

wget https://github.com/gitbucket/gitbucket/releases/download/4.31.2/gitbucket.war

Sau khi tải xuống hoàn tất, hãy tạo một thư mục cho GitBucket bên trong /opt

mkdir /opt/gitbucket

Tiếp theo, di chuyển tệp đã tải xuống vào thư mục gitbucket:

mv gitbucket.war /opt/gitbucket

Tiếp theo, cấp quyền thích hợp cho thư mục gitbucket bằng lệnh sau:

chown -R gitbucket:gitbucket /opt/gitbucket

Sau khi hoàn tất, bạn có thể tiến hành bước tiếp theo.

Tạo tệp Dịch vụ Systemd cho GitBucket​

Tiếp theo, bạn sẽ cần tạo tệp dịch vụ Systemd cho GitBucket để quản lý dịch vụ GitBucket. Bạn có thể tạo nó bằng lệnh sau:

nano /etc/systemd/system/gitbucket.service

Thêm các dòng sau:

# GitBucket Service[Unit]Description=Manage Java service[Service]WorkingDirectory=/opt/gitbucketExecStart=/usr/bin/java -Xms128m -Xmx256m -jar gitbucket.warUser=gitbucketGroup=gitbucketType=simpleRestart=on-failureRestartSec=10[Install]WantedBy=multi-user.target

Lưu và đóng tệp. Sau đó, tải lại Systemd bằng lệnh sau:

systemctl daemon-reload

Tiếp theo, khởi động dịch vụ gitbucket và cho phép nó khởi động khi khởi động bằng lệnh sau:

systemctl enable gitbucket
 systemctl start gitbucket

Bây giờ bạn có thể kiểm tra trạng thái của gitbucket bằng lệnh sau:

systemctl status gitbucket

Bạn sẽ thấy đầu ra sau:

? gitbucket.service - Quản lý dịch vụ Java Đã tải: đã tải (/etc/systemd/system/gitbucket.service; disabled; vendor preset: enabled) Đang hoạt động: đang hoạt động (đang chạy) kể từ Tue 2019-08-09 09:43:42 UTC; 5 giây trước PID chính: 17835 (java) Nhiệm vụ: 18 (giới hạn: 1113) CGroup: /system.slice/gitbucket.service ??17835 /usr/bin/java -Xms128m -Xmx256m -jar gitbucket.war09/08 09:43:42 ubuntu1804 systemd[1]: Đã bắt đầu Quản lý dịch vụ Java.09/08 09:43:45 ubuntu1804 java[17835]: 09/07/2019 09:43:45.102:INFO::main: Ghi nhật ký được khởi tạo @2700ms vào org.eclipse.jetty.util.log.StdErrLog09/08 09:43:46 ubuntu1804 java[17835]: 09/07/2019 09:43:46.134:INFO:oejs.Server:main: jetty-9.4.z-SNAPSHOT; được xây dựng: 14/11/2018 21:20:31.478Z; gdòng 1-11/11 (KẾT THÚC)

Sau khi hoàn tất, bạn có thể tiến hành bước tiếp theo.

Cấu hình kết nối cơ sở dữ liệu cho GitBucket​

GitBucket có tích hợp cơ sở dữ liệu H2. Để cấu hình kết nối cơ sở dữ liệu, hãy mở tệp database.conf bằng trình soạn thảo văn bản yêu thích của bạn:

nano /opt/gitbucket/database.conf

Thêm các dòng sau:

db { url = "jdbc:h2:${DatabaseHome};MVCC=true" user = "sa" password = "sa"}

Sau khi hoàn tất, bạn có thể tiến hành bước tiếp theo.

Cấu hình Nginx làm Proxy ngược​

Theo mặc định, GitBucket chạy trên cổng 8080. Vì vậy, bạn sẽ cần cấu hình Nginx làm proxy ngược để cải thiện hiệu suất và bật các tính năng khác như mã hóa HTTP/2 và TLS.

Để thực hiện, trước tiên hãy cài đặt Nginx bằng lệnh sau:

apt-get install nginx -y

Tiếp theo, hãy tạo một proxy ngược cho GitBucket bằng cách tạo tệp sau:

nano /etc/nginx/sites-available/gitbucket.conf

Thêm các dòng sau:

upstream gitbucket { server 127.0.0.1:8080 weight=100 max_fails=5 fail_timeout=5;}server { listen 80; server_name your-domain.com; location / { proxy_set_header X-Forwarded-Host $host; proxy_set_header X-Forwarded-Server $host; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_pass http://gitbucket/; }}

Lưu và đóng tệp. Sau đó, bật máy chủ ảo Nginx bằng lệnh sau:

ln -s /etc/nginx/sites-available/gitbucket.conf /etc/nginx/sites-enabled/

Tiếp theo, kiểm tra xem Nginx có lỗi cú pháp nào không và khởi động lại dịch vụ Nginx bằng lệnh sau:

nginx -t

Bạn sẽ thấy đầu ra sau:

nginx: cú pháp tệp cấu hình /etc/nginx/nginx.conf là oknginx: tệp cấu hình /etc/nginx/nginx.conf đã kiểm tra thành công

systemctl restart nginx

Sau khi hoàn tất, bạn có thể tiến hành bước tiếp theo.

Truy cập Giao diện web GitBucket​

GitBucket hiện đã được cài đặt và định cấu hình. Mở trình duyệt web của bạn và nhập URL http://your-domain.com. Bạn sẽ được chuyển hướng đến trang sau:



Bây giờ, hãy nhấp vào nút Đăng nhập. Bạn sẽ được chuyển hướng đến trang đăng nhập như hiển thị bên dưới:



Bây giờ, hãy cung cấp tên người dùng và mật khẩu mặc định là root / root và nhấp vào nút Đăng nhập. Bạn sẽ thấy bảng điều khiển GitBucket trong trang sau:



Tiếp theo, hãy đến Cài đặt tài khoản để thay đổi mật khẩu root mặc định như hiển thị trong trang sau:



Xin chúc mừng! Bạn đã cài đặt và định cấu hình GitBucket thành công trên máy chủ Ubuntu 18.04 LTS. Hãy thoải mái hỏi tôi nếu bạn có bất kỳ câu hỏi nào.