GitHub リポジトリのウェブトリガー

GitHub リポジトリのウェブトリガーは、GitHub 組織内のリポジトリをイベントのために監視するために使用されます。 リポジトリでイベントが発生すると、トリガーが作動し、自動化ワークフローが開始されます。

GitHub 組織内のリポジトリにトリガーをマッピングし、リポジトリ内でイベントが発生したときに自動化を実行するようにトリガーを設定します。

GitHub リポジトリのウェブトリガーは、リポジトリ内の以下のイベントをサポートしています:
  • 作成
  • フォーク
  • コメントを発行
  • 問題
  • ラベル
  • プルリクエスト
  • プルリクエストレビュー
  • プッシュ
  • スター
  • ウォッチ

例えば、GitHub組織内のリポジトリをプルリクエストのために監視するGitHubリポジトリウェブトリガーを作成します。 監視対象のリポジトリにプルリクエストが作成されると、トリガーがアクティブになり、自動化の次のアクションが開始されます。

前提条件

  • Bot Creator または 市民開発者 ライセンスが必要です。
  • マイ Bot を表示 権限を持っている必要があります。
  • そのロールのためのすべての EVENT TRIGGERS 権限を持っている必要があります。
  • 自動化が存在するフォルダーに対する [チェックイン] および [チェックアウト] 権限を持っている必要があります。
  • Control Roomにログインしている必要があります。
  • GitHub ウェブトリガーは、ユーザープロファイルの認証に パーソナルアクセストークン を使用します。 GitHubウェブトリガーは、クラシックおよびファイングレインアクセストークンをサポートしています。 ユーザー設定で パーソナルアクセストークン を生成し、それを GitHub に保存してくださいCredential Vault。 パーソナルアクセストークン の作成と管理の詳細については、パーソナルアクセストークンの管理 を参照してください。

手順

  1. 左側のペインで [オートメーション] をクリックします。
  2. [作成] > [タスク Bot] をクリックします。
    タスクBotを作成ウィザードが表示されます。
  3. [名前] フィールドにBotの適切な名前を入力します。
    デフォルトでは、すべてのBotは \Bots フォルダーに保存されます。
  4. オプション: 説明 フィールドにBotの説明を追加できます。
  5. オプション: 選択ボタンを使用して、Botを別のフォルダーに保存できます。
  6. [作成と編集] をクリックします。
    Botが作成され、タスクBotの編集が表示されます。
  7. トリガー > GitHubをクリックし、その後リポジトリウェブトリガーをダブルクリックするかドラッグしてトリガーセクションにウェブトリガーを追加します。
  8. イベントを聞くドロップダウンから、1つまたは複数のイベントを選択してください。
  9. Enter the GitHub [リポジトリ名] フィールドに リポジトリ名 を入力します。
  10. ユーザープロファイルにGitHubプロファイル名を入力してください。
  11. 認証タイプを選択 セクションで、次のいずれかを選択します。
    認証タイプを選択で、個人アクセストークンがデフォルトの認証タイプとして選択されています。
    • 資格情報: [選択] をクリックして、Credential Vaultですでに設定されている 個人用アクセス トークン を選択します。
    • 安全でない文字列: GitHub の開発者設定で生成された個人アクセストークン文字列をコピーして貼り付けてください。
      注: パーソナルアクセストークン が期限切れでないことを確認してください。
  12. オプション: レスポンス オプションのトリガーに変数を追加します。 変数の詳細については、[変数の概要]を参照してください。
    注: 応答に既存の変数を使用する場合は、変数の 入力として使用 チェックボックスが有効になっていることを確認してください。
  13. オプション: 必要に応じて トリガー セクションにトリガーを追加してください。
  14. [アクション] パレットから適切なアクションを [アクション] セクションにダブルクリックするか、ドラッグします。
    アクションの詳細については、[オートメーション構築のアクション]を参照してください。
  15. [保存] をクリックして Bot を保存します。
Botをトリガーで実行すると、Webトリガーがアクティブになり、問題、星、ウォッチイベントを待ち受けます。 リポジトリ内でイベントの1つが発生すると、トリガーが次の メッセージ ボックス アクションを開始します。