Ansible Collection for ServiceNow

This collection provides a series of Ansible modules, roles, and plugins for interacting with ServiceNow

Requirements

ansible version >= 2.9
pysnow
netaddr

Installation

To install ServiceNow collection hosted in Galaxy:

ansible-galaxy collection install servicenow.servicenow

To upgrade to the latest version of ServiceNow collection:

ansible-galaxy collection install servicenow.servicenow --force

Usage

Playbooks

To use a module from the ServiceNow collection, please reference the fill namespace, collection name, and module name that you want to use:

---
- name: Using ServiceNow Collection
  hosts: localhost
  gather_facts: no
  
  tasks:
  - name: Create an incident
    servicenow.servicenow.snow_record:
      username: ansible_test
      password: my_password
      instance: dev99999
      state: present
      data:
        short_description: "This is a test incident opened by Ansible"
        severity: 3
        priority: 2

Or you can add full namespace and collection name in the collections section:

---
- name: Using ServiceNow Collection
  hosts: localhost
  gather_facts: no
  collections:
    - servicenow.servicenow
  
  tasks:
  - name: Create an incident
    snow_record:
      username: ansible_test
      password: my_password
      instance: dev99999
      state: present
      data:
        short_description: "This is a test incident opened by Ansible"
        severity: 3
        priority: 2

Roles

For existing Ansible roles, please also reference the full namespace, collection name, and modules name which used in tasks instead of just modules name.

Resource Included

Modules

snow_record - Creates, deletes and updates a single record in ServiceNow.
snow_record_find - Gets multiple records from a specified table from ServiceNow based on a query dictionary.

Plugins

now - ServiceNow Inventory Plugin

Contributing

There are many ways in which you can participate in the project, for example:

Submit bugs and feature requests, and help us verify as they are checked in
Review source code changes
Review the documentation and make pull requests for anything from typos to new content

Special thanks to Tim Rightnour (@garbled1) for the original version of ServiceNow modules in Ansible Core.

adworjan / servicenow-ansible