cops release check evaluates release gates configured in cops.project.json. Each gate defines a type (e.g. bamboo-latest-build-success), severity, and optional waiver. The command exits with a non-zero code when any blocking gate fails.
Usage
Flags
Run all enabled gates defined in
release.gates. When omitted and --gate is not specified, only the first enabled gate is evaluated.Run a single gate by its
id. Mutually exclusive with --all.Project key from the
projects map in cops.project.json. Defaults to defaultProject when set, otherwise uses the top-level release block.Output format:
table, json, or markdown.Disable TLS certificate validation. Use only with self-signed certificates in trusted networks.
Override the active config profile.
Output columns
project, gateId, type, severity, owner, team, ticket, slaHours, rawStatus, status, blocking, waived, waiverExpires, details
| Column | Description |
|---|---|
gateId | Gate identifier from cops.project.json |
type | Gate type (e.g. bamboo-latest-build-success) |
severity | Severity level: low, medium, high, or critical |
rawStatus | Raw evaluation result: pass, warn, or fail |
status | Effective status after applying waivers: pass, warn, fail, or waived |
blocking | true when the gate failure blocks the release |
waived | true when an active waiver has been applied |
details | Human-readable evaluation detail |
Exit codes
| Code | Meaning |
|---|---|
0 | All evaluated gates passed |
20 | One or more gates are blocking (fail with high/critical severity or raw fail) |
10 | One or more gates produced a non-blocking warn or waived result |
30 | Configuration error (missing or invalid cops.project.json) |
A gate with severity
high or critical that evaluates to warn is treated as blocking. Gates with severity low or medium that evaluate to warn are non-blocking. An active waiver changes the effective status to waived and clears the blocking flag regardless of severity.Supported gate types
| Type | Checks |
|---|---|
jira-stories-exist | Jira issues exist for the configured fixVersion |
confluence-page-exists | Required Confluence page exists in the space |
confluence-page-sections | Required sections are present in the Confluence page body |
confluence-page-freshness | Confluence page was updated within maxAgeDays |
bitbucket-release-branch-exists | Release branch exists in the Bitbucket repository |
bitbucket-pr-checks | Open PRs targeting the release branch are within threshold |
bamboo-plan-active | Bamboo plan is enabled and active |
bamboo-latest-build-success | Latest Bamboo build for the plan has a SUCCESS state |
checkmarx-scan-threshold | Checkmarx scan results are within configured H/M/L thresholds |
deployment-freeze-window | Current time is not inside a configured freeze window |
bamboo-multi-env-promotion | Bamboo deployment environments were promoted in order |
Examples
Related
cops release summary
Cross-product release readiness summary.
cops release evidence generate
Generate evidence artifacts from gate evaluations.