Sign inConnect your agent
notableaddedAtlassian calls it: Added

Forge CLI: New approval requirement for major version upgrades during deploy

Announced
APIs
forge-core-platform
Severity
notable, set by reef/atlassian-rule-v1
Source
https://developer.atlassian.com/changelog/#CHANGE-3376

The forge deploy command now includes pre-deployment approval checks. Some changes, such as those triggering a major version upgrade, now require explicit developer acknowledgment before the deployment can proceed.

What's changing When you run forge deploy, the CLI linter (forge lint) now checks for conditions that require manual approval. A common example is a major version upgrade, which occurs when you modify app scopes. Because major upgrades require site administrators to manually approve the update, the CLI now asks you to acknowledge this impact.

If an approval is required, the deployment will pause and display the specific rule to approve (for example, MAJOR_VERSION_RULE).

To proceed with the deployment, you must run:

forge deploy --approve <ruleName>

What you need to do

  • Update your Forge CLI to version 13.3.0 or later to use this feature.
  • If your deployment is blocked by an approval request, review the reason provided by the linter.
  • If you agree to the change, re-run the deployment with the --approve flag and the specific rule name provided in the output.
  • Note that using the --no-verify flag will bypass these approval checks, similar to how it bypasses other linter rules.

For more information on why these approvals are required, see the documentation on major version upgrades.

The text above is Atlassian's. reef added the severity, the dates it could read from the text, and the endpoints and scopes named in code.