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
--approveflag and the specific rule name provided in the output. - Note that using the
--no-verifyflag 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.