Cách cài đặt Jenkins trên Ubuntu 22.04

[theanh]

Jenkins là một công cụ tự động hóa nguồn mở cho Tích hợp liên tục/Phân phối liên tục (CI/CD). được viết hoàn toàn bằng Java với sự hỗ trợ của hơn 1000 plugin để xây dựng, triển khai và tự động hóa dự án của bạn. Jenkins trở thành một trong những công cụ tự động hóa hàng đầu giúp đẩy nhanh quá trình phát triển của bạn thông qua tự động hóa. Jenkins tích hợp các quy trình vòng đời phát triển như xây dựng, lập tài liệu, kiểm tra, đóng gói, dàn dựng, triển khai, phân tích tĩnh và nhiều quy trình khác.

Jenkins hỗ trợ nhiều công cụ kiểm soát phiên bản như Git, Subversion, Mercurial, CVS, Perforce và RTC. Ngoài ra, nó có thể thực thi Apache Ant, Apache Maven, tập lệnh shell và lệnh hàng loạt Windows. Jenkins có cộng đồng hỗ trợ mạnh mẽ với tài liệu mở rộng và wiki, giúp Jenkins trở thành một trong những công cụ CI/CD tự động hóa được sử dụng nhiều nhất. Ngoài ra, nó cung cấp nhiều công cụ, ngôn ngữ và tác vụ tự động hóa khác nhau để tự động hóa quy trình phát triển và triển khai của bạn.

Trong hướng dẫn này, bạn sẽ tìm hiểu cách cài đặt Jenkins trên Ubuntu 22.04 mới nhất. hướng dẫn này cũng đề cập đến cách thiết lập Apache2 làm proxy ngược cho Jenkins với kết nối SSL được bật trên đó. Cuối cùng, bạn cũng sẽ học cách tạo dự án xây dựng Jenkins đầu tiên để thực thi các tập lệnh hoặc lệnh shell.

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

• Máy chủ Ubuntu 20.04
• Người dùng không phải root có quyền quản trị viên root.

Cài đặt Java​

Trong bước đầu tiên này, bạn sẽ cài đặt Java OpenJDK và JRE trên hệ thống Ubuntu của mình. Phiên bản mới nhất của Jenkins yêu cầu Java v11 và bây giờ bạn sẽ cài đặt nó trên hệ thống của mình.

Trước khi bắt đầu cài đặt bất kỳ gói nào, hãy chạy lệnh apt bên dưới để cập nhật và làm mới kho lưu trữ Ubuntu của bạn.

sudo apt update

Bây giờ hãy cài đặt Java OpenJDK 11 bằng lệnh sau.

sudo apt install openjdk-11-jre

Nhập Y để xác nhận và nhấn ENTER để bắt đầu cài đặt. Bây giờ quá trình cài đặt Java OpenJDK sẽ bắt đầu.



Sau khi quá trình cài đặt hoàn tất, hãy chạy lệnh java bên dưới để kiểm tra và xác minh phiên bản java.

java --version

Trong ảnh chụp màn hình sau, bạn có thể thấy Java OpenJDK 11 đã được cài đặt trên máy Ubuntu 22.04.

Cài đặt Jenkins​

Bây giờ bạn đã cài đặt java trên hệ thống Ubuntu của mình, bây giờ bạn sẽ bắt đầu cài đặt Jenkins vào máy Ubuntu 22.04.

Có nhiều cách để cài đặt Jenkins, cách dễ nhất là sử dụng gói Jenkins dựng sẵn do kho lưu trữ Jenkins chính thức cung cấp. Và để làm được điều đó, bạn sẽ cần thêm kho lưu trữ Jenkins vào hệ thống Ubuntu của mình.

Chạy lệnh bên dưới để thêm khóa GPG cho kho lưu trữ jenkins.

curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io.key | sudo tee \
 /usr/share/keyrings/jenkins-keyring.asc > /dev/null

Sau đó, thêm kho lưu trữ Jenkins vào hệ thống của bạn bằng lệnh bên dưới.

echo deb [signed-by=/usr/share/keyrings/jenkins-keyring.asc] \
 https://pkg.jenkins.io/debian-stable binary/ | sudo tee \
 /etc/apt/sources.list.d/jenkins.list > /dev/null

Bây giờ hãy chạy lệnh apt bên dưới để cập nhật và làm mới tất cả các kho lưu trữ hệ thống của bạn.

sudo apt update

Trong ảnh chụp màn hình bên dưới, bạn có thể thấy kho lưu trữ Jenkins đã được thêm vào.



Tiếp theo, bạn có thể cài đặt Jenkins bằng lệnh apt bên dưới.

sudo apt install jenkins

Nhập Y để xác nhận cài đặt và nhấn ENTER để tiếp tục. Quá trình cài đặt Jenkins bây giờ sẽ bắt đầu.



