在项目板上移动分配的议题

您可以使用 GitHub Actions 在议题被分配时自动将议题移到项目板上的特定列。

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

注意: GitHub Actions 目前正在测试用于 GitHub AE 。

警告: 自托管运行器目前对 GitHub AE 禁用。 这是因为 GitHub AE 为安全边界提供了不符合自托管运行器工作方式的保证。 但是,如果您确实需要使用具有 GitHub AE 的自托管运行器并了解安全的意义,可以联系 GitHub 支持以了解将会启用自托管运行器的安全异常。

如果您不需要自托管的运行器,则可使用 AE 托管的运行器 来运行您的工作流程。 更多信息请参阅“关于 AE 托管的运行器”。

简介

本教程演示如何使用 Alex-page/github-project-automation-plus 操作在议题被分配时将议题自动移到项目板上的特定列。 例如,在分配议题时,您可以将其移入项目板的 In Progress 列。

在教程中,您将先创建一个使用 alex-page/github-project-automation-plus 操作的工作流程文件。 然后,您将自定义工作流以适应您的需要。

创建工作流程

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

  2. 在仓库中,选择项目板。 您可以使用现有项目,也可以创建新项目。 有关创建项目的更多信息,请参阅“创建项目板”。

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

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

    YAML
    name: Move assigned card
    on:
      issues:
        types:
          - assigned
    jobs:
      move-assigned-card:
        runs-on: ubuntu-latest
        steps:
          - uses: alex-page/github-project-automation-plus@v0.3.0
            with:
              project: Docs Work
              column: In Progress
              repo-token: ${{ secrets.PERSONAL_ACCESS_TOKEN }}
  5. 自定义工工作流程文件中的参数:

    • project 的值更改为您的项目板的名称。 如果您有多个具有相同名称的项目板, Alex-page/github-project-automation-placement-plus 将对所有具有指定名称的项目采取行动。
    • column 的值更改为您想要在议题分配时将议题移入其中的列名称。
    • 更改 repo-token 的值:
      1. 使用 repo 范围创建个人访问令牌。 更多信息请参阅“创建个人访问令牌”。
      2. 将此个人访问令牌作为机密存储在仓库中。 有关存储机密的更多信息,请参阅“加密密码”。
      3. 在您的工作流程文件中,将 PERSONAL_ACCESS_TOKEN 替换为您的机密名称。
  6. 将工作流程文件提交到仓库的默认分支。 更多信息请参阅“创建新文件”。

测试工作流程

每当分配仓库中的议题时,议题将移到指定的项目板列。 如果议题尚未在项目板上,则将添加到项目板中。

如果您的仓库是用户所有,则 Alex-page/github-project-automation-plus 操作将对仓库或用户帐户中具有指定项目名称和列的所有项目执行。 同样,如果您的仓库归组织所有,则该操作将对仓库或组织中具有指定项目名称和列的所有项目执行。

通过在仓库中分配议题来测试工作流程。

  1. 在仓库中打开一个议题。 更多信息请参阅“创建议题”。
  2. 分配议题。 更多信息请参阅“分配议题和拉取请求到其他 GitHub 用户”。
  3. 要查看分配议题所触发的工作流程运行,请查看工作流程运行的历史记录。 更多信息请参阅“查看工作流程运行历史记录”。
  4. 工作流程完成后,分配的议题应会添加到指定的项目板列中。

后续步骤

此文档对您有帮助吗?隐私政策

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

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

做出贡献

或, 了解如何参与。