No description
Find a file
2014-04-21 12:59:08 -05:00
handlers Add handlers, meta info, tasks, templates, and vars. 2014-02-28 16:23:24 -06:00
meta Remove EPEL repository dependency. 2014-03-14 11:28:08 -05:00
tasks Remove EPEL repository dependency. 2014-03-14 11:28:08 -05:00
templates Add handlers, meta info, tasks, templates, and vars. 2014-02-28 16:23:24 -06:00
vars Remove EPEL repository dependency. 2014-03-14 11:28:08 -05:00
README.md Updated README. 2014-04-21 12:59:08 -05:00

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.