silentteen

Jenkins 是一個開源的自動化服務器，可以自動完成定義的任務，在持續集成和持續交付（CI/CD）流程里被廣泛運用。

1. 離線部署Jenkins

1.1. 前期準備

• 下載Jenkins安裝包

從Jenkins官方下載頁面獲取適合的版本：Linux系統推薦下載.war文件

• 下載Java依賴包：Jenkins依賴JDK 8+，從Oracle官網或OpenJDK下載

*注：關注java版本與支持的jenkins的 版本對應關系 *

• 下載插件

提前從Jenkins插件市場下載所需插件（.hpi或.jpi文件）

1.2 安裝JDK（Linux）

• 解壓JDK

tar -zxvf jdk-xxxxx.tar.gz -C /usr/local/

• 配置環境變量

編輯/etc/profile，添加：

export JAVA_HOME=/usr/local/jdk-xxxxx
export PATH=$JAVA_HOME/bin:$PATH

• 使配置生效：

source /etc/profile

• 驗證安裝

java -version

1.3. 安裝Jenkins(WAR包方式)

• 上傳WAR包到服務器（如/opt/jenkins）

• 啟動命令：

java -jar /opt/jenkins/jenkins.war --httpPort=[portNum]

注：端口好自己設置，另外注意訪問ip限制，關注下文參數介紹中httpListenAddress參數。

• 后臺運行：

nohup java -jar /opt/jenkins/jenkins.war --httpPort=8080 &

1.4. 安裝插件

• 訪問Jenkins管理界面：http://your_server_ip:[portNum]

• 進入 管理Jenkins → 管理插件

• 點擊 高級 選項卡

• 在 上傳插件 部分選擇本地.hpi或.jpi文件上傳

1.5. 初始配置

• 獲取初始管理員密碼：

cat /var/lib/jenkins/secrets/initialAdminPassword

• 訪問Web界面，按向導完成用戶創建和基礎設置

• 如果要修改密碼，可以在登錄后點擊右上角的用戶->"configure"，然后進入頁面進行修改

2. Linux中Jenkins啟動參數配置

2.1. 命令行直接啟動參數

通過java -jar jenkins.war啟動時添加參數：

java -jar jenkins.war \
--httpPort=8080 \ # HTTP端口（默認8080）
--httpsPort=8443 \ # HTTPS端口
--httpListenAddress=0.0.0.0 \ # 監聽地址
--prefix=/jenkins \ # URL前綴
--logfile=/var/log/jenkins.log \ # 日志路徑
--webroot=/var/cache/jenkins \ # WAR解壓目錄
--ajp13Port=8009 \ # AJP端口（反向代理）

2.2. 系統服務配置參數

2.2.1 systemd服務（推薦）

• 編輯服務配置：

sudo vi /etc/systemd/system/jenkins.service

• 在[Service]部分添加環境變量：

[Service]
Environment="JENKINS_OPTS=--httpPort=8080 --prefix=/jenkins"
Environment="JAVA_OPTS=-Djava.awt.headless=true -Xmx512m"

• 重載并重啟：

sudo systemctl daemon-reload
sudo systemctl restart jenkins

2.3. 常用啟動參數列表

2.4. 高級參數配置

2.4.1 HTTPS配置

java -jar jenkins.war \
--httpsPort=8443 \
--httpsKeyStore=/path/to/keystore.jks \
--httpsKeyStorePassword=yourpassword

2.4.2 內存優化

JAVA_OPTS="-Xms512m -Xmx1024m -Djava.awt.headless=true"
java $JAVA_OPTS -jar jenkins.war

2.4.3 禁用CSRF保護（測試環境）

java -jar jenkins.war --disable-hudson.security.csrf.CrumbIssuer

2.5. 驗證參數生效

• 查看啟動日志：

sudo cat /var/log/jenkins/jenkins.log

• 檢查參數是否正確加載

3. 注意事項

• 端口沖突：確保端口未被占用（netstat -tulpn | grep 8080）

• 安全建議：

  • 生產環境強制使用HTTPS

  • 限制監聽地址為內網IP

• 性能優化：

  • 根據服務器資源調整JVM內存參數

  • 定期清理Jenkins工作目錄
    通過以上步驟，可完成Jenkins離線部署并靈活配置啟動參數。