GitHub 存储库网页触发器

GitHub 存储库网页触发器用于监控 GitHub 组织内的存储库事件。 一旦存储库中发生事件，触发器就会激活并启动自动化工作流。

将触发器映射到 GitHub 组织内的存储库，并配置触发器，以便在存储库发生任何事件时运行自动化。

GitHub 存储库网页触发器支持存储库中的以下事件：
  • 创建
  • 复刻
  • 问题注释
  • 问题
  • 标签
  • 拉取请求
  • 拉取请求审查
  • 推送
  • 开始
  • 观看

例如，创建 GitHub 存储库网页触发器，以监控 GitHub 组织内的存储库是否有拉取请求。 在监控的存储库中创建拉取请求时，触发器将激活并启动自动化中的下一个操作。

先决条件

  • 您必须具有 Bot Creator 或 Citizen Developer 许可证。
  • 您必须拥有查看我的机器人权限。
  • 您必须拥有该角色的所有事件触发器权限。
  • 您必须对自动化所在文件夹具有签入和签出权限。
  • 您必须登录到您的 Control Room。
  • GitHub 网页触发器使用个人访问令牌来验证用户配置文件的身份。 GitHub 网页触发器支持经典和细粒度的访问令牌。 确保在 GitHub 用户设置中生成个人访问令牌，并将其存储在 Credential Vault。 有关创建和管理个人访问令牌的更多信息，请参见管理您的个人访问令牌。

过程

  1. 在左侧窗格中，单击自动化。
  2. 单击 创建 > 任务机器人。
    创建任务机器人向导已显示。
  3. 在名称字段中为机器人输入一个合适的名称。
    默认情况下，所有机器人都存储在 \Bots 文件夹中。
  4. 可选： 您可以在描述字段中为机器人添加描述。
  5. 可选： 您可以使用选择按钮将机器人保存在不同的文件夹中。
  6. 单击创建和编辑。
    机器人已创建，并显示编辑任务机器人。
  7. 单击触发器 > GitHub，然后双击或拖动存储库网页触发器，将网页触发器添加到触发器部分。
  8. 从监听事件下拉菜单中选择一个或多个要监听的事件。
  9. 在存储库名称字段中输入 GitHub 存储库名称。
  10. 在用户配置文件中输入 GitHub 配置文件名称。
  11. 在选择身份验证类型部分中选择以下选项之一。
    默认情况下，选择选择身份验证类型中的个人访问令牌作为身份验证类型。
    • 凭据： 单击选择，选择已在 Credential Vault 中配置的个人访问令牌。
    • 不安全的字符串： 复制并粘贴在 GitHub 开发人员设置中生成的个人访问令牌字符串。
      注： 确保个人访问令牌未过期。
  12. 可选： 在响应选项中添加变量到触发器。 有关变量的更多信息，请参阅 变量概述。
    注： 如果您使用现有变量作为响应，请确保该变量的用作输入复选框已启用。
  13. 可选： 如有需要，请在触发器部分添加更多触发器。
  14. 双击相应的操作，或从操作面板拖动到操作部分。
    有关操作的信息，请参阅 Actions 构建自动化。
  15. 单击保存以保存机器人。
当您使用使用触发器运行运行机器人时，网页触发器将激活并监听 Issues、Star 和 Watch 事件。 当存储库中发生其中一个事件时，触发器将启动后续的 Message Box 操作。