Cách tải xuống và cài đặt Jenkins on Windows
Thomas Hamilton
⚡ Tóm tắt thông minh
Tải về và cài đặt Jenkins on Windows Sử dụng trình cài đặt MSI chính thức, sau đó mở khóa bộ điều khiển, áp dụng các plugin và tạo tài khoản quản trị viên đầu tiên. Tất cả các điều kiện tiên quyết, thiết lập cổng và quyền dịch vụ cần thiết cho một máy chủ tự động hóa ổn định đều được liệt kê bên dưới.
Jenkins có thể được lắp đặt trên một trong hai Windows hoặc các nền tảng Unix, nhưng hướng dẫn này tập trung vào... Windows Chỉ dành cho việc lắp đặt. Windows Trình cài đặt MSI đăng ký Jenkins như là một Windows dịch vụ và chọn phiên bản 64-bit Java Trình cài đặt này cung cấp môi trường chạy tự động cho bạn, giúp bạn nhanh chóng có được một máy chủ tự động hóa hoạt động. Trước khi mở trình cài đặt, hãy xác nhận rằng máy của bạn đáp ứng các yêu cầu được liệt kê trong phần tiếp theo.
Jenkins Điều kiện tiên quyết và yêu cầu hệ thống
Jenkins Máy có dung lượng nhẹ khi ở trạng thái nghỉ nhưng sẽ nhanh chóng tăng kích thước khi lịch sử xây dựng, không gian làm việc và plugin tích lũy. Việc xác định kích thước máy chính xác ngay từ đầu sẽ tránh được những rắc rối khi chuyển đổi sau này.
Yêu cầu phần cứng:
| Tài nguyên | Mức tối thiểu tuyệt đối | Phù hợp cho nhóm nhỏ. |
|---|---|---|
| RAM | 256 MB | 4 GB trở lên |
| Không gian lái xe | 1 GB | 50 GB trở lên |
| Java thời gian chạy | Java 21 | Java 21 hoặc Java 25 (bit 64) |
yêu cầu phần mềm:
- Jenkins chạy trên Java, do đó được hỗ trợ Java Bộ dụng cụ phát triển (JDK) hoặc Java Môi trường chạy (JRE) phải có sẵn. Hiện tại Jenkins các bản phát hành yêu cầu Java 21 trở lên; Java Các phiên bản 8, 11 và 17 không còn được hỗ trợ bởi gói Hỗ trợ Dài hạn mới nhất.
- Cần có trình duyệt web hiện đại để truy cập vào... Jenkins bảng điều khiển.
- Một tài khoản có quyền quản trị trên Windows Cần có máy để đăng ký. Jenkins dịch vụ.
Xác nhận đã cài đặt Java Kiểm tra phiên bản từ Command Prompt trước khi tiếp tục. Nếu lệnh thất bại hoặc báo cáo phiên bản dưới 21, hãy cài đặt JDK được hỗ trợ trước.
:: Check the Java version available on the machine java -version :: Expected output resembles the following openjdk version "21.0.5" 2024-10-15 LTS OpenJDK Runtime Environment Temurin-21.0.5+11 (build 21.0.5+11-LTS) OpenJDK 64-Bit Server VM Temurin-21.0.5+11 (build 21.0.5+11-LTS, mixed mode)
Các loại phát hành
Jenkins Phát hành hai dòng phiên bản khác nhau, và sự lựa chọn này sẽ ảnh hưởng đến tần suất nâng cấp của bạn.
| Dòng phát hành | Nhịp | Tính ổn định | Đối tượng dự định |
|---|---|---|---|
| Hỗ trợ dài hạn (LTS) | Mỗi 12 tuần | Chỉ áp dụng các bản vá lỗi đã được kiểm thử rộng rãi và chuyển ngược lại. | Người dùng cuối và nhóm sản xuất |
| Hàng tuần | Mỗi tuần | Các tính năng mới nhất và sửa lỗi, giảm thiểu thời gian thử nghiệm thực địa. | Các nhà phát triển plugin và những người dùng tiên phong |
Hướng dẫn này sử dụng phiên bản LTS, tuy nhiên quy trình cài đặt hoàn toàn giống nhau đối với phiên bản hàng tuần. Sau khi đáp ứng đủ các điều kiện cần thiết, bạn có thể bắt đầu tải xuống.
Làm thế nào để Download Jenkins?
Hãy làm theo các bước bên dưới để nhận được Windows người cài đặt và hoàn tất quá trình cài đặt thành công:
Bước 1) Đến phần https://www.jenkins.io/download/ và chọn nền tảng. Trong trường hợp của chúng tôi, Windows.
Bước 2) Truy cập vào thư mục chứa tệp đã tải xuống trên máy tính của bạn và giải nén gói đã tải xuống. Double- Nhấp vào tệp đã giải nén jenkins.msi tập tin. Jenkins Nó cũng có thể chạy từ tệp WAR (Web application ARchive), nhưng cách này không được khuyến khích. Windows vì nó bỏ qua bước đăng ký dịch vụ do trình cài đặt thực hiện.
Lưu ý: Windows SmartScreen có thể báo cáo rằng nó đã ngăn chặn một ứng dụng không được nhận dạng khởi chạy. Chọn Thêm thông tinthì Chạy bất cứ đâu, để tiếp tục với văn bản đã ký Jenkins trình cài đặt.
Bước 3) Trong tạp chí Jenkins Màn hình thiết lập, nhấp chuột Trang Tiếp.
Bước 4) Chọn vị trí nơi Jenkins Phiên bản này cần được cài đặt. Vị trí mặc định trên các trình cài đặt 64-bit hiện tại là C:\Tệp chương trình\JenkinsHãy ghi nhớ đường dẫn này, vì mật khẩu quản trị viên ban đầu được lưu trữ bên trong đó. Nhấp chuột Trang Tiếp.
Bước 5) Sau đó, trình cài đặt sẽ yêu cầu thông tin đăng nhập dịch vụ và số cổng. Cung cấp tài khoản cục bộ hoặc tài khoản miền riêng và nhấp vào Chứng chỉ kiểm trasau đó chọn cổng và nhấp chuột. Cổng kiểm tra. Hải cảng 8080 là mặc định. Đang chạy Jenkins Việc sử dụng tài khoản dịch vụ được đặt tên an toàn hơn so với tùy chọn LocalSystem, tùy chọn này cấp quyền... Jenkins Quyền truy cập đầy đủ vào máy.
Bước 6) Xác nhận Java Sau khi trình cài đặt phát hiện thư mục chính, hãy xem lại các tùy chọn thiết lập tùy chỉnh và nhấp vào nút. đặt nút. Sau khi quá trình cài đặt hoàn tất, hãy nhấp vào Kết thúc.
Bước 7) Trong quá trình cài đặt, một bảng thông báo có thể xuất hiện để thông báo rằng cần phải khởi động lại máy tính sau khi quá trình cài đặt hiện tại hoàn tất. Nhấp vào OK nhấn nút khi bảng thông tin xuất hiện.
Các tập tin hiện đã được lưu trên ổ đĩa và dịch vụ đã được đăng ký. Bước tiếp theo là mở khóa giao diện web.
Cách bỏ chặn Jenkins?
Sau khi hoàn thành Jenkins Trong giai đoạn cài đặt, bộ điều khiển sẽ bị khóa cho đến khi bạn nhập mật khẩu được tạo tự động. Các bước dưới đây giải thích cách mở khóa. Jenkins ứng dụng:
Bước 1) Sau khi quá trình cài đặt hoàn tất, một tab trình duyệt sẽ mở ra và yêu cầu mật khẩu quản trị viên ban đầu. Để truy cập JenkinsHãy truy cập đường dẫn sau trong trình duyệt web của bạn.
http://localhost:8080
Nếu địa chỉ trên được tải, quá trình cài đặt đã thành công và dịch vụ đang hoạt động.
Bước 2) Mật khẩu quản trị viên ban đầu được lưu trữ trong... Jenkins Đường dẫn cài đặt mà bạn đã thiết lập ở Bước 4 của quá trình cài đặt. Đối với vị trí mặc định C:\Tệp chương trình\Jenkins, một tập tin có tên là ban đầuAdminMật khẩu được tìm thấy dưới C:\Tệp chương trình\Jenkinsbí mậtNếu đã chọn đường dẫn tùy chỉnh, hãy kiểm tra vị trí đó thay vì vị trí mặc định. Giá trị tương tự cũng được ghi vào... jenkins.err.log tập tin trong Jenkins thư mục chính.
Bước 3) Mở tệp được chọn và sao chép nội dung của tệp đó. ban đầuAdminMật khẩu tập tin.
Bước 4) Dán mật khẩu vào Mật khẩu quản trị viên trường trên Mở khóa Jenkins trang trong trình duyệt của bạn và nhấp vào Tiếp tục .
Sau khi bộ điều khiển được mở khóa, trình hướng dẫn thiết lập sẽ chuyển sang phần plugin và tài khoản người dùng đầu tiên.
Tùy chỉnh Jenkins
Bạn cũng có thể tùy chỉnh của bạn Jenkins thiết lập môi trường bằng các bước được hướng dẫn bên dưới:
Bước 1) Nhấn vào Cài đặt các plugin được đề xuất nút để Jenkins Tải xuống và cài đặt các plugin cần thiết.
Jenkins Bắt đầu tải xuống và cài đặt tất cả các plugin cần thiết để tạo mới. Jenkins việc làm.
Lưu ý: Bạn có thể chọn tùy chọn đó. Chọn các plugin để cài đặt và chỉ chọn những plugin bạn muốn. Bạn có thể thêm hoặc xóa plugin sau này. Quản lý Jenkins > PluginVì vậy, sự lựa chọn này không phải là vĩnh viễn.
Bước 2) Sau khi cài đặt tất cả các plugin được đề xuất, Tạo người dùng quản trị đầu tiên Bảng điều khiển sẽ hiện ra. Điền đầy đủ thông tin tài khoản mong muốn vào tất cả các trường và nhấp vào nút. Lưu và Kết thúc .
Bước 3) Jenkins cuối cùng yêu cầu URL Nơi mà phiên bản sẽ được truy cập. Hãy để nguyên giá trị mặc định để tránh nhầm lẫn sau này. Nếu một ứng dụng khác đã sử dụng cổng 8080, hãy cung cấp một cổng khác ở đây, sau đó nhấp vào nút. Lưu và Tiếp tục .
Chúc mừng! Một thành viên mới Jenkins Máy chủ đã được cài đặt. Nhấp vào Bắt đầu sử dụng Jenkins .
Jenkins Máy chủ đã được thiết lập và hoạt động, sẵn sàng cho công việc đầu tiên của bạn. Một đoạn mã ngắn Jenkins hướng dẫn cho người mới bắt đầu Giải thích cách tạo ra công việc đó.
Cách xác minh Jenkins Cài đặt và Quản lý Dịch vụ
Việc bảng điều khiển chỉ tải một lần không chứng tỏ quá trình cài đặt diễn ra suôn sẻ. Bởi vì trình cài đặt MSI đăng ký... Jenkins như là một Windows Dịch vụ phải hoạt động bình thường sau khi khởi động lại hệ thống và khởi động lại một cách trơn tru khi được yêu cầu. Hãy thực hiện các bước kiểm tra bên dưới ngay sau khi trình hướng dẫn thiết lập đóng lại.
- Xác nhận dịch vụ có tồn tại hay không. Ấn Bản Win + R, kiểu
services.mscvà nhấn Enter. Tìm mục có tên Jenkins và xác nhận rằng trạng thái hiển thị là Chạy và loại hình khởi nghiệp có nội dung như sau: Tự động. - Kiểm tra tài khoản đang sử dụng. Mở thuộc tính của Jenkins dịch vụ và đánh giá Log On tab. Nên sử dụng tài khoản dịch vụ chuyên dụng thay vì LocalSystem cho bất kỳ việc gì ngoài việc thử nghiệm cục bộ.
- Kiểm tra cổng lắng nghe. chạy
netstat -ano | findstr :8080Từ dấu nhắc lệnh. Một mục LISTENING xác nhận điều đó. Jenkins nắm giữ cảng. - Hãy đọc phần mô tả phiên bản. Đăng nhập tại
http://localhost:8080Và đọc số phiên bản ở góc dưới bên phải của bảng điều khiển. So sánh nó với phiên bản bạn đã tải xuống. - Khởi động lại một lần. Khởi động lại Windows và truy cập lại trang tổng quan mà không cần khởi động thủ công bất cứ thứ gì. Nếu trang tải được, dịch vụ này thực sự hoạt động tự động.
Dịch vụ cũng có thể được điều khiển từ cửa sổ Command Prompt với quyền quản trị viên, nhanh hơn so với giao diện đồ họa và hoạt động tốt bên trong các tập lệnh triển khai:
:: Stop, start, and query the Jenkins Windows service net stop "Jenkins" net start "Jenkins" sc query "Jenkins" :: Install Jenkins silently on a fleet of machines msiexec.exe /i "C:\installers\jenkins.msi" /qn /norestart ^ INSTALLDIR="D:\Jenkins" ^ PORT=8080 ^ /L*v "C:\logs\jenkins-install.txt"
💡 Mẹo: Trình cài đặt im lặng chấp nhận INSTALLDIR, PORT, JAVA_HOME, SERVICE_USERNAMEvà SERVICE_PASSWORD Như các thuộc tính ghi đè. Bất cứ thứ gì bạn không truyền vào sẽ quay trở lại giá trị mặc định của nó, và ở chế độ im lặng, dịch vụ chạy với quyền LocalSystem trừ khi một tài khoản dịch vụ được cung cấp.
Nếu bất kỳ bước kiểm tra nào trong số này thất bại, nguyên nhân thường có thể dự đoán được, như phần tiếp theo sẽ trình bày.
Chung Jenkins Lỗi cài đặt trên Windows và Cách Sửa Chữa Chúng
Thất bại nhiều nhất Windows cài đặt tracquay trở lại với một số nguyên nhân nhỏ: một sự không được hỗ trợ Java Lỗi có thể do quá trình chạy, cổng bị chiếm dụng hoặc tài khoản dịch vụ không có quyền đăng nhập với tư cách dịch vụ. Mỗi lỗi đều gây ra một triệu chứng riêng biệt, vì vậy việc khắc phục thường nhanh chóng sau khi đọc kỹ thông báo.
- Thông tin đăng nhập dịch vụ không hợp lệ: Trình cài đặt từ chối tài khoản trong quá trình... Chứng chỉ kiểm tra bước. Mở
secpol.msc, mở rộng Chính sách cục bộ > Phân quyền người dùng, mở Đăng nhập như một dịch vụvà thêm tài khoản. Sau đó thử lại kiểm tra thông tin đăng nhập. - Cổng 8080 hiện đang được sử dụng: Cổng kiểm tra Nút chuyển sang màu đỏ vì một ứng dụng khác, thường là Tomcat cục bộ hoặc máy chủ phát triển, đã chiếm giữ cổng đó. Hãy chọn một cổng trống như 8081, hoặc dừng tiến trình gây xung đột được xác định bởi nút đó.
netstat -ano. - Không được hỗ trợ hoặc bị thiếu Java: Trình cài đặt không thể điền trước Java thư mục chính, nếu không dịch vụ sẽ khởi động và dừng ngay lập tức. Cài đặt JDK 64-bit phiên bản 21 trở lên, sau đó trỏ trình cài đặt đến thư mục chính của nó.
- SmartScreen chặn trình cài đặt: Windows Báo cáo một ứng dụng không được nhận dạng. Chọn Thêm thông tinthì Chạy bất cứ đâusau khi xác nhận rằng tập tin đó đến từ nguồn chính thức. Jenkins trang tải về.
- Không tìm thấy tệp initialAdminPassword: Đã chọn thư mục cài đặt tùy chỉnh. Hãy xem bên trong thư mục đó.
secretsthư mục của thư mục đó, hoặc đọc mật khẩu từ jenkins.err.log trong Jenkins thư mục chính.
Một khi Jenkins Nếu hệ thống hoạt động ổn định, bước tiếp theo cần làm là kết nối nó với kho mã nguồn và quy trình xây dựng. Các hướng dẫn chi tiết sẽ được trình bày trong phần tiếp theo. Jenkins Tích hợp GitHub và Đường ống CI / CD Hãy giải thích cách thức tích hợp liên tục được xây dựng xung quanh hệ thống này.