Sau khi cài đặt hoàn tất, hãy chạy lệnh sau để khởi động và kích hoạt dịch vụ Jenkins.

sudo systemctl start jenkins
sudo systemctl enable jenkins

Bây giờ hãy xác minh dịch vụ Jenkins bằng lệnh bên dưới.

sudo systemctl status jenkins

Trong ảnh chụp màn hình bên dưới, dịch vụ Jenkins đang hoạt động và chạy. Nó đang chạy trên localhost với cổng mặc định 8080. Ngoài ra, Jenkins hiện đã được bật, nghĩa là nó sẽ tự động chạy khi khởi động hệ thống.

Thiết lập Apache2 làm Proxy ngược​

Lúc này, Jenkins đã hoạt động và chạy trên địa chỉ mặc định localhost với cổng 8080. Bây giờ, bạn sẽ cài đặt và cấu hình máy chủ web Apache2 làm proxy ngược cho jenkins.

Máy chủ web Apache2 sẽ chạy trước dịch vụ Jenkins và mở các cổng HTTP và HTTPS tiêu chuẩn để máy khách truy cập.

Chạy lệnh apt bên dưới để cài đặt gói apache2 vào hệ thống của bạn.

sudo apt install apache2

Nhập Y để xác nhận cài đặt và nhấn ENTER để tiếp tục.



Bây giờ sau khi cài đặt hoàn tất, hãy chạy lệnh bên dưới để kích hoạt một số mô-đun apache2 cần thiết cho cấu hình proxy ngược.

sudo a2enmod ssl rewrite headers proxy proxy_http

Bây giờ bạn sẽ thấy đầu ra giống như ảnh chụp màn hình sau.



Tiếp theo, tạo cấu hình máy chủ ảo mới /etc/apache2/sites-available/jenkins.conf bằng trình soạn thảo nano.

sudo nano /etc/apache2/sites-available/jenkins.conf

Thêm cấu hình sau vào tệp. Và hãy đảm bảo thay đổi tên miền và đường dẫn của chứng chỉ SSL.

 ServerAdmin webmaster@localhost
 Chuyển hướng vĩnh viễn / https://jenkins.howtoforge.local/



 SSLEngine On
 SSLCertificateFile /etc/letsencrypt/live/jenkins.howtoforge.local/fullchain.pem
 SSLCertificateKeyFile /etc/letsencrypt/live/jenkins.howtoforge.local/privkey.pem
 ServerAdmin webmaster@localhost
 ProxyRequests Off
 ProxyPreserveHost On
 AllowEncodedSlashes NoDecode
 

 Order deny,allow
 Allow from all
 
 ProxyPass / http://localhost:8080/ nocanon
 ProxyPassReverse / http://localhost:8080/
 ProxyPassReverse / http://jenkins.howtoforge.local/
 RequestHeader set X-Forwarded-Proto "https"
 RequestHeader set X-Forwarded-Port "443"

Lưu và đóng tệp khi bạn hoàn tất.

Tiếp theo, chạy lệnh sau để kích hoạt cấu hình máy chủ ảo jenkins.conf.

sudo a2ensite jenkins.conf

Sau đó, hãy kiểm tra và xác minh tất cả các cấu hình Apache2 của bạn bằng lệnh bên dưới.

sudo apachectl configtest

Hãy đảm bảo rằng bạn nhận được thông báo đầu ra như "Cú pháp OK", nghĩa là tất cả cấu hình Apache2 của bạn đều đúng.

Cuối cùng, hãy chạy lệnh bên dưới để khởi động lại dịch vụ Apache2 và áp dụng các thay đổi mới cho cấu hình Apache2 của bạn.

sudo systemctl restart apache2

Bây giờ máy chủ web Apache2 đã hoạt động với cấu hình proxy ngược cho Jenkins.

Bắt đầu cài đặt Jenkins​

Lúc này, bạn đã sẵn sàng để bắt đầu cài đặt và cấu hình Jenkins từ trình duyệt web của mình. Nhưng trước khi bắt đầu cấu hình Jenkins, bạn sẽ cần lấy và nhận được mật khẩu khởi tạo cho Jenkins.

Mật khẩu khởi tạo cho Jenkins có sẵn tại tệp /var/lib/jenkins/secrets/initialAdminPassword. Tệp này chứa mật khẩu bí mật được tạo để khởi tạo cài đặt Jenkins của bạn.

Chạy lệnh bên dưới để kiểm tra và lấy mật khẩu ban đầu của jenkins.

ls /var/lib/jenkins/secrets/initialAdminPassword
cat /var/lib/jenkins/secrets/initialAdminPassword

