注: GitHub 托管的运行器目前在 GitHub Enterprise Server 上不受支持。 您可以在 GitHub 公共路线图 上查看有关未来支持计划的更多信息。
简介
本教程演示如何使用 andymckay/labeler
操作以及条件从议题中� 除添� 到项目板上特定列中的� �签和拉取请求。 例如,您可以在项目卡移到 Done
列时� 除 needs review
� �签。
在教程中,您将先创建一个使用 andymckay/labeler
操作的工作流程文件。 然后,您将自定义工作流以适应您的需要。
创建工作流程
-
选择要应用此项目管理工作流程的仓库。 您可以使用您有写入权限的现有仓库,或者创建一个新的仓库。 关于创建仓库的更多信息,请参阅“创建新仓库”。
-
选择属于仓库的项目。 此工作流程不能用于属于用户或组织的项目。 您可以使用现有项目,也可以创建新项目。 有关创建项目的更多信息,请参阅“创建项目板”。
-
在您的仓库中,创建一个名为
.github/workflows/YOUR_WORKFLOW.yml
的文件,将YOUR_WORKFLOW
替换为您选择的名称。 这是一个工作流程文件。 有关在 GitHub 上创建新文件的更多信息,请参阅“创建新文件”。 -
将以下 YAML 内容复制到工作流程文件中。
YAML # 此工作流使用未经 GitHub 认证的操作。 # 它们由第三方提供,并受 # 单独的服务条款、隐私政策和支持 # 文档管理。 name: Remove labels on: project_card: types: - moved jobs: remove_labels: if: github.event.project_card.column_id == '12345678' runs-on: ubuntu-latest steps: - name: remove labels uses: andymckay/labeler@5c59dabdfd4dd5bd9c6e6d255b01b9d764af4414 with: remove-labels: "needs review" repo-token: ${{ secrets.GITHUB_TOKEN }}
-
自定义工工作流程文件中的参数:
-
在
github.event.project_card.column_id = "12345678"
中,将12345678
替换为要取消� �记移至其中的议题和拉取请求的列 ID。要查找列 ID,请导航到您的项目板。 在列� �题旁边,请单击 ,然后单击 Copy column link(复制列链接)。 列 ID 是复制的链接末尾的数字。 例如,
24687531
是https://github.com/octocat/octo-repo/projects/1#column-24687531
的列 ID。如果您想要在多个列上操作,请用
||
分隔条件。 例如,只要项目卡添� 到列12345678
或列87654321
,就会使用if github.event.project_card.column_id == '12345678' || github.event.project_card.column_id == '87654321'
。 这些列可能在不同的项目板上。 -
将
remove-labels
的值更改为您想要从移至指定列的议题或拉请求中� 除的� �签列表。 使用逗号分隔多个� �签。 例如"help wanted, good first issue"
。 有关� �签的更多信息,请参阅“管理� �签”。
-
-
将工作流程文件提交到仓库的默认分支。 更多信息请参阅“创建新文件”。
测试工作流程
每次仓库中项目上的项目卡移动时,此工作流程都会运行。 如果卡是议题或拉取请求,并移入您指定的列,则工作流程将从问题或拉取请求中� 除指定的� �签。 记事卡不会受到影响。
通过将项目上的议题移到目� �列中来测试工作流程。
- 在仓库中打开一个议题。 更多信息请参阅“创建议题”。
- 用� �签� �记您想要工作流程� 除的议题。 更多信息请参阅“管理� �签”。
- 将议题添� 到您在工作流程文件中指定的项目列。 更多信息请参阅“添� 议题和拉取请求到项目板”。
- 要查看通过将议题添� 到项目所触发的工作流程运行,请查看工作流程运行的历史记录。 更多信息请参阅“查看工作流程运行历史记录”。
- 当工作流程完成时,您添� 到项目列的议题应已� 除指定的� �签。
后续步骤
- 要详细了解可以使用
andymckay/labeler
操作执行的其他事务,如添� � �签或者在议题分配或具有特定� �签时跳过此操作,请访问andymckay/labeler
操作文档。 - 搜索 GitHub 以查看使用此操作的工作流程示例。