Mina Nginx
Mina tasks for handle with Nginx.
This gem provides several mina tasks:
mina nginx:install # Install template config to host repo for easy overrides
mina nginx:setup # Install config file to the server's shared dir + symlink
mina nginx:print # Parse & print the nginx config
mina nginx:reload # Reload Nginx
mina nginx:restart # Restart Nginx
mina nginx:start # Start Nginx
mina nginx:status # Status Nginx
mina nginx:stop # Stop Nginx
Installation
Add this line to your application's Gemfile, then bundle install
:
gem 'mina-nginx', :require => false
Once installed, add this to your config/deploy.rb
file:
require 'mina/nginx'
Install the base template to your repo's lib/mina/templates
directory:
$ bundle exec mina nginx:install
Consider variables used by the nginx config, particularly:
-
application_name
- application name; defaults to 'application' -
nginx_socket_path
- path to socket file used in nginx upstream directive -
server_name
- application's nginx server_name (e.g. example.com); defaults to value fordomain
-
domain
- fqdn you are deploying to -
deploy_to
- deployment path -
current_path
- current revision path
Edit installed template as required.
Recommended Usage
- Follow install steps above; and
- Invoke
nginx:setup
in your mainsetup
task - Run
nginx:setup
(or basesetup
) to install config changes
n.b. if the config template has not been installed locally, mina-nginx
will
fall back to the default template gracefully.
Contributing
- Fork it ( http://github.com/hbin/mina-nginx/fork )
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create new Pull Request