| name | sentry-release-management |
|---|---|
| description | Manage Sentry releases and associate commits. Use when creating releases, tracking commits, or managing release artifacts. Trigger with phrases like "sentry release", "sentry commits", "manage sentry versions", "sentry release workflow". |
| allowed-tools | Read, Write, Edit, Bash(sentry-cli:*), Bash(git:*), Grep |
| version | 1.0.0 |
| license | MIT |
| author | Jeremy Longshore <[email protected]> |
Sentry Release Management
Prerequisites
- Sentry CLI installed (
npm install -g @sentry/cli) SENTRY_AUTH_TOKENenvironment variable setSENTRY_ORGandSENTRY_PROJECTconfigured- Source maps available in build output
Instructions
- Create release using git SHA, semantic version, or package.json version
- Associate commits with sentry-cli releases set-commits --auto
- Upload source maps from build directory with URL prefix if needed
- Finalize release to mark it complete
- Configure SDK release option to match CLI release version
- Set up Webpack DefinePlugin or environment variable for build-time injection
- Use release management API to list, view, or delete releases
- Connect GitHub/GitLab integration for automatic commit linking
- Create release script to automate the full workflow
- Implement source map cleanup for old releases to manage storage
Output
- Release created with version identifier
- Commits associated with release
- Source maps uploaded
- Release finalized and ready
Error Handling
See {baseDir}/references/errors.md for comprehensive error handling.
Examples
See {baseDir}/references/examples.md for detailed examples.