README

What is it

Deployer is a paas style deployment application(like pagodabox or appfog). It is intended for deployment of web applications on private vps servers

Features

Automatic deploy on push Deploy any commit with one click Releases history Release re-deploy

Todo

rollback to previous release
private keys controlled deploy access

Prerequisites

mongodb
redis
php 5.4
git

Make sure your systems meets Nette Framework requirements: http://doc.nette.org/en/requirements

Installation

copy the application to the desired location
run composer install
run cli app:install - this will create the database and collections, default name is deployer
run user:create to create your first app user

if you wish to deploy from the application gui, you will need to run a WAMP server and deploy worker script

php wamp/server.php
php workers/deployWorker.php

I suggest using supervisord to run these two processes in background. You can run as many deploy workers as you want, if you need to deploy multiple applications at once. Only deploy of the same application can be run at one time. Automatic deploys do not use the deploy worker but are executed as post receive hook, in git process.

Deploying applications

Add a new application by clicking the Add application button in navbar Select a name and submit - Deployer will create a local bare git repository for you to push to Go to application settings and set the root folder for your application This folder will contain three subfolders:

releases - holds all releases
live - the folder to which you should point your webserver at, it's symlinked to the current release
shared - contains folders that are shared between releases, commonly log and temp folders, uploads etc...

Customizing the deploy process

You can customize the deploy process by adding a deploy.neon file to the root fodler of your application The file has two sections:

shared_folders - list of folders you want to share between releases hooks - commands executed at various stages of deployment:

after_receive - executed just after the pushed code has been checked out, great for running composer install
before_deploy - executed after the files were copied to the releases folder, before symlinking live folder
after deploy - after symlinking the live folder to the release folder

commands can be anything that's executable on your server

sample deploy.neon file

shared_folders:
	- temp
	- log
hooks:
	after_receive:
		- "composer install"
	before_deploy:
		- "php test.php"
	after_deploy:
		- "rm -rf temp/cache"

bazo / app-deployer

Maintainers

Details