GitHubDevOps チェンジベロシティとの統合

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間:4分
  • GitHubインスタンスに接続して、リポジトリ、計画、パイプライン定義を検出し、リアルタイム通知またはポーリングを構成して、変更のトレーサビリティと自動化を有効にします。

    GitHub 統合の概要

    DevOps チェンジベロシティ は、 GitHub ツールの計画 (プラン)、コード (リポジトリ)、オーケストレーション (アクション) 機能をサポートしています。

    GitHubGitHub Enterprise の両方がサポートされています。

    GitHubの統合の一環として、次の操作が実行されます。
    • 接続: GitHub インスタンスを DevOps チェンジベロシティに接続して、リポジトリ、計画、パイプライン定義を検出します。
    • 構成:GitHub で Webhook (プッシュ、問題、およびworkflow_job) を自動的に作成して、コミット、作業アイテム、パイプラインのリアルタイム通知を送信できるようにし、このデータを使用して変更ポリシーを作成できるようにします。
    Organization のリポジトリは、Organization に対して次の基本権限 (メンバー権限) を持っている場合にも検出および構成できます。
    • 検出:読み取りの基本権限。
    • 構成:アドミンの基本権限。
    [基本権限] が [Organization の アクセス許可なし ] として指定されている場合、その組織のリポジトリは、パブリックであっても検出できません。Organization のオーナーは、Organization のすべてのリポジトリまたは特定のリポジトリを選択でき、選択したリポジトリのみが検出されます。リポジトリがパブリックであっても、オーナーが Organization に対して選択しない限り、そのリポジトリは検出されません。

    組織のリポジトリでは、インスタンス上の複数のツールで同じリポジトリを構成することはできません。複数のツールに同じリポジトリが構成されている場合、データは通知イベントの一部としてランダムなツールに関連付けられます。別のツールで同じリポジトリを構成する場合は、最初のツールから作成された Webhook を削除し、そのツールのリポジトリの追跡を解除してから、別のツールで同じリポジトリを構成する必要があります。

    認証方法

    次のいずれかの認証方法を使用して GitHub に接続できます。
    • 基本認証

      GitHub インスタンスをベーシック認証で接続すると、GitHub マーケットプレイスのカスタムアクションを使用できます。GitHub 環境は、基本認証接続ではサポートされていません。

    • OAuth 2.0 認証情報
      • GitHub インスタンスを認証コードの OAuth 2.0 認証情報に接続すると、GitHub マーケットプレイスのカスタムアクションを使用して、ワークフローで使用するシークレットを作成できます。詳細については、「GitHub アプリの OAuth 2.0 認証情報 - 認証コード」を参照してください。
      • GitHub インスタンスを GitHub アプリ - JWT の OAuth 2.0 認証情報に接続すると、GitHub マーケットプレイスのカスタムアクションを使用し、ワークフローと GitHub 環境で使用するシークレットを作成して環境に展開できます。詳細については、「GitHub アプリの OAuth 2.0 認証情報 - JWT」を参照してください。Organization の下にある GitHub リポジトリの場合、ツールごとにインストールできる Organization は 1 つだけです (つまり、One GitHub App は One GitHub Org と One GitHub ツールでインストールできます)。組織をさらに追加する場合は、個別のツールとアプリを作成できます。
    注:
    OAuth 認証コード権限許可タイプは、GitHub および MID サーバーを使用する GitHub Enterprise でサポートされています。

    ServiceNowによるカスタムアクションは、オーケストレーション機能GitHub、アクション (ワークフロー) から情報をプッシュしたり、DevOps チェンジベロシティからワークフローを一時停止または再開したりするために、マーケットプレイスで使用できます。カスタムアクションの詳細については、「 GitHub マーケットプレイスからの ServiceNow DevOps カスタムアクション」を参照してください。

    DevOps チェンジベロシティでワークフローデータをキャプチャするには、GitHubツールでシークレットを構成する必要があります。詳細については、「GitHub Actions構成」を参照してください。

    GitHub Actionsサポートにはいくつかの制限があります。GitHub Actions構成を参照してください。

    始めましょう

    GitHubをオンボーディングするには、次のいずれかのオプションを使用します。ガイド付きエクスペリエンスの場合は、ワークスペースを使用してツールをオンボーディングします。または、サービスカタログまたはクラシックエクスペリエンスを使用することもできます。