Skip to content

docs(cli): the deploy plan is an opt-in behind --plan [RED-1016] - #532

Closed
sorccu wants to merge 6 commits into
simo/red-997-write-back-resource-types-docsfrom
simo/red-1016-deploy-plan-opt-in
Closed

sorccu wants to merge 6 commits into
simo/red-997-write-back-resource-types-docsfrom
simo/red-1016-deploy-plan-opt-in

Conversation

@sorccu

@sorccu sorccu commented Sep 29, 2026 •

Copy link
Copy Markdown
Member

Summary

The deploy plan is an opt-in behind checkly deploy --plan (RED-1016), and the docs say so.

The pages in this stack described the planned deploy as what every checkly deploy does. The CLI now plans only under --plan, which is off by default and becomes the default in the next major version of the CLI.

  • cli/checkly-deploy.mdx: a new --[no-]plan option; --skip-plan removed; --plan-token and --prune-relations marked as requiring --plan; "How a deploy previews its changes" opens with what a deploy does by default and presents --plan as a preview feature; every example that shows a plan runs with --plan, and the examples of a default run show what a default run prints.
  • The note on deploys without a plan says the code bundle is uploaded only after the confirmation, in every case.
  • guides/claude-code-monitoring.mdx: the preview example shows the output of a default run, and points to --plan for the diff.

Related

A plan with nothing to apply

Adds what checkly deploy --plan does when the code is already deployed: it prints No changes. in place of the overview, asks for no confirmation in any environment, and completes after recording the deployment and scheduling the checks.

What the deploy prints after updating the code

Adds an example of the new report (a diff per resource in the plan's layout, then what could not be written, grouped by resource) and updates the two notes the page quotes.

Also

  • The construct diff paragraph says that properties the code spells out are shown on both sides whatever their values, that other constructs are referred to by the names the code gives them, and that both need the construct's call to be found in the code.
  • The same paragraph describes the legend the plan prints under each updated resource's header, and its past-tense form after the deploy.

🤖 Generated with Claude Code

sorccu and others added 6 commits October 5, 2026 15:02
`checkly deploy` plans a deploy only under `--plan`, which is off by default
and becomes the default in the next major version of the CLI. The pages
described the planned deploy as what every deploy does.

They now say what a deploy does by default, present `--plan` as a preview
feature, mark `--plan-token` and `--prune-relations` as requiring it, and
drop `--skip-plan`. Examples that show a plan run with `--plan`; examples of
a default run show what a default run prints.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
The note on deploys without a plan said the code bundle is uploaded before
the confirmation when the deploy may delete resources. It is uploaded after
the confirmation in every case now.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
…-1016]

Describes what `checkly deploy --plan` prints when the code is already
deployed: one sentence in place of the overview, no confirmation in any
environment, and a deploy that records the deployment and schedules the
checks without writing a resource.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
…016]

The write-back now reports what it wrote as a diff per resource, in the
layout of the plan, and groups what it could not write by resource. The
page shows an example and uses the new wording of the two notes it
quotes.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
…[RED-1016]

The plan's construct diff keeps a property the code spells out on both
sides whatever its value, so a move to or from a default reads as a
change of that line, and refers to other constructs by the names the
code gives them. Both depend on the CLI finding the construct's call in
the code.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
The plan opens each updated resource's diff with two lines saying what
its sides are: what is live in Checkly, replaced or removed by the
deploy, and what is in the code, added or changed by it; after the
deploy, "was live" and "now live".

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@sorccu

sorccu commented Oct 8, 2026

Copy link
Copy Markdown
Member Author

Rolled up into #554 with the rest of the deploy-plan documentation stack, rebased onto main. Closing this one in favour of it.

@sorccu sorccu closed this Oct 8, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant