buluma.httpd

Ansible Role httpd

This role helps you install and set up httpd on your system.

GitHub	Version	Issues	Pull Requests	Downloads

Example Playbook

Here is an example playbook from molecule/default/converge.yml that is tested with each code change.

---
- name: Converge
  hosts: all
  become: true
  gather_facts: true

  vars_files:
    - ../../vars/main.yml
    - ../../defaults/main.yml

  pre_tasks:
    - name: Update apt cache.
      apt: update_cache=true cache_valid_time=600
      when: ansible_os_family == 'Debian'

  roles:
    - role: buluma.httpd
      # https_ssl_enable: true
      httpd_port: 8080
      httpd_ssl_port: 8443
      httpd_locations:
        - name: my_location
          location: /my_location
          backend_url: "http://localhost:8080/myapplication"
      httpd_directories:
        - name: my_directory
          path: "{{ httpd_data_directory }}/my_directory"
          allow_override: All

Make sure your machine is ready. In CI, this is done with molecule/default/prepare.yml:

---
- name: Prepare
  hosts: all
  become: true
  gather_facts: false

  roles:
    - role: buluma.bootstrap
    - role: buluma.epel
    - role: buluma.buildtools
    - role: buluma.python_pip
    - role: buluma.openssl
      openssl_items:
        - name: apache-httpd
          common_name: "{{ ansible_fqdn }}"

You can also see a full explanation and example of how to use these roles.

Role Variables

Default values for the variables can be found in defaults/main.yml:

---
# defaults file for httpd

httpd_servername: "{{ ansible_fqdn }}"
httpd_port: 80
https_ssl_enable: false
httpd_ssl_servername: "{{ ansible_fqdn }}"
httpd_ssl_port: 443
httpd_openssl_crt: "{{ httpd_openssl_crt_directory }}/apache-httpd.crt"
httpd_openssl_key: "{{ httpd_openssl_key_directory }}/apache-httpd.key"
httpd_remove_example: false
httpd_additional_modules: []
httpd_custom_modules_to_activate_with_command: []
apache_global_vhost_settings: |
  DirectoryIndex index.php index.html
vhost_conf_template: vhost.conf.j2
default_vhost_conf: default_vhost.conf