Skip to content

lapce/tiron

Repository files navigation

Tiron

Reasonable Automation Engine

Tiron is an automation tool that's easy to use and aims to be as fast as possible. It’s agentless by using SSH and has a TUI for the outputs of the tasks. There is an example Tiron configuration here.

Screenshot

Features

  • No YAML: Tiron uses HCL as the configuration language.
  • Agentless: By using SSH, Tiron connects to the remote machines without the need to install an agent first.
  • TUI: Tiron has a built in terminal user interfaces to display the outputs of the running tasks.
  • Correctness: Tiron pre validates all the runbook files and will throw errors before the task is started to execute.
  • Speed: On validating all the input, Tiron also pre populates all the data for tasks, and send them to the remote machines in one go to save the roundtrips between the client and remote.
  • LSP: Tiron provides a LSP server which can provide syntax highlighting, linting, formatting, code jumps, completion etc.

Quickstart

Run below to install latest Tiron binary to /usr/local/bin

curl -sL https://tiron.run/install.sh | sh

More information can be found in the docs.

Usage

To run a Tiron runbook

$ tiron run

Full usage:

$ tiron -h

A reasonable automation engine

Usage: tiron <COMMAND>

Commands:
  run     Run Tiron runbooks
  check   Check Tiron runbooks
  fmt     Format Tiron runbooks
  action  Show Tiron action docs
  help    Print this message or the help of the given subcommand(s)

Options:
  -h, --help     Print help
  -V, --version  Print version

TUI Navigation

Key Action
j Scroll down
k Scroll up
d Page down
u Page up
g Jump to top
G Jump to bottom
n Next Host
p Previous Host
Ctrl+n Next Run
Ctrl+p Previous Run

License

Tiron is licensed under the Apache 2.0 license.