httpd

Ansible role to setup the Apache HTTP server.

Currently only the package installation is tested and working properly.

The source installation currently has a problem when building the code.

Tests

Family	Distribution	Version	Test Status
Debian	Debian	Jessie
Debian	Debian	Wheezy
Debian	Ubuntu	Yakkety
Debian	Ubuntu	Xenial
Debian	Ubuntu	Wily
Debian	Ubuntu	Trusty
Debian	Ubuntu	Precise

Requirements

• ansible >= 2.0

Role Variables

• debug: flag to run debug tasks.
• httpd_conf: configuration settings for {{ httpd_dir_configuration }}/conf-{available|enabled}.
• httpd_configuration: contents of the {{ httpd_dir_configuration }}/httpd.conf file.
• httpd_default: contents of /etc/default/{{ httpd_service }}.
• httpd_dir_cache: directory for apache cache.
• httpd_dir_configuration: directory for apache configuration.
• httpd_dir_install: directory where apache will be installed.
• httpd_dir_lib: directory where apache modules are located.
• httpd_dir_lock: directory where apache....
• httpd_dir_run: directory where apache PID file will be stored.
• httpd_installation: the installation method: build or package.
• httpd_modules: list of apache modules.
• httpd_modules_dynamic: list of dynamically linked apache modules.
• httpd_modules_static: list of statically linked apache modules.
• httpd_ports: list of ports apache will be listening to.
• httpd_service: name of the service: apache2 for package installations; httpd otherwise.
• httpd_sites: list of available sites.
• httpd_user: user under which apache will be running.
• httpd_version: the apache version to be installed.

package

Variables specific to the package installation process.

• httpd_configuration_envvars: configuration for the /etc/apache2/envvars file.

build

Variables specific to the build installation process.

• httpd_build_dependencies: list of packages needed to build apache.
• httpd_build_options: option to be passed to configure.
• httpd_dir: symlink to the enabled apache installation.
• httpd_dir_source: directory where to build apache.
• httpd_env: environment variables.
• httpd_environment: apache environment.
• httpd_force_build: flag to indicate if a build is to be triggered no matter the server state.
• httpd_download_url: the URL for the tarball.
• httpd_download_url_asc: the URL for the tarball PGP signature.
• httpd_download_url_md5: the URL for the tarball MD5 checksum.
• httpd_mpm_module: the mpm apache module.
• httpd_pid_file: path to the apache PID file.
• httpd_tarball: filename of the tarball.

Dependencies

None.

Playbooks

- hosts: servers
  vars:
    see tests/vars/vagrant.yml

  roles:
     - role: ansiblebit.httpd

Tags

• configuration: configuration tasks.
• debug: task to debug role variables.
• installation: installation tasks.
• validation: task to validate role variables.

Test

To run the tests you will need to install:

• tox
• vagrant

To run all tests against all pre-defined OS/distributions * ansible versions:

$ tox

To run tests for trusty64:

$ cd tests
$ bash test_idempotence.sh --box trusty64.vagrant.dev
# log file will be stores under tests/log

To perform debugging on a specific environment:

$ cd tests
$ vagrant up trusty64.vagrant.dev

# to provision using the test.yml playbook (as many time as you need)
$ vagrant provision trusty64.vagrant.dev

# to access the Vagrant box
$ vagrant ssh trusty64.vagrant.dev

Links

• Apache > HTTP Server > Documentation
• Apache > HTTP Server > Documentation > Version 2.4 > Compiling and Installing
• Apache > HTTP Server > Documentation > Version 2.4 > Programs > configure - Configure the source tree
• Verifying Apache HTTP Server Releases