# tanomis agent rollout

Reference for tanomis agent rollout: roll a version out to specific tenants (promote-if-needed, then enable).

Generated from the <code>tanomis</code> command tree on 2026-10-01. Flags and defaults match the binary; run <code>tanomis agent rollout --help</code> for the version you have installed.

## Usage

```text title="Usage"
tanomis agent rollout NAME [flags]
```

## 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.

## Flags

| 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). |

<details>
<summary>Global flags</summary>

| 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. |

</details>

## Examples