clojure-uberjar-webapp-nginx
Role Name
This role configures an nginx server to reverse-proxy an application server. It has ssl and no-ssl nginx configs.
See https://github.com/sweet-tooth-clojure/ansible-roles for a quick overview and instructions. See Deploying Your First Clojure App ...From the Shadows for an introductory guide to Ansible and in-depth explanation of this role.
Requirements
None
Role Variables
I tried to take care to parameterize as much as I could, but to define
defaults such that you're only required to define a couple vars for
everything to work. If you define clojure_uberjar_webapp_app_name,
then flyingmachine.clojure-uberjar-webapp-common will define
clojure_uberjar_webapp_app_name, which is used by most of the vars velow.
For example, if your domain is foo.bar.com, the app name will be
foo-bar-com. Your app's site config will be upload to
/etc/nginx/sites_available/foo-bar-com.conf, and you'll find logs
under /var/log/nginx/foo-bar-com.access.log. I find that this
consistency makes it easier to navigate the filesystem.
There are some references to datomic vars, but those are optional. I hope to improve the roles such that this role contains no references to datomic.
| Variable | Description |
|---|---|
clojure_uberjar_webapp_nginx_dir |
Directory containing nginx configs |
clojure_uberjar_webapp_nginx_server_name |
Used to set server_name in the nginx site config; defaults to clojure_uberjar_webapp_domain |
clojure_uberjar_webapp_nginx_upstream_name |
Name within config to refer to the java app upstream |
clojure_uberjar_webapp_nginx_sites_available |
path to nginx's sites_available directory; mainly there for DRYness |
clojure_uberjar_webapp_nginx_sites_enabled |
path to nginx's sites_enabled directory; mainly there for DRYness |
clojure_uberjar_webapp_nginx_static_location |
URL base for serving static files. e.g. http://foo.com/static/logo.png should serve a static file |
clojure_uberjar_webapp_nginx_static_alias |
where to look on server filesystem for static files |
clojure_uberjar_webapp_nginx_use_ssl |
Set to True to use ssl |
clojure_uberjar_webapp_nginx_letsencrypt_dir |
where letsencrypt files live |
clojure_uberjar_webapp_nginx_additional_config |
gets appended to end of site's nginx config file |
Dependencies
Example Playbook
---
- hosts: webservers
become: true
become_method: sudo
roles:
- "sweet-tooth-clojure.clojure-uberjar-webapp-common"
- "sweet-tooth-clojure.clojure-uberjar-webapp-nginx"
- "sweet-tooth-clojure.clojure-uberjar-webapp-datomic-free"
- "sweet-tooth-clojure.clojure-uberjar-webapp-app"
License
MIT
Author Information
Daniel Higginbotham
ansible-galaxy install sweet-tooth-clojure/ansible-role-clojure-uberjar-webapp-nginx