ドキュメントには頻繁に更新が加えられ、その都度公開されています。本ページの翻訳はまだ未完成な部分があることをご了承ください。最新の情報については、英語のドキュメンテーションをご参照ください。本ページの翻訳に問題がある場合はこちらまでご連絡ください。

Removing a label when a card is added to a project board column

You can use GitHub Actions to automatically remove a label when an issue or pull request is added to a specific column on a project board.

GitHub ActionsはGitHub Free、GitHub Pro、GitHub FreeのOrganization、GitHub Team、GitHub Enterprise Cloud、GitHub Enterprise Server、GitHub One、GitHub AEで利用できます。 GitHub Actionsは、レガシーのリポジトリごとのプランを使っているアカウントが所有しているプライベートリポジトリでは利用できません。 詳しい情報については「GitHubの製品」を参照してください。

ここには以下の内容があります:

はじめに

This tutorial demonstrates how to use the andymckay/labeler action along with a conditional to remove a label from issues and pull requests that are added to a specific column on a project board. For example, you can remove the needs review label when project cards are moved into the Done column.

In the tutorial, you will first make a workflow file that uses the andymckay/labeler action. Then, you will customize the workflow to suit your needs.

ワークフローの作成

  1. このプロジェクト管理ワークフローを適用したいリポジトリを選択してください。 書き込みアクセス権を持つ既存のリポジトリを利用することも、新しいリポジトリを作成することもできます。 リポジトリの作成に関する詳細は「新しいリポジトリの作成」を参照してください。

  2. Choose a project that belongs to the repository. This workflow cannot be used with projects that belong to users or organizations. You can use an existing project, or you can create a new project. For more information about creating a project, see "Creating a project board."

  3. リポジトリに、.github/workflows/YOUR_WORKFLOW.ymlというファイルをYOUR_WORKFLOWの部分を選択した名前で置き換えて作成してください。 これがワークフローファイルです。 GitHub上での新しいファイルの作成に関する詳しい情報については「新しいファイルの作成」を参照してください。

  4. Copy the following YAML contents into your workflow file.

    YAML
    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@master
            with:
              remove-labels: "needs review"
  5. Customize the parameters in your workflow file:

    • In github.event.project_card.column_id == '12345678', replace 12345678 with the ID of the column where you want to un-label issues and pull requests that are moved there.

      To find the column ID, navigate to your project board. Next to the title of the column, click then click Copy column link. The column ID is the number at the end of the copied link. For example, 24687531 is the column ID for https://github.com/octocat/octo-repo/projects/1#column-24687531.

      If you want to act on more than one column, separate the conditions with ||. For example, if github.event.project_card.column_id == '12345678' || github.event.project_card.column_id == '87654321' will act whenever a project card is added to column 12345678 or column 87654321. The columns may be on different project boards.

    • Change the value for remove-labels to the list of labels that you want to remove from issues or pull requests that are moved to the specified column(s). Separate multiple labels with commas. For example, "help wanted, good first issue". For more information on labels, see "Managing labels."

  6. ワークフローファイルを、リポジトリのデフォルトブランチにコミットしてください。 詳細は「新しいファイルを作成する」を参照してください。

Testing the workflow

Every time a project card on a project in your repository moves, this workflow will run. If the card is an issue or a pull request and is moved into the column that you specified, then the workflow will remove the specified labels from the issue or a pull request. Cards that are notes will not be affected.

Test your workflow out by moving an issue on your project into the target column.

  1. Open an issue in your repository. For more information, see "Creating an issue."
  2. Label the issue with the labels that you want the workflow to remove. For more information, see "Managing labels."
  3. Add the issue to the project column that you specified in your workflow file. 詳しい情報については、「プロジェクトボードに Issue およびプルリクエストを追加する」を参照してください。
  4. To see the workflow run that was triggered by adding the issue to the project, view the history of your workflow runs. 詳しい情報については、「ワークフロー実行の履歴を表示する」を参照してください。
  5. When the workflow completes, the issue that you added to the project column should have the specified labels removed.

次のステップ

  • To learn more about additional things you can do with the andymckay/labeler action, like adding labels or skipping this action if the issue is assigned or has a specific label, visit the andymckay/labeler action documentation.
  • Search GitHub for examples of workflows using this action.

Did this doc help you?

Privacy policy

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

OR, learn how to contribute.