Sentry Release GitHub Action 常见问题解决方案

Sentry Release GitHub Action 常见问题解决方案

action-release GitHub Action for creating a release on Sentry 项目地址: https://gitcode.com/gh_mirrors/ac/action-release

项目基础介绍

Sentry Release GitHub Action 是一个用于在 GitHub Actions 工作流中自动创建 Sentry 发布的开源项目。该项目的主要目的是帮助开发者在代码部署时自动生成 Sentry 发布版本，从而实现错误追踪、版本管理和代码回滚等功能。该项目主要使用 TypeScript 编写，适合在 Linux 运行环境中使用。

新手使用注意事项及解决方案

1. 权限配置问题

问题描述：新手在使用 Sentry Release GitHub Action 时，可能会遇到权限不足的问题，导致无法成功创建 Sentry 发布。

解决步骤：

1. 创建 Sentry 内部集成：

   • 在 Sentry 中，导航到 Settings > Developer Settings > Custom Integrations。
   • 点击 Create New Integration，选择 Internal Integration。
   • 为集成命名（例如 "GitHub Action Release Integration"），并设置所需的权限（Admin 权限用于 "Release"，Read 权限用于 "Organization"）。
   • 保存集成后，生成一个新的 Token，并将其作为 SENTRY_AUTH_TOKEN 存储在 GitHub Secrets 中。

2. 配置 GitHub Secrets：

   • 在 GitHub 仓库中，导航到 Settings > Secrets and variables > Actions。
   • 点击 New repository secret，添加 SENTRY_AUTH_TOKEN 和 SENTRY_ORG 等必要的环境变量。

2. 环境变量缺失

问题描述：新手在配置 GitHub Action 时，可能会忘记设置必要的环境变量，导致 Action 无法正常运行。

解决步骤：

1. 检查环境变量：

   • 确保在 GitHub Action 的工作流文件中设置了所有必要的环境变量，如 SENTRY_AUTH_TOKEN、SENTRY_ORG、SENTRY_PROJECT 等。

2. 添加缺失的环境变量：

   • 在 GitHub 仓库的 Settings > Secrets and variables > Actions 中添加缺失的环境变量。

3. 发布版本不匹配

问题描述：新手在创建 Sentry 发布时，可能会遇到发布版本与实际代码版本不匹配的问题。

解决步骤：

1. 检查版本号：

   • 确保在 GitHub Action 的工作流文件中正确设置了 SENTRY_RELEASE 变量，该变量应与代码的实际版本号一致。

2. 同步版本信息：

   • 在代码仓库中，确保版本号与 Sentry 中的发布版本号一致。可以通过在代码中添加版本号文件或在 CI/CD 流程中自动生成版本号来实现。

通过以上步骤，新手可以更好地理解和使用 Sentry Release GitHub Action，避免常见问题的发生。

action-release GitHub Action for creating a release on Sentry 项目地址: https://gitcode.com/gh_mirrors/ac/action-release