NGINX with an index.html (Ansible)

A playbook and Role to deploy NGINX, suitable for execution by AWX or the command-line.

This project contains one Ansible role:-

• nginx

Note: The Role is designed to be executed from within our AWX server where credentials for the cluster (Kubernetes) reside. If you're not running from AWX (discouraged) then you will need to provide values for the variables that would be injected by AWX.

As with all of our playbooks you can find the common user-defined variables in the role's defaults/main.yaml and less common variables in vars/main.yaml.

Development

Python dependencies are managed with uv. The pinned interpreter is in .python-version and all dependencies are declared in pyproject.toml. Create the environment and run the linter with: -

uv sync
uv run yamllint .

The playbook can be run from within the virtual environment with the following, where you will have to provide a suitable hostname for the webpage: -

uv run ansible-playbook site.yaml -e nx_hostname=example.com

You can disable SSL verification by setting the K8S_AUTH_VERIFY_SSL environment variable to 'no' before running the playbook.

---