Run an action

Dispatch one declared action from the console. Review the action contract, enter its arguments and reason, pass policy, and read the recorded result.

Before you dispatch#

1. Select a runner and action#

1. Open Runners.
2. Select the runner that owns the target service or host.
3. Find the action in its action catalog.
4. Review the risk, title, and pack.
5. Select Run.

A disabled Run button names the blocking fact. Common causes include an offline runner, an untrusted pack, a missing program, or signed-only dispatch.

2. Enter arguments and reason#

Read the action summary and every listed side effect. Then fill each required argument. The form enforces the pack's types, choices, sizes, and path limits.

Enter a short, specific reason. Audit records this reason. Describe the goal, not a generic label such as maintenance.

Confirm database health after the primary failover.

3. Dispatch and approve#

Select Dispatch to <runner>. High-risk and critical actions show a final confirmation with the target and arguments.

Policy now returns Allow, Require approval, or Deny. A denied run stops immediately. A run that needs approval waits on Approvals. The runner receives the action only after approval.

Review the action, runner, arguments, reason, evidence, and expected result before approval. A changed pack, target, or policy fact makes the approval fail closed.

4. Read the result#

After dispatch, emisar opens the run page. It shows status, output, arguments, executed command, policy facts, actor, timestamps, and exit code.

1. Wait for a terminal status.
2. Read both standard output and standard error.
3. Check the exit code and any structured result.
4. Confirm that the result matches the reason for the run.
5. Open Audit when you need the full event trail.

See Runs and history for status meanings, output limits, cancellation, and grouped operations.

Before you retry#

Fix denied, refused, or failed runs at the reported gate. Then create a new run with a new reason. Do not use the local emisar action run command as a cloud retry. That command bypasses cloud policy and approvals.