Issue にラベルを追� する

注: GitHub ホステッドランナーは、現在 GitHub Enterprise Server でサポートされていません。 GitHub public roadmap で、今後の計画的なサポートの詳細を確認できます。

はじめに

このチュートリアルでは、ワークフローで actions/github-script アクションを使用して、新しくオープンまたは再オープンした Issue にラベルを付ける方法を示します。たとえば、Issue をオープンまたは再オープンするたびに triage ラベルを追� できます。次に、triage ラベルで Issue をフィルター処理して、トリアージする必要のあるすべての Issue を確認できます。

actions/github-script アクションを使うと、ワークフローで GitHub API を簡単に使用できます。

チュートリアルでは、actions/github-script アクションを使用するワークフローファイルをまず作成します。次に、ニーズに合わせてワークフローをカスタマイズします。

ワークフローの作成

このプロジェクト管理ワークフローを適用したいリポジトリを選択してく� さい。書き込みアクセス権を持つ既存のリポジトリを利用することも、新しいリポジトリを作成することもできます。リポジトリの作成の詳細については、「新しいリポジトリの作成」を参照してく� さい。
リポジトリに .github/workflows/YOUR_WORKFLOW.yml というファイルを作成します (YOUR_WORKFLOW は任意の名前に置き換えます)。これがワークフローファイルです。 GitHub での新しいファイルの作成の詳細については、「新しいファイルの作成」を参照してく� さい。

次の YAML コンテンツをワークフローファイルにコピーします。

YAML

name: Label issues
on:
  issues:
    types:
      - reopened
      - opened
jobs:
  label_issues:
    runs-on: ubuntu-latest
    permissions:
      issues: write
    steps:
      - uses: actions/github-script@v5
        with:
          script: |
            github.rest.issues.addLabels({
              issue_number: context.issue.number,
              owner: context.repo.owner,
              repo: context.repo.repo,
              labels: ["triage"]
            })

ワークフローファイルの script パラメーターをカスタマイズします。
- issue_number、owner、repo の値は、context オブジェクトを使って自動的に設定されます。これらを変更する必要はありません。
- labels の値を、Issue に追� するラベルのリストに変更します。複数のラベルはコンマで区切ります。たとえば、「 ["help wanted", "good first issue"] 」のように入力します。ラベルの詳細については、「ラベルを管理する」を参照してく� さい。
ワークフローファイルを、リポジトリのデフォルトブランチにコミットしてく� さい。詳細については、「新しいファイルの作成」を参照してく� さい。

ワークフローのテスト

リポジトリ内の Issue をオープンするか再オープンするたびに、このワークフローは指定したラベルを Issue に追� します。

リポジトリに Issue を作成して、ワークフローをテストします。

リポジトリで Issue を作成します。詳細については、「Issue の作成」を参照してく� さい。
Issue の作成によってトリガーされたワークフローの実行を確認するには、ワークフローの実行履歴を表示します。詳細については、「ワークフロー実行の履歴を表示する」を参照してく� さい。
ワークフローが完了すると、作成した Issue に指定されたラベルが追� されます。

次の手� �

actions/github-script アクションで実行できる追� の機能について詳しくは、actions/github-script アクションのドキュメントにアクセスしてく� さい。
ワークフローをトリガーできるさまざまなイベントの詳細については、「ワークフローをトリガーするイベント」を参照してく� さい。
このアクションを使用するワークフローの例については GitHub を検索してく� さい。

Issue にラベルを追� する

この記事では、次の� �目が扱われます。

はじめに

ワークフローの作成

ワークフローのテスト

次の手� �