Skip to content

philion/tansible

Repository files navigation

tansible

A textual-based TUI for the Ansible debugger.

On a fully-qualified link will create a link to the wiki.

This is an exploration of using automation and infrastructure-as-code to help teach operational management and support.

Ansible is selected for "simplicity", widespread use, community support and it's FOSS licensing. This is not to say that ansible is a "simple tool". To the contrary, event the simplest tasks and network configuration quickly becomes obscure due to the inherent complexity and scale of the operations ansible is performing. This makes IaC difficult for new users, with a daunting learning curve and dire consequenses should any mistakes be made.

At the same time, IaC is a powerful tool that both describes an entire system and provides a means create and maintain it. Framed as a functional description of a system and its operation, IaC becomes an opportunity to use the captured knowledge to demonstrate "how systems are built".

Theoritically. This project is an attempt to see if it works in action.

tansible uses textual for the terminal user interface TUI to wrap the Ansible debugger, while displaying code location and varible values.

Design

Made up of several ansible-specific widgets to select an inventory, select a playbook, display specific locations in code (file, line number), display current task vars, and an active ansible console to step, edit and execute the next operation.

playbook debugger commands:

  • print var
  • set var
  • update task
  • redo
  • continue
  • quit

Based on a textual TCSS file, the user will be able to modify the display and layout of the TUI. The TUI is designed to be reactive and to downgrade gracefully for older terminals. tansible is intended to operate over ssh, take advantage of modern terminal capabilities and still work well when all you have an actual console connection.

Alternatives

Progress

Note: This is a Work In Progress.

Simple inventory and playbook widgets are working. App logs are written to the log widget.

Next step is an ansible widget to hold the debugger, playbook and inventory in dry-run mode.

About

A textual-based TUI for the Ansible debugger

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published