0.0
The project is in a healthy, maintained state
Configuration and managements Mina tasks for Nginx.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.5
~> 0

Runtime

>= 0
 Project Readme

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 for domain
  • domain - fqdn you are deploying to
  • deploy_to - deployment path
  • current_path - current revision path

Edit installed template as required.

Recommended Usage

  1. Follow install steps above; and
  2. Invoke nginx:setup in your main setup task
  3. Run nginx:setup (or base setup) 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

  1. Fork it ( http://github.com/hbin/mina-nginx/fork )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request