handlers | ||
meta | ||
tasks | ||
templates | ||
vars | ||
README.md |
Ansible Role: Apache 2.x
An Ansible Role that installs Apache 2.x on RHEL/CentOS 6.x.
Requirements
None.
Role Variables
Available variables are listed below, along with default values (see vars/main.yml
):
apache_enablerepo: ""
The repository to use when installing Apache. If you'd like later versions of Apache than are available in the OS's core repositories, use a repository like EPEL (which can be installed with the geerlingguy.repo-epel
role).
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
None.
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"}
TODO
- Use
lineinfile
rather than monolithic httpd.conf template. - Conditionally configure Apache for Ubuntu as well (one role to rule them all).
License
MIT / BSD
Author Information
This role was created in 2014 by Jeff Geerling, author of Ansible for DevOps.
This role was created in 2014 by Jeff Geerling, author of Ansible for DevOps.