我们经常发布文档更新,此页面的翻译可能仍在进行中。有关最新信息,请访问英文文档。如果此页面上的翻译有问题,请告诉我们

计划议题的创建

您可以使用 GitHub Actions 定期为日常会议或季度审查等事项创建议题。

GitHub Actions 可用于 GitHub Free、GitHub Pro、组织的 GitHub Free,GitHub Team、GitHub Enterprise Cloud、GitHub Enterprise Server 、GitHub One 及 GitHub AE。 GitHub Actions 不适用于使用旧版按仓库计划的帐户所拥有的私有仓库。

本文内容

注:GitHub Enterprise Server 2.22 上的 GitHub Actions 支持是有限的公测版。 测试已结束。 GitHub Actions 现在一般可用于 GitHub Enterprise Server 3.0 或更新版本。 更多信息请参阅 GitHub Enterprise Server 3.0 发行说明


注: GitHub 托管的运行器目前在 GitHub Enterprise Server 上不受支持。 您可以在 GitHub 公共路线图 上查看有关未来支持计划的更多信息。

简介

本教程演示如何使用 imjohnbo/issue-bot 操作定期创建议题。 例如,您可以每周创建一个议题,用作团队会议的议程。

在教程中,您将先创建一个使用 imjohnbo/issue-bot 操作的工作流程文件。 然后,您将自定义工作流以适应您的需要。

创建工作流程

  1. 选择要应用此项目管理工作流程的仓库。 您可以使用您有写入权限的现有仓库,或者创建一个新的仓库。 关于创建仓库的更多信息,请参阅“创建新仓库”。

  2. 在您的仓库中,创建一个名为 .github/workflows/YOUR_WORKFLOW.yml的文件,将 YOUR_WORKFLOW 替换为您选择的名称。 这是一个工作流程文件。 有关在 GitHub 上创建新文件的更多信息,请参阅“创建新文件”。

  3. 将以下 YAML 内容复制到工作流程文件中。

    YAML
    name: Weekly Team Sync
    on:
      schedule:
        - cron: 20 07 * * 1
    
    jobs:
      create_issue:
        name: Create team sync issue
        runs-on: ubuntu-latest
        steps:
          - name: Create team sync issue
            uses: imjohnbo/issue-bot@v3.0
            with:
              assignees: "monalisa, doctocat, hubot"
              labels: "weekly sync, docs-team"
              title: "Team sync"
              body: |
                ### Agenda
    
                - [ ] Start the recording
                - [ ] Check-ins
                - [ ] Discussion points
                - [ ] Post the recording
    
                ### Discussion Points
                Add things to discuss below
    
                - [Work this week](https://github.com/orgs/github/projects/3)
              pinned: false
              close-previous: false
            env:
              GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
  4. 自定义工工作流程文件中的参数:

    • 更改 on.schedule 的值以指示您希望此工作流程何时运行。 在上面的示例中,工作流将于每周一 7:20 UTC 运行。 有关计划工作流程的更多信息,请参阅“计划的活动”。
    • assignees 的值更改为您想要分配给此议题的 GitHub 用户名。
    • labels 的值更改为您想要应用于此议题的标签列表。
    • title 的值更改为您希望该议题拥有的标题。
    • body 的值更改为您想要用于议题正文的文本。 | 字符允许您为此参数使用多行值。
    • 如果您想要将这个议题固定在您的仓库中,请将 pinned 设置为 true。 有关置顶议题的更多信息,请参阅“将议题固定到仓库”。
    • 如果您想在每次新建议题时关闭此工作流程生成的上一个议题,请将 close-previous 设置为 true。 工作流程将关闭具有 labels 字段中定义的标签的最新议题。 为避免关闭错误的议题,请使用独特的标签或标签组合。
  5. 将工作流程文件提交到仓库的默认分支。 更多信息请参阅“创建新文件”。

预期结果

根据 schedule 参数(例如,每周一 7:20 UTC),您的工作流程将使用您指定的受理人、标签、标题和正文创建新议题。 如果您将 pinned 设置为 true,工作流程会将此议题固定到您的仓库。 如果将 close-previous 设置为 true,工作流程将会关闭具有匹配标签的最新议题。

注意: schedule 事件在 GitHub Actions 工作流程运行期间负载过高时可能会延迟。 高负载时间包括每小时的开始时间。 为了降低延迟的可能性,将您的工作流程安排在不同时间运行。

您可以查看工作流程运行的历史记录,以便定期查看此工作流程运行。 更多信息请参阅“查看工作流程运行历史记录”。

后续步骤

  • 要详细了解可以使用 imjohnbo/issue-bot 操作完成的其他事项,如轮换受理人或使用议题模板,请参阅 imjohnbo/issue-bot 操作文档
  • 搜索 GitHub 以查看使用此操作的工作流程示例。

此文档对您有帮助吗?

Privacy policy

帮助我们创建出色的文档!

所有 GitHub 文档都是开源的。看到错误或不清楚的内容了吗?提交拉取请求。

做出贡献

或, 了解如何参与。