Skip to main content

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

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

注意:GitHub Enterprise Server 目前不支持 GitHub 托管的运行器。 可以在 GitHub public roadmap 上查看有关未来支持计划的更多信息。

简介

本教程演示如何在分配问题时使用 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
    # 此工作流使用未经 GitHub 认证的操作。
    # 它们由第三方提供,并受
    # 单独的服务条款、隐私政策和支持
    # 文档。
    
    # GitHub 建议将操作固定到提交 SHA。
    # 若要获取较新版本,需要更新 SHA。
    # 还可以引用标记或分支,但该操作可能会更改而不发出警告。
    
    name: Move assigned card
    on:
      issues:
        types:
          - assigned
    jobs:
      move-assigned-card:
        runs-on: ubuntu-latest
        steps:
          - uses: alex-page/github-project-automation-plus@5bcba1c1c091a222584d10913e5c060d32c44044
            with:
              project: Docs Work
              column: In Progress
              repo-token: ${{ secrets.PERSONAL_ACCESS_TOKEN }}
  5. 自定义工工作流程文件中的参数:

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

测试工作流程

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

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

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

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

后续步骤