Jenkins CLI，助你輕鬆管理 Jenkins

本文首發於：Jenkins 中文社區

做者：Donghui Wang

Jenkins CLI，簡稱 jcli，一個使用 Golang 開發的開源的 Jenkins 命令行工具。 它能夠幫忙你輕鬆地管理 Jenkins。 不管你是 Jenkins 插件開發者，仍是 Jenkins 管理員或者只是一個普通的 Jenkins 用戶，它都是爲你而生！

Jenkins CLI 功能簡介 

從2019年6月份第一個 git commit 算起，通過不斷迭代，截止目前 Jenkins CLI 已經對外發布了18個版本，下載量超過2000，功能也日益增多。 目前主要功能列表以下所示： * 支持多 Jenkins 實例管理 * 插件管理（查看列表、搜索、安裝、上傳） * 任務管理（搜索、構建觸發、日誌查看） * 在瀏覽器中打開你的 Jenkins * 重啓你的 Jenkins * 支持經過代理鏈接

此外，優秀的開源項目應該有着高代碼質量。Jenkins CLI 始終堅持內建質量的原則，在開發過程當中持續編寫單元測試代碼，並使用 TravisCI + SonarCloud 對代碼質量持續分析，從而保證代碼質量。 目前測試覆蓋率爲81.8%，下一個目標是將測試覆蓋率提高到90%。 Go Report Card 給 Jenkins CLI 的代碼質量評分爲 A+。

如何安裝 Jenkins CLI？ 

Jenkins CLI 目前支持的操做系統有：MacOS、Linux 以及 Windows。

在 Mac 上安裝

在 Mac 上能夠經過 brew 來安裝 jcli：

brew tap jenkins-zh/jcli
brew install jcli

在 Linux 上安裝

要在 Linux 操做系統上安裝 jcli 的話，很是簡單。 只須要執行下面的命令便可：

curl -L https://github.com/jenkins-zh/jenkins-cli/releases/latest/download/jcli-linux-amd64.tar.gz|tar xzv
sudo mv jcli /usr/local/bin/

在 Windows 上安裝

你只要點擊這裏就能夠下載到最新版本的壓縮包。而後，把解壓後的文件 jcli 拷貝到你的系統目錄下便可。

其餘包管理器

還可使用一些其餘的包管理器安裝 jcli： * GoFish 的用戶可使用命令 gofish install jcli 來安裝 * Scoop 的用戶可使用命令 scoop install jcli 來安裝

GoFish 同時支持 Linux 和 Windows，Scoop 支持 Windows。

使用入門 

安裝 jcli 後，你須要提供一份配置文件。請執行命令 jcli config generate，該命令會幫助你編輯配置文件 ~/.jenkins-cli.yaml，你須要根據實際的 Jenkins 配置狀況作相應的修改。

配置文件準備好後，即可以進行一些實際操做了。 下面舉幾個插件管理和任務管理的例子做爲說明。

插件管理

使用 jcli 搜索插件：

jcli plugin search zh-cn

使用 jcli 下載插件，若是該插件有相關依賴插件的話，會同時下載依賴插件：

jcli plugin downlaod localization-zh-cn

使用 jcli 安裝插件：

jcli plugin install localization-zh-cn

任務管理

使用 jcli 觸發構建：

jcli job build pipeline-01

使用 jcli 查看構建日誌，若是任務正在運行，它會實時監聽日誌輸出，不然輸出最近一次構建日誌：

jcli job log pipeline-01

更多命令請查看幫助

限於篇幅緣由，更多使用說明不作一一介紹，請查看幫助命令：

jcli --help
jcli <command> --help
jcli <command> <subcommand> --help

也能夠查看官方文檔： - https://github.com/jenkins-zh/jenkins-cli/blob/master/doc/README.md - https://jenkins-zh.github.io/jcli-docs/

若是你有意願使用 Jenkins CLI，那麼趕快動手來體驗吧！

新功能路線圖 

Jenkins CLI 仍舊在不斷髮展中。 挑選了幾個計劃中的新功能，列表以下： - 支持自我升級 - 支持列出全部 agent 節點 - 支持更新全部插件 - 支持展現插件趨勢

若是你有但願開發的新功能，請提交 issue 到 GitHub 倉庫。

歡迎反饋與貢獻 

若是你在使用過程當中遇到問題，歡迎在 GitHub 倉庫提交 issue 來反饋； 同時，咱們也很是歡迎貢獻者對 Jenkins CLI 貢獻本身的一份力量。 目前除了國內的主要貢獻者： - LinuxSuRen - yJunS

還有來自其餘國家或地區的貢獻者爲 Jenkins CLI 作出過貢獻，他們是： - zirmax - scottydocs - sbcd90 - oleg-nenashev

不管是小到一個錯別字的修改，大到一個新的功能的開發，或者是在使用過程當中提交 issue 反饋，它們對 Jenkins CLI 發展而言都有着重要的意義。

Jenkins CLI 期待你的投票 

2019 年的中國開源界，開源項目的數量也在激增。 做爲中國開源界的一份子，此時此刻，Jenkins CLI 正在參加由 OSCHINA（開源中國）主辦的2019年度最受歡迎中國開源軟件評選活動。

懇請佔用你的一點寶貴時間，麻煩動動手指爲 Jenkins CLI 投上支持的一票，不勝感激！

投票方式：長按圖片，識別圖中二維碼，打開投票活動頁面，找到開發工具類-->Jenkins CLI，點擊投票，再次感謝支持 Jenkins CLI ！

</subcommand>