What's new in Ansible Automation Platform 2: automation content navigator

October 7, 2021 by Colin McNaughton

AAP 2 gray sliding a

With the introduction of Red Hat Ansible Automation Platform 2, several new key components are being introduced as a part of the overall developer experience. This includes automation execution environments, introduced to provide predictable environments during automation runtime. All collection dependencies are contained within the execution environment to make sure that automation created in development environments runs the same as in production environments.

Building execution environments is now easier with the introduction of the execution environment builder (ansible-builder) tool included with Ansible Automation Platform, while the updates to automation controller help IT teams leverage execution environments.

Considering the shift towards containerized execution of automation, the automation development workflow and pre-existing tooling must be reimagined. In short, ansible-navigator replaces ansible-playbook and other ansible-*` command line utilities.

However, ansible-navigator serves a much greater purpose than just a drop in replacement or alias to ansible-playbook. With this release, ansible-navigator is introduced as an application exclusively for developing and executing automation. Ansible-playbook has long been one of the first utilities that is leveraged in an Ansible automated environment. Building on the ease of use, the automation content navigator exposes automation runs in greater detail. Apart from debugging automation, ansible-navigator also allows inspection of multiple aspects of the environment, including automation execution environments, inventories, collections, modules and more through the use of subcommands.

Who will use automation content navigator?

The automation content navigator is mainly geared towards developers of automation. This can mean people creating automated tasks with available modules, those migrating roles into Collections or those who are developing modules from the ground up. Content navigator runs as a textual user interface and looks great within a terminal session, even while running inside popular code editors with included terminal panes.

Initial view of text user interface (TUI) 

Launching navigator without any additional options brings up a welcome screen that displays the different subcommands that are available.

Moving around the interface is quite simple and reminders for the navigation keys are listed at the bottom of the interface. Subcommands can be entered in a vim-like fashion using the format :<command>.

 Exploring the local environment 

Each project can have its own navigator configuration (ansible-navigator.yml). Common configuration parameters can be names of execution environment images required for the project, Ansible configuration parameters such as forks, log levels, artifact creation, etc. By configuring the content navigator on a project basis, other contributors are more easily able to branch, fork and otherwise extend automation projects.

ansible-navigator:
ansible:
inventories:
- hosts

execution-environment:
enabled: true
container-engine: podman
image: ansible-automation-platform-20-ee-supported-rhel8
pull-policy: missing

The automation content navigator also has built in subcommands to allow developers easy access to explore the environment. Two very useful subcommands in this context are :inventory which allows for traversing of the project's inventory, and :collections which allows developers to quickly see which Collections are available within the specified execution environment. Expanding one of the Collections returned, shows a list of all modules contained along with documentation and usage examples.


Executing automation 

ansible-navigator run <playbook> will execute playbooks after downloading a default execution environment. To run without an execution environment, pass  --ee false to the command.

Notice how the interface changes from the overview screen to a screen that now lists out the plays that are being executed.

Pressing the number that corresponds to the line number of the play you'd like to inspect brings you to a screen that shows the tasks running along with the current running task.

From here, any tasks can be inspected for additional information including any additional information regarding task failure.

If a more traditional real time view of execution is preferred, issue the :st command to watch execution.

What's next?

Share:

Topics:
Ansible Automation, Developer, ansible-navigator, automation content navigator, automation execution environment


 

Colin McNaughton

Colin McNaughton is a Principal Technical Marketing Manager for Ansible Automation. Colin has been with Red Hat for 7 years and, prior to this position, served as a Solution Architect in the southeast helping organizations grow their automation strategy. He has lived in NC for the past decade with his wife and two kids.


rss-icon  RSS Feed

RH-ansible-automation-platform_trial-banner
rh-ansiblefest-blog-image-600x500