Piplin Download - Piplin Source code download

Piplin

Other categories

v1.0.2

Download

Piplin -

Piplin (inspired by "pipeline", pronounced /ˈpɪpˌlɪn/ or /ˈpaɪpˌlaɪn/) is a free, open source continuous integration and deployment system suitable for various application scenarios related to automated software building, testing and deployment.

What can Piplin do?

Support the construction, testing and release of PHP, Python, JAVA, Ruby and other projects
Can be integrated with code hosting platforms such as Gitlab, Github, Gogs, Gitee (Oschina), etc.
Flexible configuration of custom build and deployment steps
Support custom construction rules, create release versions of constructions and deploy them
Supports multi-environment deployment of projects (you can establish multiple environments such as development, testing, pre-release and production by yourself)
Supports linked deployment, for example: after the development environment is successfully deployed, the test environment can be automatically triggered to start deployment.
Service management supports the cabinet function, and the cabinet can be bound to multiple deployment environments
Support project cloning function
Project supports multiple members
Real-time tracking of project deployment status through Websocket
Supports service integration of DingTalk robot, Slack, email and custom webhook

Schematic diagram of Piplin principle

overall

step command

Installation environment requirements

Piplin currently only supports Unix-like operating systems (such as: Linux, Freebsd, Mac OS, etc.). In order to run Piplin, you also need to install some basic software.

Web server: Nginx , Apache (with mod_rewrite), or Lighttpd
PHP 7.0+
Database: MySQL or PostgreSQL is recommended. SQLite also works.
Composer
Redis
Node.js
Queue system, it is recommended to use Beanstalkd or Redis.
Supervisord, Piplin uses Supervisord for background process management.
Rsync Unless there are special circumstances, most systems will come with rsync.
Caching service: It is recommended to use Memcached. For more caching solution options, please see caching server.

For Docker installation, please visit our Piplin Docker project.

Installation manual

fresh install

1. Clone the code

Assume we install Piplin in the /var/www directory

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

2. Install dependency packages

$ cd piplin
$ make

If there is a lag during the installation process, please try to change the npm image: npm config set registry http://registry.npm.taobao.org/

3. Install Piplin

$ make install

The Piplin installer will enter an interactive console. Please follow the prompts to set relevant parameters.

4. Please point the root directory of the web server to `public/` . Please refer to the relevant configuration files under examples/, which contains configuration examples for Apache and Nginx.

Note: examples/ provides only examples and does not guarantee that direct copying can be used. Relevant configuration adjustments need to be made according to the actual situation.

5. Configure supervisord

Piplin uses supervisord for background process management. Please see examples/supervisor.conf for this configuration example. Generally, the main configuration file of supervisord is in /etc/supervisor/supervisord.conf , and its general content is:

 [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

The configuration steps are as follows:

1). Copy examples/supervisor.conf

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

Please modify relevant parameter settings according to the actual situation, paying special attention to path-related parameters.

2). Restart supervisord

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

3). Check whether the supervisord service is normal

$ supervisorctl

If the following information is returned, it means the service is normal:

 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>

6. Visit Piplin

Congratulations! You have completed the installation of Piplin. Please use your browser to access the app URL set during installation.

If you modify the configuration information in .env after the installation is complete, remember to execute php artisan config:cache to make it take effect immediately.

7. Set scheduled tasks

For settings related to scheduled tasks, please see examples/crontab.

Piplin's data backup, project Git warehouse automatic mirroring and other tasks rely on scheduled tasks to be implemented.

upgrade

1. Get the latest code

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

2. Upgrade

$ make update

System demonstration

To experience Piplin, please visit Piplin:

Username: piplin or [email protected]
Password: piplin

Note: The system will automatically reset the password every 5 minutes. This account does not have permission to access management functions.

Help documentation

For more documentation, please visit https://github.com/Piplin/Docs or http://piplin.com/docs.

development related

Piplin code already comes with compiled front-end static resources. If you don’t want to modify the front-end style, you can directly ignore this link.

Toolset: