このページでは、ワークフロー自動化アクションカタログで利用可能なGitHub issueアクションのリファレンスを提供します。これらのアクションを使用すると、ワークフロー定義から直接、GitHubリポジトリ内のissueを作成、更新、一覧表示、および管理できます。
前提条件
ワークフロー自動化でGitHub issueアクションを使用する前に、以下を確認してください:
- ターゲットリポジトリへのアクセス権を持つGitHubアカウント。
- 必要な権限を持つGitHubパーソナルアクセストークン(PAT)。
- New Relic Secrets Serviceに保存されているPAT。
PAT認証を設定する
GitHub issueアクションは、Bearer資格情報として渡されるパーソナルアクセストークン(PAT)を使用して認証します。このアクションは2つのトークンタイプをサポートしています:
- Fine-grained PAT — Issues: Read and writeリポジトリ権限が必要です。
- Classic PAT — リポジトリスコープが必要です。
GitHub パーソナルアクセストークンを作成する
- GitHubで、Settings > Developer settings > Personal access tokensに移動します。
- Fine-grained tokens [Fine-grained トークン]またはTokens (classic) [トークン(クラシック)]を選択し、Generate new token [新しいトークンを生成]をクリックします。
- 必要な権限を設定します:細かい粒度のトークンの場合はIssues: Read and write、クラシックトークンの場合はリポジトリスコープ。
- 生成されたトークンをコピーしてください — GitHubでは1回のみ表示されます。
トークンをシークレットとして保存します
トークンをNew Relic Secrets Serviceに保存し、${{ :secrets:keyName }} 構文を使用してワークフローYAMLで参照してください:
token: ${{ :secrets:github-PAT-token }}利用可能なGitHub Issueアクション
以下の表に、利用可能なGitHub issueアクションとそのリファレンスページへのリンクを示します。
アクション名 | 説明 |
|---|---|
GitHubリポジトリに新しいIssueを作成します。 | |
既存のIssue(タイトル、本文、状態、担当者、ラベル、マイルストーン)を更新します。 | |
任意のフィルタリングを使用して、GitHubリポジトリ内のイシューを一覧表示します。 | |
イシュー番号を使用して、GitHubリポジトリから単一のイシューを取得します。 | |
GitHubのIssueをロックし、新しいコメントを追加できるユーザーを制限します。 | |
GitHub Issue から会話のロックを解除します。 | |
既存のGitHub issueに新しいコメントを作成します。 |