Skip to content

deployments: document the restart action #24

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
acoshift merged 2 commits into from
Jun 17, 2026
Merged

deployments: document the restart action #24

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
1315ac3
deployments: document the restart action
acoshift Jun 17, 2026
8b59c37
deployments: note restart excludes cron jobs and static sites
acoshift Jun 17, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 5 additions & 1 deletion content/automation/cli.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,7 @@ full list of namespaces and their actions.
| `location` | — | `list`, `get` |
| `project` | — | `create`, `list`, `get`, `update`, `delete`, `usage` |
| `role` | — | `create`, `list`, `get`, `delete`, `grant`, `revoke`, `users`, `bind` |
| `deployment` | `deploy`, `d` | `list`, `get`, `deploy`, `delete`, `revisions`, `pause`, `resume`, `rollback`, `metrics`, `set image` |
| `deployment` | `deploy`, `d` | `list`, `get`, `deploy`, `delete`, `revisions`, `pause`, `resume`, `restart`, `rollback`, `metrics`, `set image` |
| `domain` | — | `create`, `get`, `list`, `delete`, `purgecache` |
| `route` | — | `create`, `get`, `list`, `delete` |
| `waf` | — | `get`, `list`, `set`, `delete`, `metrics`, `limitmetrics` |
Expand Down Expand Up @@ -108,6 +108,10 @@ deploys deployment set image web \
--project acme --location gke.cluster-rcf2 \
--image registry.deploys.app/acme/web@sha256:…

# restart a deployment (recreate its pods, same config)
deploys deployment restart \
--project acme --location gke.cluster-rcf2 --name web

# roll back to a previous revision
deploys deployment rollback \
--project acme --location gke.cluster-rcf2 \
Expand Down
1 change: 1 addition & 0 deletions content/automation/mcp.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -128,6 +128,7 @@ Ask in natural language; the assistant maps it to an action:
| "what's the usage report for `acme` this month?" | `billing.report` |
| "add the domain `app.acme.com` to `acme`" | `domain.create` |
| "pause the `worker` deployment in `acme`" | `deployment.pause` |
| "restart `web` in `acme`" | `deployment.restart` |

A typical exchange:

Expand Down
5 changes: 5 additions & 0 deletions content/deployments/overview.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -38,6 +38,11 @@ Two actions hang off the top right:
- **Deploy New Revision** — opens the deploy form pre-filled with the current
configuration. Submit it and the new revision rolls out alongside the old one
with health-checked traffic shifting.
- **Restart** — re-rolls the current revision so the pods are recreated, without
changing any configuration. Useful to clear bad in-memory state or pick up an
external change. Available for services and workers (types that keep standing
pods) — not for cron jobs or static sites, which have none. Requires the
`deployment.deploy` permission.
- **Pause** — stops the workload without deleting it. Resume restores it from
the same revision. Useful for cost control on staging or for emergency stops.

Expand Down