注意
创建新的项目(经典版)现已禁用。项目(经典版)将于 2024 年 8 月 23 日停止使用并移除。您可以在 GitHub 博客 上了解更多有关此更改的信息。
新的改进版项目体验现已推出。有关更多信息,请参阅“关于项目”。
2024 年 8 月 23 日,所有剩余的项目(经典版)将在功能移除之前自动迁移。
简介
本教程演示了如何使用 alex-page/github-project-automation-plus
操作 在分配问题时自动将问题移动到项目(经典版)上的特定列。例如,当分配问题时,您可以将其移动到项目(经典版)的 进行中
列。
在本教程中,您将首先创建一个使用 alex-page/github-project-automation-plus
操作 的工作流程文件。然后,您将根据需要自定义工作流程。
创建工作流程
-
选择您要应用此项目管理工作流程的存储库。您可以使用您拥有写入权限的现有存储库,也可以创建一个新的存储库。有关创建存储库的更多信息,请参阅“创建新的存储库”。
-
在您的存储库中,选择一个项目(经典版)。
-
在您的存储库中,创建一个名为
.github/workflows/YOUR_WORKFLOW.yml
的文件,将YOUR_WORKFLOW
替换为您选择的名称。这是一个工作流程文件。有关在 GitHub 上创建新文件的更多信息,请参阅“创建新文件”。 -
将以下 YAML 内容复制到您的工作流程文件中。
YAML # This workflow uses actions that are not certified by GitHub. # They are provided by a third-party and are governed by # separate terms of service, privacy policy, and support # documentation. # GitHub recommends pinning actions to a commit SHA. # To get a newer version, you will need to update the SHA. # You can also reference a tag or branch, but the action may change without warning. 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 }}
# This workflow uses actions that are not certified by GitHub. # They are provided by a third-party and are governed by # separate terms of service, privacy policy, and support # documentation. # GitHub recommends pinning actions to a commit SHA. # To get a newer version, you will need to update the SHA. # You can also reference a tag or branch, but the action may change without warning. 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 }}
-
自定义工作流程文件中的参数
- 将
project
的值更改为您的项目(经典)的名称。如果您有多个具有相同名称的项目(经典),则alex-page/github-project-automation-plus
操作将对所有具有指定名称的项目起作用。 - 将
column
的值更改为要将问题分配后移动到的列的名称。 - 更改
repo-token
的值- 创建一个具有
repo
范围的个人访问令牌(经典)。有关更多信息,请参阅“管理您的个人访问令牌”。 - 将此个人访问令牌存储为您的存储库中的秘密。有关存储秘密的更多信息,请参阅“在 GitHub Actions 中使用秘密”。
- 在您的工作流文件中,将
PERSONAL_ACCESS_TOKEN
替换为您的秘密的名称。
- 创建一个具有
- 将
-
将您的工作流文件提交到您的存储库的默认分支。有关更多信息,请参阅“创建新文件”。
测试工作流
每当您的存储库中的问题被分配时,该问题将被移动到指定的项目(经典)列。如果该问题尚未在项目(经典)中,它将被添加到项目(经典)中。
如果您的存储库是用户拥有的,则alex-page/github-project-automation-plus
操作将对您存储库或个人帐户中所有具有指定项目名称和列的项目起作用。同样,如果您的存储库是组织拥有的,则该操作将对您存储库或组织中所有具有指定项目名称和列的项目起作用。
通过在您的存储库中分配一个问题来测试您的工作流。
- 在您的存储库中打开一个问题。有关更多信息,请参阅“创建问题”。
- 分配问题。有关更多信息,请参阅“将问题和拉取请求分配给其他 GitHub 用户”。
- 要查看分配问题触发的运行工作流,请查看工作流运行的历史记录。有关更多信息,请参阅“查看工作流运行历史记录”。
- 当工作流完成时,您分配的问题应该被添加到指定的项目(经典)列中。
下一步
- 要了解有关使用
alex-page/github-project-automation-plus
操作可以执行的其他操作的更多信息,例如删除或存档项目卡片,请访问alex-page/github-project-automation-plus
操作文档。