Piplin

Piplin -

Piplin(靈感來自於"pipeline"，讀作/ˈpɪpˌlɪn/ 或/ˈpaɪpˌlaɪn/)是一款免費、開源的持續整合與部署系統，適用於軟體的自動化建置、測試和部署相關的各種應用場景。

Piplin能做什麼？

• 支援PHP、Python、JAVA、Ruby等專案的建置、測試與發布
• 可與Gitlab、Github、Gogs、Gitee(Oschina)等程式碼託管平台進行集成
• 可靈活配置自訂建置和部署步驟
• 支援自訂構建物規則，對構建物建立發布版本並部署
• 支援專案的多環境部署(可自行建立開發、測試、預發布和生產等多個環境)
• 支援連動部署，例如：開發環境部署成功後可自動觸發測試環境啟動部署
• 服務管理支援機櫃功能，機櫃可與多個部署環境綁定
• 支援項目克隆功能
• 專案支援多成員
• 透過Websocket實現專案部署狀態的即時追蹤
• 支援釘釘機器人、Slack、郵件和自訂Webhook的服務集成

Piplin原理示意圖

整體

步驟命令

安裝環境要求

Piplin目前只支援類別Unix作業系統(如: Linux, Freebsd, Mac OS等)，為了能運行Piplin，您還需要安裝一些基礎軟體。

• Web伺服器: Nginx , Apache (with mod_rewrite)，or Lighttpd
• PHP 7.0+
• 資料庫: 推薦使用MySQL 或PostgreSQL。 SQLite也可運作。
• Composer
• Redis
• Node.js
• 隊列系統, 建議使用Beanstalkd或Redis。
• Supservisord, Piplin使用Supervisord進行背景處理程序管理。
• Rsync 如無特殊情況，一般系統都會自備rsync
• 快取服務: 推薦使用Memcached, 更多的快取方案選擇請看caching server.

Docker安裝，請造訪我們的Piplin Docker專案。

安裝手冊

全新安裝

一. 克隆程式碼

假設我們把Piplin安裝在/var/www 目錄下

$ cd /var/www
$ git clone https://github.com/Piplin/Piplin.git piplin

二. 安裝依賴套件

$ cd piplin
$ make

安裝過程如出現卡頓，請嘗試更換npm鏡像: npm config set registry http://registry.npm.taobao.org/

三. 安裝Piplin

$ make install

Piplin安裝器會進入一個互動式控制台，請依照提示進行相關參數設定。

四. 請將Web伺服器的根目錄指向public/ , 請參考examples/ 下的相關設定文件，裡麵包含Apache和Nginx的設定範例.

注意: examples/提供的只是範例，並不能保證直接拷貝就能使用，需要根據實際情況進行相關配置調整。

五. 配置supervisord

Piplin使用supervisord進行後台處理程序管理。此設定範例請查看examples/supervisor.conf。 一般supervisord的主設定檔在/etc/supervisor/supervisord.conf ，其大致內容：

 [unix_http_server]
file=/var/run/supervisor.sock   ; (the path to the socket file)
chmod=0700                       ; sockef file mode (default 0700)

......

[include]
files = /etc/supervisor/conf.d/*.conf

設定步驟如下：

1). 拷貝examples/supervisor.conf

$ cp examples/supervisor.conf /etc/supervisor/conf.d/piplin.conf
$ vi /etc/supervisor/conf.d/piplin.conf

請根據實際情況修改相關參數設置，尤其註意路徑相關的參數。

2). 重啟supervisord

$ /etc/init.d/supervisord restart 或 service supervisord restart

3). 檢查supervisord服務是否正常

$ supervisorctl

如果返回以下訊息，代表服務正常:

 piplin:queue_0                   RUNNING   pid 26981, uptime 2 days, 15:30:59
piplin:queue_1                   RUNNING   pid 26980, uptime 2 days, 15:30:59
piplin:queue_2                   RUNNING   pid 26979, uptime 2 days, 15:30:59
piplin-broadcast                 RUNNING   pid 26987, uptime 2 days, 15:30:59
piplin-socketio                  RUNNING   pid 26978, uptime 2 days, 15:30:59
supervisor>

六. 訪問Piplin

恭喜！您已完成Piplin的安裝。請透過瀏覽器存取安裝過程中設定的應用程式網址。

如果安裝完成之後修改了.env裡的設定訊息，請記得執行php artisan config:cache使其立即生效。

七. 設定計劃任務

規劃任務相關的設定請看examples/crontab.

Piplin的資料備份、專案Git倉庫自動鏡像等工作都依賴排程任務去實現。

升級

一. 取得最新代碼

$ git fetch --all
$ git checkout v1.0.2

二. 升級

$ make update

系統示範

體驗Piplin, 請造訪Piplin:

• 使用者名稱: piplin 或[email protected]
• 密碼: piplin

注意：系統每5分鐘會自動重設一次密碼，該帳號沒有權限存取管理功能.

幫助文檔

更多文件請造訪https://github.com/Piplin/Docs 或http://piplin.com/docs。

開發相關

Piplin程式碼裡已經自備編譯後的前端靜態資源，如果你不想修改前端樣式，可直接忽略本環節。

工具集：

• Node.js
• Webpack

npm install
npm run prod

鳴謝

• Laravel
• Bootstrap
• AdminLTE
• Envoy
• Forge
• Deployer
• socket.io
• ionicons

軟體授權協議

Piplin is licensed under The MIT License (MIT). Piplin is based on Deployer.