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

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間:4分
  • 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. ツールへのアクセスを制御する場合は、ツールへのアクセス権を付与する必要があるグループを [アクセス] タブの [保守担当者] フィールドに追加します。
      グループ内のユーザーが実行できるタスクは、割り当てられたロールによって異なります。
      • DevOps ツールオーナーロール:ツールを表示および編集できます。
      • DevOps アプリオーナーロール:ツールを表示し、ツールのオブジェクト (プラン、リポジトリ、パイプラインなど) の関連付け、検出、履歴データのインポート、パイプラインステップの変更 (該当する場合) を実行できます。
      • DevOps 管理者ロール:すべてのツールを編集できます。
      • その他の DevOps ロール:ツールを表示できます。
      注:
      DevOpsロールを持つユーザーを含むグループのみが[保守担当者]フィールドで選択できます。

      ツールへのアクセスを制限することを選択した場合、[ すべてのアプリ所有者がツールオブジェクトを表示してアプリケーションに関連付けることができる ] オプションを選択できるようになります。このオプションを使用すると、 DevOps アプリオーナーロールを持つすべてのユーザーがツールにアクセスできます。選択すると、ツールのオブジェクトの表示、関連付け、検出、履歴データのインポート、およびパイプライン ステップの変更 (該当する場合) が可能になります。

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