注:GitHub Enterprise Server 2.22 上的 GitHub Actions 支持是有限的公测版。 测试已结束。 GitHub Actions 现在一般可用于 GitHub Enterprise Server 3.0 或更新版本。 更多信息请参阅 GitHub Enterprise Server 3.0 发行说明。
- 有关升级到 GitHub Enterprise Server 3.0 或更新版本的更多信息,请参阅“升级 GitHub Enterprise Server”。
- 有关在升级后配置 GitHub Actions 的更多信息,请参阅 GitHub Enterprise Server 3.0 的文档。
注: GitHub 托管的运行器目前在 GitHub Enterprise Server 上不受支持。 您可以在 GitHub 公共路线图 上查看有关未来支持计划的更多信息。
简介
本教程演示如何使用 imjohnbo/issue-bot
操作定期创建议题。 例如,您可以每周创建一个议题,用作团队会议的议程。
在教程中,您将先创建一个使用 imjohnbo/issue-bot
操作的工作流程文件。 然后,您将自定义工作流以适应您的需要。
创建工作流程
-
选择要应用此项目管理工作流程的仓库。 您可以使用您有写入权限的现有仓库,或者创建一个新的仓库。 关于创建仓库的更多信息,请参阅“创建新仓库”。
-
在您的仓库中,创建一个名为
.github/workflows/YOUR_WORKFLOW.yml
的文件,将YOUR_WORKFLOW
替换为您选择的名称。 这是一个工作流程文件。 有关在 GitHub 上创建新文件的更多信息,请参阅“创建新文件”。 -
将以下 YAML 内容复制到工作流程文件中。
YAML # 此工作流使用未经 GitHub 认证的操作。 # 它们由第三方提供,并受 # 单独的服务条款、隐私政策和支持 # 文档管理。 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@3daae12aa54d38685d7ff8459fc8a2aee8cea98b 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 }}
-
自定义工工作流程文件中的参数:
- 更改
on.schedule
的值以指示您希望此工作流程何时运行。 在上面的示例中,工作流将于每周一 7:20 UTC 运行。 有关计划工作流程的更多信息,请参阅“计划的活动”。 - 将
assignees
的值更改为您想要分配给此议题的 GitHub 用户名。 - 将
labels
的值更改为您想要应用于此议题的标签列表。 - 将
title
的值更改为您希望该议题拥有的标题。 - 将
body
的值更改为您想要用于议题正文的文本。|
字符允许您为此参数使用多行值。 - 如果您想要将这个议题固定在您的仓库中,请将
pinned
设置为true
。 有关置顶议题的更多信息,请参阅“将议题固定到仓库”。 - 如果您想在每次新建议题时关闭此工作流程生成的上一个议题,请将
close-previous
设置为true
。 工作流程将关闭具有labels
字段中定义的标签的最新议题。 为避免关闭错误的议题,请使用独特的标签或标签组合。
- 更改
-
将工作流程文件提交到仓库的默认分支。 更多信息请参阅“创建新文件”。
预期结果
根据 schedule
参数(例如,每周一 7:20 UTC),您的工作流程将使用您指定的受理人、标签、标题和正文创建新议题。 如果您将 pinned
设置为 true
,工作流程会将此议题固定到您的仓库。 如果将 close-previous
设置为 true,工作流程将会关闭具有匹配标签的最新议题。
注意: schedule
事件在 GitHub Actions 工作流程运行期间负载过高时可能会延迟。 高负载时间包括每小时的开始时间。 为了降低延迟的可能性,将您的工作流程安排在不同时间运行。
您可以查看工作流程运行的历史记录,以便定期查看此工作流程运行。 更多信息请参阅“查看工作流程运行历史记录”。
后续步骤
- 要详细了解可以使用
imjohnbo/issue-bot
操作完成的其他事项,如轮换受理人或使用议题模板,请参阅imjohnbo/issue-bot
操作文档。 - 搜索 GitHub 以查看使用此操作的工作流程示例。