From 9a884c9146721072ea9fcd0e7d04a5825c91cbbe Mon Sep 17 00:00:00 2001 From: Jeff Geerling Date: Fri, 28 Feb 2014 16:22:50 -0600 Subject: [PATCH] Added README.md. --- README.md | 49 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 49 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..699d7e1 --- /dev/null +++ b/README.md @@ -0,0 +1,49 @@ +# Role Name + +Apache 2.x for RHEL/CentOS 6.x by geerlingguy. + +## Requirements + +None. + +## Role Variables + +Available variables are listed below, along with the default value (see `vars/main.yml`): + + apache_listen_port: 80 + +The port on which apache should be listening. Useful if you have another service (like a reverse proxy) listening on port 80. + + apache_vhosts: + # Additional optional properties: 'serveradmin, extra_parameters'. + - {servername: "local.dev", documentroot: "/var/www/html"} + +Add a set of properties per virtualhost, including `servername` (required), `documentroot` (required), `serveradmin` (optional: the admin email address for this server), and `extra_parameters` (you can add whatever you'd like in here). + +Note that this role doesn't configure SSL support out of the box; you would need to add in additional tasks to listen on port 443 and add your own VirtualHost directives for SSL. This may be improved in the future :) + +## Dependencies + + - geerlingguy.repo-epel (Installs the EPEL repository for CentOS 6.x). + +## Example Playbook + + - hosts: webservers + vars_files: + - vars/main.yml + roles: + - { role: geerlingguy.apache } + +*Inside `vars/main.yml`*: + + apache_listen_port: 8080 + apache_vhosts: + - {servername: "example.com", documentroot: "/var/www/vhosts/example_com"} + +## License + +MIT / BSD + +## Author Information + +This role was created in 2014 by Jeff Geerling (@geerlingguy), author of Ansible for DevOps. You can find out more about the book at http://ansiblefordevops.com/, and learn about the author at http://jeffgeerling.com/.