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

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間：4分

    • GitLab インスタンスを接続して、リポジトリとパイプラインを検出、構成、およびインポートします。

    始める前に

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

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

    このタスクについて

    • GitLab インスタンスの詳細を使用して接続します。
    • リポジトリとパイプラインを検出します。
    • GitLab で Webhook を構成します。
    • 分岐とコミットのレコード、タスクの実行とステップの実行のレコードをインポートします。

    手順

    1. DevOps チェンジベロシティに接続するGitLabインスタンスの詳細を入力します。
      1. 移動先 DevOps > ツール > 新規作成 (従来) レコードを作成します
      2. ツール名を入力し、ツールの詳細を入力します。
        ツール URL

        GitLab ツールの URL。

        例：

        https://gitlab.com
        ツールユーザー名 GitLab ユーザー名
        ツールパスワード/アクセストークン GitLab アクセストークン
        注:
        個人アクセストークンのみがサポートされています。トークンを生成するときは、スコープ API を選択し、すべてのグループとプロジェクト、コンテナー レジストリ、パッケージ レジストリを含む読み取り/書き込みアクセス権を付与します。

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

      3. オプション: MID サーバー に接続されているオンプレミスツールの MID サーバーを選択します。
        [アプリケーション] の値は自動的に [DevOps] に設定され、[機能] の値は [REST] に設定されます。
      4. [送信] をクリックします。
        ツールが正常に接続されました。
    ツールの作成が成功すると、ツールレコードページに移動します。
    1. ツールへのアクセスを制御する場合は、ツールへのアクセス権を付与する必要があるグループを [アクセス] タブの [保守担当者] フィールドに追加します。
      グループ内のユーザーが実行できるタスクは、割り当てられたロールによって異なります。
      • DevOps ツールオーナーロール:ツールを表示および編集できます。
      • DevOps アプリオーナーロール:ツールを表示し、ツールのオブジェクト (プラン、リポジトリ、パイプラインなど) の関連付け、検出、履歴データのインポート、パイプラインステップの変更 (該当する場合) を実行できます。
      • DevOps 管理者ロール:すべてのツールを編集できます。
      • その他の DevOps ロール:ツールを表示できます。
      注:
      DevOpsロールを持つユーザーを含むグループのみが[保守担当者]フィールドで選択できます。

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

    2. [ 検出] をクリックして既存のリポジトリとパイプラインを検出し、プロジェクトの [検索フィルター] ウィンドウのフィールドに入力します。
      注:
      GitLab 検出されるリポジトリとパイプラインは、これらのフィルター条件によって決定されます。追加のリポジトリを検出するには、プロジェクトフィルターを変更して結果を展開します。
      自分が所有 (推奨) 現在のユーザーが所有するプロジェクト内のリポジトリを検索します。
      現在、次のメンバー： 現在のユーザーがメンバーとなっているプロジェクト内のリポジトリを検索します。
      検索 指定したテキスト文字列を持つプロジェクト内のリポジトリを検索します。
      注:
      GitLab 検出されるリポジトリとパイプラインは、接続で構成された資格情報 (アクセスレベル) によっても決定されます。
      対応する関連リストにレコードが追加されます。
    3. [構成] を選択して、DevOps ツールに通知を送信するように GitLab リポジトリ内の Webhook URL を自動的に構成します。
      または、[ ポーリングを有効にする ] プロパティを [ はい] に設定することで、夜間ポーリングを有効にして、追跡対象のリポジトリまたはパイプラインのデータ システムをフェッチすることもできます。
    4. 検出されたリポジトリの場合は、ツールの履歴データをインポートし、リポジトリをアプリに関連付けます。
      1. [リポジトリ] 関連リストからリポジトリレコードを開き、[ インポート] をクリックします。
        リポジトリからインポートされた分岐レコードとコミットレコードは、対応する関連リストに追加されます。
      2. [ アプリケーション ] フィールドで、ルックアップリストをクリックし、リポジトリに関連付けるアプリレコードを選択するか、[ 新規 ] をクリックして作成します。
      インポートされた履歴データレコードは、対応する関連リストに追加されます。