Documentation

8. Create a new Inventory and add it to the Organization

An inventory is a collection of hosts managed by Tower. Inventories are assigned to organizations, while permissions to launch playbooks against inventories are controlled at the user and/or team level. For more information, refer to Inventories, Users - Permissions, and Teams - Permissions in the Tower User Guide.

To review existing inventories, navigate to the Inventories main link. To create a new inventory, click the add button.

Inventories - create new inventory

Ansible Tower provides a demo inventory for you to use as you learn how Tower works. Click on the “Demo Inventory” link for the stock inventory provided by Ansible Tower.

Note that inventories are divided into groups and hosts. A group might represent a particular environment (e.g. “Datacenter 1” or “Stage Testing”), a server type (e.g. “Application Servers” or “DB Servers”), or any other representation of your environment.

The left side of the screen displays the groups that belong to the Demo inventory. The right side displays hosts.

Inventories - click to create new group

Note

Prior to Ansible Tower 2.2, hosts could not be added to the Web Servers inventory before adding a group. If you are using an older version of Tower, click the “Plus” button above the ‘Groups’ section to add a group before adding a host.

For this example, suppose that the organization you created earlier has a group of web server hosts supporting the corporate CMS application. To add these hosts to the Web Servers inventory, create a “CMS Web” group. Click the Save button to create the group.

For the purposes of this Quick Start and to test that Tower is setup properly, a local host has been added for your use.

Inventories - host properties form

Click Cancel (if no changes were made) or use the breadcrumb navigational links at the top of the Ansible Tower browser to return to the Inventories overview screen. Clicking Save does not exit the edit dialog.