Chapter 1. Introduction to Ansible content navigator

As a content creator, you can use Automation content navigator to develop Ansible playbooks, collections, and roles that are compatible with the Red Hat Ansible Automation Platform. You can use Automation content navigator in the following environments, with seamless and predictable results across them all:

  • Local development machines
  • Automation execution environments

Automation content navigator also produces an artifact file you can use to help you develop your playbooks and troubleshoot problem areas.

1.1. Uses for Automation content navigator

Automation content navigator is a command line, content-creator-focused tool with a text-based user interface. You can use Automation content navigator to:

  • Launch and watch jobs and playbooks.
  • Share stored, completed playbook and job run artifacts in JSON format.
  • Browse and introspect automation execution environments.
  • Browse your file-based inventory.
  • Render Ansible module documentation and extract examples you can use in your playbooks.
  • View a detailed command output on the user interface.

1.2. Automation content navigator modes

Automation content navigator operates in two modes:

stdout mode
Accepts most of the existing Ansible commands and extensions at the command line.
text-based user interface mode
Provides an interactive, text-based interface to the Ansible commands. Use this mode to evaluate content, run playbooks, and troubleshoot playbooks after they run using artifact files.

1.2.1. stdout mode

Use the -m stdout subcommand with Automation content navigator to use the familiar Ansible commands, such as ansible-playbook within automation execution environments or on your local development environment. You can use commands you are familiar with for quick tasks.

Automation content navigator also provides extensive help in this mode:

--help
Accessible from ansible-navigator command or from any subcommand, such as ansible-navigator config --help.
subcommand help
Accessible from the subcommand, for example ansible-navigator config --help-config. This help displays the details of all the parameters supported from the related Ansible command.

1.2.2. Text-based user interface mode

The text-based user interface mode provides enhanced interaction with automation execution environments, collections, playbooks, and inventory. This mode is compatible with integrated development environments (IDE), such as Visual Studio Code.

Text-based user interface mode

This mode includes a number of helpful user interface options:

colon commands
You can access all the Automation content navigator commands with a colon, such as :run or :collections
navigating the text-based interface
The screen shows how to page up or down, scroll, escape to a prior screen or access :help.
output by line number
You can access any line number in the displayed output by preceding it with a colon, for example :12.
color-coded output
With colors enabled, Automation content navigator displays items, such as deprecated modules, in red.
pagination and scrolling
You can page up or down, scroll, or escape by using the options displayed at the bottom of each Automation content navigator screen.

You cannot switch between modes after Automation content navigator is running.

This document uses the text-based user interface mode for most procedures.

1.3. Automation content navigator commands

The Automation content navigator commands run familiar Ansible CLI commands in -m stdout mode. You can use all the subcommands and options from the related Ansible CLI command. Use ansible-navigator --help for details.

Table 1.1. Automation content navigator commands

CommandDescriptionCLI example

collections

Explore available collections

ansible-navigator collections --help

config

Explore the current ansible configuration

ansible-navigator config --help

doc

Review documentation for a module or plugin

ansible-navigator doc --help

images

Explore execution environment images

ansible-navigator images --help

inventory

Explore an inventory

ansible-navigator inventory --help

replay

Explore a previous run using a playbook artifact

ansible-navigator replay --help

run

Run a playbook

ansible-navigator run --help

welcome

Start at the welcome page

ansible-navigator welcome --help

1.4. Relationship between Ansible and Automation content navigator commands

The Automation content navigator commands run familiar Ansible CLI commands in -m stdout mode. You can use all the subcommands and options available in the related Ansible CLI command. Use ansible-navigator --help for details.

Table 1.2. Comparison of Automation content navigator and Ansible CLI commands

Ansible navigator commandAnsible CLI command

ansible-navigator collections

ansible-galaxy collection

ansible-navigator config

ansible-config

ansible-navigator doc

ansible-doc

ansible-navigator inventory

ansible-inventory

ansible-navigator run

ansible-playbook