lakshmitalari/apache_httpd-role

Ansible role to install an Apache HTTP server

Apache HTTP Server Ansible role

This Ansible role installs an Apache HTTP server in a Debian environment. The server is installed using the sources and loading just the predefined modules.

• Getting Started
  • Prerequisities
  • Installing
• Usage
• Testing
• Built With
• Versioning
• Authors
• License
• Contributing

Getting Started

These instructions will get you a copy of the role for your Ansible playbook. Once launched, it will install a Apache HTTP Server in a Debian system.

Prerequisities

Ansible 2.2.1.0 version installed. Inventory destination should be a Debian environment.

For testing purposes, Molecule (version 1.25) with Vagrant as driver (with landrush plugin) and VirtualBox or Docker as provider.

Installing

Create or add to your roles dependency file (e.g requirements.yml):

- src: idealista.apache_httpd-role
  version: 1.0.0
  name: apache_httpd

Install the role with ansible-galaxy command:

ansible-galaxy install -p roles -r requirements.yml -f

Use in a playbook:

---
- hosts: someserver
  roles:
    - role: apache_httpd

Usage

Look to the defaults properties file to see the possible configuration properties.

Bear in mind that the role deploys the default Apache httdp config file. If you want to use yours (something that we strongly recommend), place it under the directory referred by the variable apache_extra_conf_template_path. If you need any inspiration, a good template to start with could be the one in tests/templates/apache/conf/httpd.conf.j2.

Testing

Using Vagrant as provider

molecule test

Using Docker as provider

molecule test --driver docker

See molecule.yml to check possible testing platforms. As a reminder, our tests are just compatible with Molecule 1.x

Built With

Versioning

For the versions available, see the tags on this repository.

Additionaly you can see what change in each version in the CHANGELOG.md file.

Authors

• Idealista - Work with - idealista

See also the list of contributors who participated in this project.

License

This project is licensed under the Apache 2.0 license - see the LICENSE file for details.

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.