Project

mina-nginx

0.03
No commit activity in last 3 years
No release in over 3 years
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

~> 1
 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 - 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