Deployer
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, (*1)
Features
Automatic deploy on push
Deploy any commit with one click
Releases history
Release re-deploy, (*2)
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, (*3)
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, (*4)
- 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., (*5)
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:, (*6)
- 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:, (*7)
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, (*8)
commands can be anything that's executable on your server, (*9)
sample deploy.neon file, (*10)
shared_folders:
- temp
- log
hooks:
after_receive:
- "composer install"
before_deploy:
- "php test.php"
after_deploy:
- "rm -rf temp/cache"
Wallogit.com
