nginxinator

Opinionatedly Deploy Nginx instances.

This is a Capistrano 3.x plugin, and relies on SSH access with passwordless sudo rights, as well as Docker installed on the hosts.

You need to manually verify you are not attempting to setup more than one instance on the same port for a paricular domain (host), although Docker will simply error and tell you the port is already assigned.

• gem install nginxinator (Or add it to your Gemfile and bundle install.)
• Add "require 'nginxinator'" to your Capfile echo "require 'nginxinator'" >> Capfile
• Create example configs: cap nginx:write_example_configs
• Turn them into real configs by removing the _example portions of their names, and adjusting their content to fit your needs. (Later when you upgrade to a newer version of nginxinator, you can nginx:write_example_configs again and diff your current configs against the new configs to see what you need to add.)
• You can add any custom Nginx setting you need by adjusting the content of the ERB templates. You won't need to change them to get started, except for adding a valid SSL cert/key set.
• You can later update a template (Nginx config) and run cap <stage> nginx:setup again to update the config file and restart the instance.

cap -T will help remind you of the available commands, see this for more details.

• After setting up your nginxinator.rb config file during installation, simply run: cap <stage> nginx:setup
• Run cap <stage> nginx:setup again to see it find everything is already setup, and do nothing.
• Run cap <stage> nginx:status to see the status of the instance.
• An example Dockerfile is provided

• You can add the --trace option at the end of a command to see when which tasks are invoked, and when which task is actually executed.
• If you want to put on your DevOps hat, you can run cap -T -A to see each individually available task, and run them one at a time to debug each one.

• Rename log files to contain "nginx-"
• Create force restart to remove and restart container
• Change the default nginx.conf.erb to use try_files instead of (-f ) https://www.nginx.com/resources/wiki/start/topics/tutorials/config_pitfalls/#check-if-file-exists
• Add a 'non-interactive=true' switch to all interactive questions
• Use a lock file to auto-detect when docker run commands have changed, - and recreate containers instead of restarting them.