Skip to content

Automation Overview ​

SeyalRun's Automation lets you run Ansible-style playbooks or bash scripts across your host fleet from reusable, RBAC-scoped job templates — ad hoc, on a cron schedule, from a one-click Quick Action, or triggered by a Zabbix event. It's powered by a dedicated automation-service, reachable in the UI at Automation in the main navigation.

Automation page — Playbooks & Scripts, All Templates, Schedules, and Recent Runs tabs

Core concepts ​

ConceptWhat it is
ProjectA folder that groups related job templates together (e.g. "Web Fleet", "Database Maintenance"). Every template belongs to exactly one project.
Job TemplateThe reusable definition — what the UI calls a "playbook". Stores the Ansible YAML or bash script content, default targets, credential, and options. Creating one does not run anything by itself.
Job RunA single execution of a job template — the instance created every time you click Run, a schedule fires, or a Quick Action is used. Each run has its own status, parameters, and output log.
ScheduleA cron binding that fires a job template automatically at a recurring time, optionally overriding its default parameters.

A "playbook" in SeyalRun is not a file on disk — the Ansible YAML or shell script is stored as text directly on the job template and run inline against a generated inventory (for Ansible) or over SSH per host (for bash). There's nothing to check into a separate repo unless you choose to author it in GitHub and import it (see Writing Playbooks & Scripts).

The four tabs ​

The Automation page (/automation) organizes everything into tabs:

  • Playbooks & Scripts — the templates you author yourself: Ansible Playbook or Bash Script job templates, in a searchable list or grid view. Visible to everyone; creating/editing/deleting requires admin, support, or superadmin.
  • All Templates (admin/support only) — every job template regardless of type, including the four built-in account-lifecycle templates (see below).
  • Schedules (admin/support only) — cron bindings that fire templates automatically.
  • Recent Runs — the history of every job execution, with a live link into each run's detail/log page. (Old bookmarks to /jobs redirect here automatically.)

Beyond playbooks: account-lifecycle templates ​

Alongside the playbooks and scripts you write, SeyalRun automatically seeds four built-in job templates under an "Account Operations" project the first time automation-service starts:

  • Default · Create / Push Account
  • Default · Rotate Secret
  • Default · Disable Account
  • Default · Remove Account

These use the same job-template/job-run machinery described in this section, but act on a subject account (the user created, rotated, disabled, or removed on each target host) rather than running arbitrary code. They're the templates behind the "Create / Rotate / Disable / Remove account" actions on the Assets page. See Execution Options for how the subject account is chosen at run time.

Where to go next ​

Secure. Controlled. Automated. — Released under the Apache License 2.0.