NGINX.COM

Official Ansible Roles for NGINX and NGINX Plus Out Now

Editor – The separate Ansible roles for open source NGINX and NGINX Plus described in this post are deprecated by a unified Ansible role from NGINX, Inc., as announced in this blog post. The separate roles described here are no longer being maintained or updated.

For information about other DevOps automation tools for NGINX and NGINX Plus, check out these blog posts:

NGINX, Inc. has created Ansible roles for the open source NGINX software and NGINX Plus, available on Ansible Galaxy.

A playbook is the Ansible automation engine for application deployment, enabling users to install and configure applications across multiple servers, environments, and operating systems, all from one central location. An Ansible role, in turn, bundles Ansible variables, tasks, and handlers into a clearly defined file structure. An Ansible role can be dropped into an Ansible playbook and immediately put to work.

You can find community‑developed roles at Ansible Galaxy, a free site for sharing, finding, and downloading roles. Downloading roles from Ansible Galaxy is a great way to jump‑start your automation projects.

Installing the NGINX roles from Ansible Galaxy is very simple. To install the NGINX OSS role [Editor – now deprecated], run:

$ ansible-galaxy install nginxinc.nginx-oss

To install the NGINX Plus role [Editor – also now deprecated], run:

$ ansible-galaxy install nginxinc.nginx-plus

You can now deploy NGINX OSS within a cloud provider with a simple Ansible playbook:

---
- hosts: localhost
  remote_user: root
  become: true
  roles:
    - role: ansible-nginx-oss     # Note: deprecated by ansible-role-nginx

You can also easily deploy NGINX OSS to a dynamic inventory containing the NGINX tag:

--
- hosts: tag_nginx
  remote_user: root
  become: true
  roles:
    - role: ansible-nginx-oss     # Note: deprecated by ansible-role-nginx

Deploying NGINX Plus within a cloud provider additionally requires you to define the location of the certificate and key you received with your NGINX Plus license:

---
- hosts: localhost
  remote_user: root
  become: true
  roles:
    - role: ansible-nginx-plus    # Note: deprecated by ansible-role-nginx
  vars:
    - certs: ~/certs/

Similarly, specify the location of your NGINX Plus certificate and key when deploying NGINX Plus within a dynamic inventory containing the NGINX tag:

---
- hosts: tag_nginx
  remote_user: root
  become: true
  roles:
    - role: ansible-nginx-plus    # Note: deprecated by ansible-role-nginx
  vars:
    - certs: ~/certs/

For more details, visit the Ansible Galaxy page.

Cover image
Microservices: From Design to Deployment

The complete guide to microservices development

TRY NGINX PLUS!

Download a 30 day free trial and see what you've been missing.

We'll take care of your data.

X

Got a question for the NGINX team?

< back
X

Tags

No More Tags to display