Trong ảnh chụp màn hình bên dưới, bạn có thể thấy một chuỗi ngẫu nhiên do Jenkins tạo. Bạn có thể có một bí mật ngẫu nhiên khác.

Sao chép mật khẩu bí mật ban đầu vào ghi chú của bạn, mật khẩu này sẽ được sử dụng sau để thiết lập Jenkins.



Mở trình duyệt web của bạn và truy cập URL cài đặt cho cài đặt Jenkins của bạn (ví dụ: https://jenkins.howtoforge.local).

Ở trang đầu tiên, bạn sẽ được yêu cầu nhập mật khẩu khởi tạo cho Jenkins. Dán mật khẩu bí mật của bạn để khởi tạo cài đặt và cấu hình Jenkins, sau đó nhấp vào Tiếp tục.



Bây giờ hãy nhấp vào nút "Cài đặt các plugin được đề xuất" để bắt đầu cấu hình Jenkins với các plugin bổ sung. Tùy chọn này phù hợp với người mới bắt đầu, tùy chọn này sẽ tự động cài đặt một số plugin Jenkins có thể cần thiết cho dự án của bạn.



Bây giờ quá trình cài đặt plugin Jenkins sẽ bắt đầu và bắt đầu.



Sau khi quá trình cài đặt hoàn tất, bây giờ bạn sẽ được yêu cầu tạo một người dùng quản trị mới cho Jenkins.

Nhập người dùng quản trị mới, mật khẩu, địa chỉ email và tên đầy đủ cho cài đặt Jenkins của bạn và nhấp vào nút Lưu và Tiếp tục.



Đối với URL cài đặt Jenkins, hãy nhập tên miền Jenkins của bạn và nhấp vào Lưu và Hoàn tất.



Và bây giờ bạn sẽ nhận được trang sau. Nhấp vào nút Khởi động lại để khởi động lại dịch vụ Jenkins và áp dụng cấu hình mới.



Sau khi Jenkins khởi động lại, hãy truy cập lại tên miền của URL cài đặt Jenkins và bây giờ bạn sẽ nhận được trang đăng nhập của Jenkins.

Nhập tên người dùng quản trị và mật khẩu của bạn cho Jenkins và nhấp vào Đăng nhập.



Sau khi đăng nhập, bạn sẽ nhận được bảng điều khiển Jenkins sau.



Bây giờ bạn đã cài đặt và cấu hình Jenkins thành công trên Ubuntu 22.04 mới nhất với Apache2 làm proxy ngược cho quá trình triển khai của bạn.

Tạo bản dựng Jenkins đầu tiên​

Sau khi bạn đã cài đặt và cấu hình Jenkins thành công, bây giờ bạn sẽ tạo bản dựng Jenkins đầu tiên mới từ bảng điều khiển Jenkins.

Trên bảng điều khiển Jenkins, hãy nhấp vào menu Mục mới để tạo dự án bản dựng Jenkins mới.



Nhập tên dự án và chọn loại dự án, sau đó nhấp vào OK. Trong bản demo này, tên của dự án là "bản dựng đầu tiên" với loại dự án là "Dự án Freestyle".



Trong "phần chung", hãy nhập mô tả về bản dựng của bạn.

Bây giờ hãy chuyển đến tab "Bản dựng" và chọn bản dựng là "Thực thi shell" và nhập lệnh sau làm lệnh dựng.

echo "Đây là bản dựng thử nghiệm trên jenkins"

Dự án này sẽ chỉ nhắc một thông báo "Đây là bản dựng thử nghiệm trên jenkins" trong đầu ra bản dựng Jenkins.

Bây giờ hãy nhấp vào nút Lưu.



Bây giờ trên dự án "bản dựng đầu tiên" chi tiết, hãy nhấp vào menu "Bản dựng ngay" để bắt đầu và chạy bản dựng Jenkins.



Sau khi quá trình hoàn tất, bạn có thể thấy phần lịch sử bản dựng trên menu dưới cùng như sau ảnh chụp màn hình.

Nhấp vào số bản dựng để biết thông tin chi tiết về hoạt động bản dựng đã hoàn tất.



Bây giờ, hãy nhấp vào menu "Console Output" và bạn sẽ nhận được đầu ra của Jenkins đầu tiên để dựng, đó là thông báo "Đây là bản dựng thử nghiệm trên jenkins". Và bản dựng Jenkins đã thành công.

Kết luận​

Xin chúc mừng! Bây giờ, bạn đã cài đặt thành công Jenkins trên máy chủ Ubuntu 22.04 mới nhất với Apache2 làm proxy ngược với kết nối bảo mật HTTPS được bật. Ngoài ra, bạn đã học cách khởi tạo và thiết lập Jenkins cơ bản và cũng đã tạo dự án dựng đơn giản đầu tiên bằng Jenkins.