mirror of
https://github.com/kevinveenbirkenbach/computer-playbook.git
synced 2024-12-22 18:35:03 +01:00
.. | ||
meta | ||
tasks | ||
README.md |
Nginx Homepage Role
This Ansible role configures an Nginx server to serve a static homepage. It handles domain configuration, SSL certificate retrieval with Let's Encrypt, and cloning the homepage content from a Git repository.
Requirements
- Ansible 2.9 or higher
- Nginx installed on the target machine
- Git installed on the target machine (if cloning a repo)
nginx-https
andgit
roles available or configured if they are used as dependencies
Role Variables
nginx_homepage_root
: The directory where the homepage content will be stored (default:/usr/share/nginx/homepage
)domain
: The domain name for the Nginx server configurationadministrator_email
: The email used for SSL certificate registration with Let's Encryptnginx_homepage_repository_address
: The Git repository address containing the homepage content
Dependencies
nginx-https
: A role for setting up an HTTPS servergit
: A role for installing Git
Example Playbook
- hosts: servers
roles:
- { role: nginx-homepage, domain: 'example.com', administrator_email: 'admin@example.com' }
Author Information
This role was created in 2023 by Kevin Veen Birkenbach.