| name | sentry-ci-integration |
|---|---|
| description | Manage integrate Sentry with CI/CD pipelines. Use when setting up GitHub Actions, GitLab CI, or other CI systems with Sentry releases and source maps. Trigger with phrases like "sentry github actions", "sentry CI", "sentry pipeline", "automate sentry releases". |
| allowed-tools | Read, Write, Edit, Bash(gh:*), Grep |
| version | 1.0.0 |
| license | MIT |
| author | Jeremy Longshore <[email protected]> |
Sentry Ci Integration
Prerequisites
- Sentry CLI installed or available in CI
SENTRY_AUTH_TOKENsecret configuredSENTRY_ORGandSENTRY_PROJECTenvironment variables set- Source maps generated during build
Instructions
- Add SENTRY_AUTH_TOKEN secret to CI platform (GitHub, GitLab, CircleCI)
- Configure SENTRY_ORG and SENTRY_PROJECT environment variables
- Create workflow step to build application with SENTRY_RELEASE env
- Add step to create Sentry release using sentry-cli or action
- Upload source maps from build output directory
- Associate commits with release using set-commits --auto
- Finalize the release to mark it complete
- Add deploy notification step for environment tracking
- Configure checkout with fetch-depth: 0 for full git history
- Test workflow by pushing to trigger release creation
Output
- Release created and finalized in Sentry
- Source maps uploaded for stack trace mapping
- Commits associated with release
- Deploy notification sent to Sentry
Error Handling
See {baseDir}/references/errors.md for comprehensive error handling.
Examples
See {baseDir}/references/examples.md for detailed examples.