Install NGINX Management Suite with Ansible
This guide shows you how to install NGINX Management Suite using the open-source Ansible role. Easily reproduce your installation across multiple environments through automation.
Open-Source Project on GitHub
The steps in this guide refer to the Ansible NGINX Management Suite Role project on GitHub.
The Ansible role for NGINX Management Suite simplifies the installation process by installing all the prerequisites and any modules you specify.
- To view the Ansible role requirements, click here.
Install the Ansible role by using an Ansible Galaxy requirements file. Follow the installation steps here.
Next, run the Ansible playbook. Create a file named
nms-playbook.yml(or any other name) with contents similar to the following example:
- hosts: nms become: yes vars: nginx_license: certificate: ./nginx-repo.crt key: ./nginx-repo.key nms_setup: install nms_modules: - name: acm - name: adm - name: sm collections: - nginxinc.nginx_core roles: - nginxinc.nginx_management_suite
Create an Ansible hosts file containing the hosts you want in the group listed in your playbook.
Run the playbook:
ansible-playbook -i <path-to-your-hostfile> nms-playbook.yml
For a comprehensive list of configuration options, click here.
If you need assistance or have questions, you can find support from the NGINX Management Suite Ansible Role Project on GitHub.