rocketeers/satellite

An on-server assistant for Rocketeer

Satellite

Satellite is an on-server assistant for Rocketeer. It allows you to integrate Rocketeer into your CI process by creating/updating releases from the server itself, and to virtually deploy from anywhere., _(*1)

Setup

Via the global PHAR

Simply run the following commands on your server:, _(*2)

$ wget http://rocketeer.autopergamene.eu/versions/satellite.phar
$ chmod +x satellite.phar
$ mv satellite.phar /usr/local/bin/satellite

Via Composer

Simply run composer global require rocketeers/satellite, you'll then have a ~/.composer/vendor/bin/satellite vendor on your server you can access., _(*3)

Usage

Once you have Satellite on your server, you'll need to set it up, only the first time, by running satellite setup., _(*4)

After that, to see which applications are deployed on a particular server, run satellite apps:, _(*5)

+---------------+--------------------+---------------------+
| Application   | Number of releases | Latest release      |
+---------------+--------------------+---------------------+
| foobar        | 3                  | 2015-01-19 17:57:36 |
+---------------+--------------------+---------------------+

To create a new release of an application on your server, run satellite deploy {your_app}. This can be called from an SCM hook, a PaaS deploy routine, etc., _(*6)

To follow the deployment from your local application, first install the satellite plugin in your local application by running:, _(*7)

$ rocketeer plugin:install rocketeers/satellite

Then add Satellite to your plugins in config.php:, _(*8)

// The plugins to load
'plugins'          => array(
    'Rocketeer\Satellite\SatellitePlugin',
),

You'll then have a tail command available:, _(*9)

$ rocketeer satellite:tail

Which will print the progress of the deploy as it runs., _(*10)