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

本文内容

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

简介

本教程演示如何在分配问题时使用 alex-page/github-project-automation-plus 操作自动将问题移至项目板上的特定列。 例如，分配问题后，可以将其移动到项目板的 In Progress 列中。

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

创建工作流程

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

  2. 在仓库中，选择项目板。 您可以使用现有项目，也可以创建新项目。 有关创建项目的详细信息，请参阅“创建 project (classic)”。

  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@7ffb872c64bd809d23563a130a0a97d01dfa8f43
        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 范围创建 personal access token (classic)。 有关详细信息，请参阅“管理个人访问令牌”。
      2. 将此 personal access token 存储为存储库中的机密。 有关存储机密的详细信息，请参阅“在 GitHub Actions 中使用机密”。
      3. 在工作流文件中，将 PERSONAL_ACCESS_TOKEN 替换为机密的名称。

  6. 将工作流程文件提交到仓库的默认分支。 有关详细信息，请参阅“创建新文件”。

测试工作流程

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

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

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

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

后续步骤