deployer/README.md

76 lines
2.7 KiB
Markdown
Raw Normal View History

2013-07-11 18:40:44 +04:00
Introduction
------------
[![Build Status](http://img.shields.io/travis/elfet/deployer.svg?style=flat)](https://travis-ci.org/elfet/deployer)
[![HHVM Tested](http://img.shields.io/hhvm/elfet/deployer.svg?style=flat)](http://hhvm.h4cc.de/package/elfet/deployer)
[![Code Quality](http://img.shields.io/scrutinizer/g/elfet/deployer.svg?style=flat)](https://scrutinizer-ci.com/g/elfet/deployer/?branch=develop)
2014-10-17 21:12:56 +04:00
[![Code Climate](http://img.shields.io/codeclimate/github/elfet/deployer.svg?style=flat)](https://codeclimate.com/github/elfet/deployer)
[![Code Coverage](http://img.shields.io/scrutinizer/coverage/g/elfet/deployer.svg?style=flat)](https://scrutinizer-ci.com/g/elfet/deployer/?branch=develop)
2014-10-17 16:49:52 +04:00
[![Version](http://img.shields.io/packagist/v/elfet/deployer.svg?style=flat)](https://packagist.org/packages/elfet/deployer)
2014-10-17 21:12:56 +04:00
[![Support via Gittip](http://img.shields.io/gittip/elfet.svg?style=flat)](https://www.gittip.com/elfet)
2013-07-13 14:33:11 +04:00
2014-10-17 16:56:26 +04:00
[![SensioLabsInsight](https://insight.sensiolabs.com/projects/69072898-df4a-4dee-ab05-c2ae83d6c469/big.png)](https://insight.sensiolabs.com/projects/69072898-df4a-4dee-ab05-c2ae83d6c469)
2014-08-13 13:21:13 +04:00
Deployer is a deployment tool written in PHP.
2013-07-13 14:33:11 +04:00
2014-08-13 13:21:13 +04:00
See [http://deployer.in](http://deployer.in) for more information and documentation.
2014-07-05 14:14:58 +04:00
2013-07-11 18:40:44 +04:00
Requirements
------------
* PHP 5.4.0 and up.
That all!
You can install [ssh2 extension](http://php.net/manual/en/book.ssh2.php) to speedup deployment process and enable [sockets](http://php.net/manual/en/book.sockets.php) for parallel deployment.
2013-07-11 18:40:44 +04:00
2014-08-13 13:21:13 +04:00
2013-07-11 18:40:44 +04:00
Installation
------------
2014-07-12 16:50:13 +04:00
To install Deployer download [deployer.phar](http://deployer.in/deployer.phar) archive and move deployer.phar to your bin directory and make it executable.
2014-07-05 13:51:56 +04:00
2014-07-12 16:50:13 +04:00
~~~
mv deployer.phar /usr/local/bin/dep
chmod +x /usr/local/bin/dep
~~~
To upgrade Deployer run command:
~~~
dep self-update
~~~
2014-07-05 13:51:56 +04:00
2014-07-12 16:50:13 +04:00
Or via composer:
2014-07-05 13:51:56 +04:00
2014-07-12 16:50:13 +04:00
~~~
2014-08-13 13:21:13 +04:00
composer require elfet/deployer:*
2014-07-12 16:50:13 +04:00
~~~
2014-07-05 13:51:56 +04:00
2014-08-13 13:21:13 +04:00
2014-07-05 13:51:56 +04:00
Documentation
-------------
2014-07-05 13:54:11 +04:00
Documentation can be found on site [deployer.in](http://deployer.in).
2014-07-05 13:51:56 +04:00
2014-08-13 13:21:13 +04:00
Building
--------
To build deployer.phar run `bin/build` command.
2014-08-14 12:59:57 +04:00
2014-08-13 13:21:13 +04:00
Contributing
------------
All code contributions must go through a pull request and approved by a core developer before being merged.
This is to ensure proper review of all the code.
Fork the project, create a feature branch, and send a pull request.
To ensure a consistent code base, you should make sure the code follows
the [PSR-1](https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-1-basic-coding-standard.md).
2014-08-13 13:21:13 +04:00
If you would like to help take a look at the [list of issues](https://github.com/elfet/deployer/issues).
2014-08-18 14:14:38 +04:00
To make a release update version number in `bin/dep` file. And run `./build -v=VERSION` command.
2014-08-13 13:21:13 +04:00
2013-07-11 19:00:21 +04:00
License
-------
2013-07-13 14:33:11 +04:00
Licensed under the MIT license: http://www.opensource.org/licenses/mit-license.php