Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/idealista/apache_httpd_role
Ansible role to install an Apache HTTP server
https://github.com/idealista/apache_httpd_role
ansible ansible-role apache-httpd debian
Last synced: about 2 months ago
JSON representation
Ansible role to install an Apache HTTP server
- Host: GitHub
- URL: https://github.com/idealista/apache_httpd_role
- Owner: idealista
- License: apache-2.0
- Created: 2017-11-02T10:50:33.000Z (over 7 years ago)
- Default Branch: develop
- Last Pushed: 2022-02-04T11:34:50.000Z (about 3 years ago)
- Last Synced: 2024-10-20T03:29:14.519Z (4 months ago)
- Topics: ansible, ansible-role, apache-httpd, debian
- Language: Jinja
- Homepage:
- Size: 254 KB
- Stars: 4
- Watchers: 25
- Forks: 4
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
[](https://travis-ci.com/idealista/apache_httpd_role)
# 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](#getting-started)
- [Prerequisities](#prerequisities)
- [Installing](#installing)
- [Usage](#usage)
- [Testing](#testing)
- [Built With](#built-with)
- [Versioning](#versioning)
- [Authors](#authors)
- [License](#license)
- [Contributing](#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](https://httpd.apache.org/) in a Debian system.
It used to have the option to install logrotate but It has been deprecated. To install logrotate you should use our [logrotate role](https://github.com/idealista/logrotate_role).
### Prerequisities
Ansible 5.2.0 version installed.
Inventory destination should be a Debian environment, Stretch, Buster and Bullseye are supported.
### Installing
Create or add to your roles dependency file (e.g requirements.yml):
``` yml
- src: idealista.apache_httpd_role
version: 3.2.0
name: apache_httpd
```
Install the role with ansible-galaxy command:
```
ansible-galaxy install -p roles -r requirements.yml -f
```
Use in a playbook:
``` yml
---
- hosts: someserver
roles:
- role: apache_httpd
```
## Usage
Look to the [defaults](defaults/main.yml) 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
### Install dependencies
```sh
$ pipenv sync
```
For more information read the [pipenv docs](pipenv-fork.readthedocs.io/en/latest/).
### Testing
```sh
$ pipenv run molecule test
```
## Built With
## Versioning
For the versions available, see the [tags on this repository](https://github.com/idealista/apache_httpd_role/tags).
Additionaly you can see what change in each version in the [CHANGELOG.md](CHANGELOG.md) file.
## Authors
* **Idealista** - *Work with* - [idealista](https://github.com/idealista)
See also the list of [contributors](https://github.com/idealista/apache_httpd_role/contributors) who participated in this project.
## License
This project is licensed under the [Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0) license - see the [LICENSE](LICENSE) file for details.
## Contributing
Please read [CONTRIBUTING.md](.github/CONTRIBUTING.md) for details on our code of conduct, and the process for submitting pull requests to us.