sentry-release-management
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".
When & Why to Use This Skill
The Sentry Release Management skill streamlines the software deployment lifecycle by automating the creation, tracking, and finalization of Sentry releases. It integrates seamlessly with Sentry CLI and Git to associate commits with specific versions and manage source map uploads, ensuring precise error tracking and improved debugging efficiency for development teams.
Use Cases
- Automated Deployment Workflows: Automatically create and finalize Sentry releases during the CI/CD process using Git SHAs or semantic versioning to maintain a consistent release history.
- Enhanced Error Debugging: Link specific code commits to releases to identify exactly which changes introduced new bugs, enabling faster root cause analysis.
- Source Map Integration: Automate the uploading of source maps to Sentry, allowing developers to view de-obfuscated stack traces from production environments directly in their error reports.
- Release Artifact Management: Efficiently manage, list, and delete release versions and associated artifacts to keep the Sentry project organized and within storage limits.
| name | sentry-release-management |
|---|---|
| description | | |
| allowed-tools | Read, Write, Edit, Bash(sentry-cli:*), Bash(git:*), Grep |
| version | 1.0.0 |
| license | MIT |
| author | Jeremy Longshore <jeremy@intentsolutions.io> |
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.