Concepts

The words this manual uses without explaining them. Each has a page where it is explained in full; here is a sentence to get your bearings. The alphabetical list is in the glossary.

Workspace

Your part of Runjet: jobs, agents, runs, accounts and the plan together, with an address of its own and a database of its own. It comes into being at registration and has a life: a free month, a possible suspension, deletion.

Job

A shell command, a schedule saying when it should run, and the agents it should run on. Plus tags, the names of secrets, and four switches. Creating a job is the form, field by field.

Run

One execution of one job on one agent: when it was created, when it started and finished, how it went, what it printed. A job on three agents has three runs to a single tick. Run states are its life; output and retention what is left of it afterwards.

Agent

The process on your machine that calls into Runjet for work, runs it under an account of its own, and reports the result. A single static binary; installing, how it works.

Dispatch

One instruction for one agent: the run's identifier, the command, the names of its secrets, an expiry — signed with the workspace's key so the agent knows who it is from. A cron tick makes a dispatch for each of the job's agents (how an agent works).

Tick

The moment a job's schedule says "now". A tick creates runs; a tick that arrives while the previous run on an agent is still going is skipped for that agent (assigning agents); a tick that fell during an outage is either dropped or caught up once (missed runs).

Tag

A coloured name on a job, shared between jobs, created by being used and gone with the last job that carried it. It is there to filter by (tags and filtering).

Secret

The name of a variable the command needs; the value is on the host with the agent, and Runjet never sees it. Secrets is the job's half, secrets on the host the agent's.

Plan

A set of promises about what Runjet will refuse: how many agents, how many accounts, how long the text of an output is kept. Solo, Pro, Business; the free month is Pro. Plans and billing.

Role

What an account may do: a viewer looks, an operator runs and edits, an admin deletes and manages people and the plan. Roles is the table.