Installation

We can install Unit Ansible Collection using the ansible-galaxy tool that comes bundled with Ansible. This tool can install Ansible collections from different sources.

Installing from Ansible Galaxy

Ansible Galaxy is the default source of Ansible collections for the ansible-galaxy tool. We can install the ServiceNow Ansible Collection by running:

$ ansible-galaxy collection install servicenow.itsm

After the command finishes, we will have the latest version of the ServiceNow Ansible Collection installed and ready to be (ab)used ;)

We can also install a specific version of the collection by appending a version after the name:

$ ansible-galaxy collection install servicenow.itsm:1.3.0

Note

ansible-galaxy command will not overwrite the existing collection if it is already installed. We can change this default behavior by adding a --force command line switch:

$ ansible-galaxy collection install --force servicenow.itsm:1.3.0

The official Ansible documentation contains more information about the installation options in the Using collections document.

Installing from a local file

This last method of installation might come in handy in situations where our Ansible control node cannot access Ansible Galaxy or Automation Hub.

First, we need to download the ServiceNow Ansible collection archive from the GitHub releases page and then transfer that archive to the Ansible control node. Once we have that archive on our control node, we can install the collection by running:

$ ansible-galaxy collection install path/to/servicenow-itsm-1.3.0.tar.gz