DevOps チェンジベロシティへのオンボードGitHub - クラシック

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間:3分
  • GitHub インスタンスを接続して、リポジトリ、計画、およびパイプラインを検出、構成、およびインポートします。

    始める前に

    必要なロール:sn_devops.admin または sn_devops.tool_owner

    ツールに接続する前に、「 はじめに 」セクションで指定された手順を完了してください。

    このタスクについて

    • DevOpsツールレコードを送信するときに、GitHubに接続して Webhook URL を取得します。
    • リポジトリとプランを検出します。
    • GitHub リポジトリで Webhook を構成します。
    • 分岐レコードとコミットレコードをインポートします。

    手順

    1. に移動して DevOps チェンジベロシティに接続するための GitHub インスタンスの詳細を入力します すべて > DevOps > ツール > 新規作成 (従来).
    2. [ ツール名 ] フィールドに値を入力し、ツールの詳細を入力します。
      表 : 1. [DevOps ツールを作成] フォーム
      Field (フィールド) Description (説明)
      ツール統合

      統合するためのツール。この場合は、 [GitHub] を選択します。

      ツール URL

      統合する既存の GitHub インスタンスの URL。たとえば、https://api.github.com

      GitHub 認証情報タイプ
      • ベーシック認証
        • GitHub ユーザー名
        • 個人アクセストークン (クラシック)

        ベーシック認証では、個人アクセストークン (クラシック) のみがサポートされます。GitHub 用の個人アクセストークン (クラシック) を生成するときに、完全なアクセスを許可しない場合に認可するスコープを指定する必要があります。認証のために選択する必要がある最小スコープは、repo、admin:repo_hook、および user:email です。

      • OAuth

        GitHub ツールの認証情報。「の GitHub OAuth 2.0 認証情報の設定 DevOps チェンジベロシティ」を参照してください。

      GitHub に接続するために資格情報に必要なすべてのアクセス許可の一覧については、「DevOpsツールに必要な権限 のアクセス許可GitHub」を参照してください。

    3. オプション: MID サーバーに接続されているオンプレミスツールの MID サーバー を選択します。

      アプリケーションは自動的に DevOps に設定され、機能は REST に設定されます。

      注:
      GitHub Enterprise Server (オンプレミスインスタンス) の場合、MID サーバーを使用して接続している場合、OAuth はサポートされません。
    4. [送信] を選択します。
    ツールの作成が成功すると、ツールレコードページに移動します。
    1. [ 検出 ] を選択して、ツールの既存のリポジトリ、プラン、またはパイプラインを検出します。
      リポジトリレコードが [リポジトリ] 関連リストに追加されます。
    2. [構成] を選択して、DevOps ツールに通知を送信するように GitHub リポジトリ内の Webhook URL を自動的に構成します。
      または、[ ポーリングを有効にする ] プロパティを [ はい] に設定することで、夜間ポーリングを有効にして、追跡対象のリポジトリまたはパイプラインのデータ システムをフェッチすることもできます。
      注:
      GitHub ツールのアドミン権限がない場合 (Webhook URL の自動構成を許可するため)、ツールアドミンユーザーに構成してもらう必要がある場合があります (ツールインスタンスで Webhook URL を手動で作成して構成します)。ツールで Webhook を構成したら、手動構成モードに入り、ツールに手動で接続してから終了します。
    3. [ インポート ] をクリックして、リポジトリから履歴データをインポートします。
      リポジトリからインポートされた分岐レコードとコミットレコードは、対応する関連リストに追加されます。
    4. [ アプリケーション ] フィールドで、ルックアップリストをクリックし、リポジトリに関連付けるアプリレコードを選択するか、[ 新規 ] をクリックして作成します。