文章目錄
jenkins 是一由 Java 編寫的開源的持續集成工具,它可以直接運行在 Servlet 容器中(如 Apache Tomcat)。
jenkins 功能非常強大,提供了超過 1000 個插件來支持構建、部署、自動化,幾乎可以 滿足任何項目的需要,被廣泛用於各大企業的軟件開發過程中。
一、Windows 下安裝
1、java 命令運行 WAR 文件
Windows 下直接使用 jenkins.war
在 java 環境中安裝即可。
- 首先下載
jenkins.war
到本地目錄中(下載地址 http://mirrors.jenkins.io/war-stable/latest/jenkins.war); - 打開 cmd 命令行窗口進入下載目錄;
- 運行命令:
java -jar jenkins.war
,當出現Finished Download metadata....
說明安裝成功; - 瀏覽器打開
http://localhost:8080
,即可進入 jenkins 初始化頁面,後面的按提示操作輸入解鎖密碼、選擇插件等; - 需要注意的是,命令行窗口不能關閉,否則 jenkins 服務也就停止了。
關於端口號:
默認啓動後是 8080 端口,也可以在啓動時指定端口號,如:
java -jar jenkins.war --httpPort=8888
然後在瀏覽器中使用 http://localhost:8888
訪問。
2、tomcat 容器運行 war 文件
jenkins 也可以通過 tomcat 等 servlet 容器來運行。
- 直接把
jenkins.war
放在 tomcat 的 webapps 目錄下;
- 然後在 tomcat bin 目錄下運行 startup.bat ,等待運行完畢,即可啓動 jenkins;
- 瀏覽器輸入
http://localhost:8080/jenkins
,即可進入 jenkins 初始化頁面,後面的按提示操作輸入解鎖密碼、選擇插件等; - 同樣的,tomcat 窗口不能關閉,否則 jenkins 服務也就停止了。
3、配置文件
jenkins 安裝後默認在用戶目錄下創建一個 .jenkins
文件夾,存儲安裝、配置、插件等信息。比如我的目錄是 C:\Users\Administrator\.jenkins
。
初始解鎖密碼:
首次啓動 jenkins 時會要求輸入解鎖密碼,就位於安裝目錄下C:\Users\Administrator\.jenkins\secretsinitialAdminPassword
文件中,當解鎖通過後該文件會自動刪除。
用戶信息配置:
C:\Users\Administrator\.jenkins\users
目錄下保存了所有的用戶,包括登錄密碼、權限信息等。
二、Linux 下安裝
jenkins 在 linux 下的安裝方式比較多,可以使用 windows 下 war 包的安裝方法,也可以使用 rpm 包手動安裝,或者使用 yum 安裝等。
1、java 命令運行 WAR 文件
跟 windows 下的安裝方式一樣。
2、tomcat 容器運行 war 文件
跟 windows 下的安裝方式一樣。
3、rpm 工具安裝
3.1 安裝步驟
- 先到官網下載 rpm 包:https://pkg.jenkins.io/redhat-stable/ ,並上傳到 linux 目錄(如 /opt 目錄);
- 這一條命令即可安裝完成:
rpm -ivh jenkins-xxxx.noarch.rpm
; - 啓動 jenkins:
service jenkins start
(這一步如果報錯找不到 java....
,需要修改 jenkins 配置,具體參考===); - 瀏覽器訪問 jenkins:
http://ip:8080
(ip 是你自己 linux 服務器的 ip);
3.2 修改端口號和啓動用戶
jenkins 默認端口號是 8080,正好跟 tomcat 端口號衝突,所以最好在安裝好後自定義一個端口號。
jenkins 默認會使用 jenkins
用戶來啓動,後續使用過程中可能會因爲權限不足而報錯,所以最好在一開始就切換成 root
用戶(當然,也可以改成其他用戶)。
端口號和啓動用戶的修改都是在同一個配置文件中。
查看默認安裝目錄:rpm -ql jenkins
$ rpm -ql jenkins
/etc/init.d/jenkins
/etc/logrotate.d/jenkins
/etc/sysconfig/jenkins
/usr/lib/jenkins
/usr/lib/jenkins/jenkins.war
/usr/sbin/rcjenkins
/var/cache/jenkins
/var/lib/jenkins
/var/log/jenkins
修改 /etc/sysconfig/jenkins
:
vim /etc/sysconfig/jenkins
......
JENKINS_USER="jenkins" ===找到這裏,把 jenkins 改成 root
......
JENKINS_PORT="8080" ===找到這裏,把 8080 改成其它值,如 8088、7088等等
修改並保存後,重啓 jenkins:service jenkins restart
3.3 修改默認安裝目錄
rpm 工具安裝後,jenkins 默認的安裝目錄是 /var/lib/jenkins
,如果想要修改成自己的目錄,也可以在 /etc/sysconfig/jenkins
文件中修改。
這裏根據自身需要修改,非必須的!
修改 /etc/sysconfig/jenkins
:
vim /etc/sysconfig/jenkins
......
JENKINS_HOME="/var/lib/jenkins" ===默認是這個目錄,改成自己的目錄,如 "/data/mywork/jenkins"
......
同時,要轉移原 JENKINS_HOME
目錄下的文件到新目錄下:
cp -r /var/lib/jenkins/* /data/mywork/jenkins/
修改並保存後,重啓 jenkins:service jenkins restart
4、yum 安裝
在 Centos 系統中,如果能聯外網的話,還可以使用 yum 工具來聯網下載並安裝 jenkins。
4.1 添加 yum 源
默認情況下,yum 源中不包含 jenkins,所以要先在 yum 源中添加 jenkins:
sudo wget -O /etc/yum.repos.d/jenkins.repo https://pkg.jenkins.io/redhat-stable/jenkins.repo
sudo rpm --import https://pkg.jenkins.io/redhat-stable/jenkins.io.key
# 如果之前已經導入過 jenkin.io.key,那麼這一步會報錯,可以忽略,繼續執行就可以。
4.2 yum 安裝 jenkins
yum install jenkins
執行這一條命令即可,就是這麼簡單!
至於其它的個性化配置,如個性端口號、啓動用戶等,參考上面 rpm 安裝的部分,方法是一樣的。
5、卸載
如果你是個完全的新手,那麼不管別人的步驟說的再詳細,你可能還是會操作的亂七八糟,配置文件改亂了之後,對於新手來說最好就是卸載重裝。
根據不同的安裝方式,對應的卸載方式也會稍有不同,但是一定要保證卸載乾淨了,不然下次重裝還是會有問題!
5.1 windows 下卸載
直接去手動刪除 jenkins 的安裝目錄,最好再全局搜索一下是否還有 jenkins 相關的文件,也一併刪除。
5.2 rpm 工具卸載
如果是 rpm 工具安裝的,可以直接執行 rpm -e jenkins
命令來卸載。
檢查一下是否卸載成功:rpm -ql jenkins
,如果沒有查出信息則卸載成功了。
但是這時還沒完,可能還是有一些殘留文件藏在其它地方,執行下面命令徹底刪除殘留文件:
find / -iname jenkins | xargs -n 1000 rm -rf
注意:這一步一定要進行,不然各種問題。
5.3 yum 工具卸載
如果是 yum 安裝的,可以直接執行 yum remove jenkins
命令來卸載。
同樣的,也要記得徹底刪除殘留文件:
find / -iname jenkins | xargs -n 1000 rm -rf
三、安裝插件
1、 jenkins 推薦
在我們首次訪問 jenkins 主頁時,就會提示安裝插件,這時按推薦的安裝就好(需要聯網才行)。
2、插件管理器
我們後面在使用過程中,肯定還需要別的插件,這時可以通過 jenkins 頁面上 系統管理--管理插件
這裏來安裝。
但是如果你是公司內網的話,jenkins 在
如果下載安裝報錯時,可以嘗試更新插件源,“高級–升級站點”,如http://mirrors.jenkins-ci.org/status.html
安裝完成之後重啓jenkins即可
沒外網:
先用有外網的電腦下載所需插件
https://plugins.jenkins.io/
當然,前提是你要知道插件的名稱或部分名稱,才能查找到匹配的。
然後把下載的插件包拷貝到jenkins安裝目錄下的plugins文件夾下
之後重啓jenkins即可