tanomis agent rollout
Generated from the tanomis command tree on 2026-10-01. Flags and defaults match the binary; run tanomis agent rollout –help for the version you have installed.
tanomis agent rollout NAME [flags]Description
Section titled “Description”Roll one version out to an explicit set of tenants in a single, tenant-scoped step.
rollout composes the two underlying operations so the operator’s intent — “serve
version V to these tenants” — is one command: it first ensures the version is at the
production status (transitioning it if needed, surfacing any gate failure verbatim),
then enables it for the named tenants only. By default the version becomes the tenants’
baseline; with --canary-share N (1-99) it is added as a canary at that share, preserving
each tenant’s existing baseline. Other tenants are never touched.
Use --dry-run to preview the per-tenant before/after plan without changing anything.
This is porcelain over tanomis agent promote + tanomis agent enable, which remain available.
| Flag | Type | Description |
|---|---|---|
--by |
string | Identity recorded as the principal. Default local-dev. |
--canary-share |
int | 0 = baseline (default); 1-99 = roll out as canary at this share. |
--dry-run |
bool | Print the per-tenant before/after plan without making changes. |
--tenants |
string | Comma-separated tenant ids, or ‘all’. |
--version |
string | Version label to roll out (e.g. v2). |
Global flags
| Flag | Type | Description |
|---|---|---|
--config |
string | Config file path. |
--context |
string | Config context to use. |
-o, --output |
string | Output format: table|json. |
--tenant |
string | Tenant id (X-Tenant-ID). |
--verbose |
bool | Verbose output. |
Examples
Section titled “Examples”Preview what would change for one tenant before touching anything:
tanomis agent rollout support-copilot --version v2 --tenants acme-prod --dry-runRoll out as a canary at ten percent while each tenant keeps its current baseline:
tanomis agent rollout support-copilot --version v2 --tenants acme-prod,initech --canary-share 10Confirm the result per tenant:
tanomis agent versions support-copilot --by-tenant