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. 認証タイプを選択 セクションで、次のいずれかを選択します。
    認証タイプを選択で、個人アクセストークンがデフォルトの認証タイプとして選択されています。
    • 資格情報: [選択] をクリックして、Credential Vaultですでに設定されている 個人用アクセス トークン を選択します。
    • 安全でない文字列: GitHub の開発者設定で生成された個人アクセストークン文字列をコピーして貼り付けてください。
      注: パーソナルアクセストークン が期限切れでないことを確認してください。
  11. オプション: レスポンス オプションのトリガーに変数を追加します。 変数の詳細については、[変数の概要]を参照してください。
    注: 応答に既存の変数を使用する場合は、変数の 入力として使用 チェックボックスが有効になっていることを確認してください。
  12. オプション: 必要に応じて トリガー セクションにトリガーを追加してください。
  13. [アクション] パレットから適切なアクションを [アクション] セクションにダブルクリックするか、ドラッグします。
    アクションの詳細については、[オートメーション構築のアクション]を参照してください。
  14. [保存] をクリックして Bot を保存します。
Botをトリガーで実行すると、Webトリガーがアクティブになり、フォークイシューラベルイベントを待ち受けます。 組織内でイベントの1つが発生すると、トリガーがその後の メッセージ ボックス アクションを開始します。