DevOps 変更速度管理へのオンボードGitLab —ワークスペース
DevOps 変更ワークスペースプレイブックを使用して GitLab インスタンスに接続し、計画、リポジトリ、パイプラインを検出します。
始める前に
DevOps 変更速度管理 の使用を開始するにはトピックで指定されたタスクを完了します。
必要なロール: sn_devops.admin または sn_devops.tool_owner
手順
-
移動先 ワークスペース > DevOps 変更ワークスペース をクリックし、次のいずれかのオプションを使用してプレイブックを開き、 GitLabをオンボーディングします。
オプション ステップ ホームページ - [ツールを接続] を選択します。
- [ツールに接続] モーダルで、適切なカテゴリからツールを選択します。たとえば、コーディングツールとして GitLab に接続する場合は、[コード] カテゴリで [GitLab] を選択します。
アプリケーションモジュール - プライマリナビゲーションから [アプリケーション] (
) を選択します。
- 既存のアプリケーションを選択するか、新規作成します。アプリケーションを作成する場合は、アプリケーションを作成 - ワークスペース を参照します。
- [推奨アクション] ペインから、[ツールを接続] カードを選択します。
- [ツールに接続] モーダルで、適切なカテゴリからツールを選択します。たとえば、コーディングツールとして GitLab に接続する場合は、[コード] カテゴリで [GitLab] を選択します。
ツールモジュール - プライマリナビゲーションから [ツール] (
を選択します。
- [機能] リストから適切なカテゴリを選択します。たとえば、コーディングツールとして GitLab に接続する場合は、[コーディング] カテゴリを選択します。
- [ツールを接続] を選択します。
- [ツールに接続] モーダルで、[ GitLab] を選択します。
重要:ツールへの接続中にプラン、パイプライン、リポジトリなどのツールオブジェクトを検出して追跡する場合は、アプリケーションモジュールからツールを接続する必要があります。 -
[ツール名] フィールドに、ツールの名前を入力します。
-
[次へ] を選択します。
オンボーディングタスクを完了するのに役立つ DevOps プレイブックが開きます。
-
GitLabインスタンスの詳細を入力します。
- GitLab インスタンスの URL を入力します。
-
[認証情報タイプ] フィールドで、一つ選択します。
- 基本認証
- OAuth 2.0
-
認証情報を入力します。
- 基本認証: GitLab インスタンスのユーザー名とパスワード/アクセストークンを入力します。注:個人アクセストークンのみがサポートされています。トークンを生成するときは、スコープ API を選択し、すべてのグループとプロジェクト、コンテナーレジストリ、パッケージレジストリを含む読み取り/書き込みアクセス権を付与します。
- OAuth 2.0: OAuth 認証情報を入力します。
OAuth2.0 の認証情報の詳細については、「DevOps 向けの GitLab OAuth 2.0 認証情報の設定」を参照してください。
- 基本認証: GitLab インスタンスのユーザー名とパスワード/アクセストークンを入力します。
- オプション:
GitLab インスタンスがMID サーバーに添付されている場合は、[MID サーバー] オプションを選択し、その詳細を入力します。
MID サーバーの詳細については、「MID サーバーの選択」を参照してください
-
[接続] を選択します。
-
入力した認証情報に対して権限チェックが実行されます。
必要な権限と利用可能な権限が表示されます。より適切なアクセス許可を持つ認証情報を入力する場合は、[認証情報を再入力] を選択します。必要なすべての権限の詳細については、「DevOps ツールに必要な権限 の GitLab 権限」を参照してください。
必要なすべての権限がない場合でも、ツール接続を続行することを選択できます。
- [次へ] を選択します。
-
ツールのアクセス権を指定します。
- ツールへのアクセスを制御する場合は、ツールへのアクセス権を付与する必要があるグループを [保守担当者 ] フィールドに追加します。グループ内のこれらのユーザーが実行できるタスクは、割り当てられたロールによって異なります。
- DevOps ツールオーナーロール: ツールを表示および編集できます。
- DevOps アプリオーナーロール: ツールを表示し、ツールのオブジェクト (プラン、リポジトリ、パイプラインなど) の関連付け、検出、履歴データのインポート、パイプラインステップの変更 (該当する場合) を実行できます。
- DevOps 管理者ロール: すべてのツールを編集できます。
- その他の DevOps ロール: ツールを表示できます。
注:グループを選択せずにこの手順をスキップすると、 DevOps ツールオーナーロールを持つすべてのユーザーがツールを編集できます。 - ツールへのアクセスを制御することを選択した場合、 すべてのアプリ所有者がツールオブジェクトを表示してアプリケーションに関連付けることができる オプションが選択可能になります。
このオプションを使用すると、 DevOps アプリオーナーロールを持つすべてのユーザーがツールにアクセスできます。選択すると、ツールのオブジェクトの表示、関連付け、検出、履歴データのインポート、およびパイプラインステップの変更 (該当する場合) が可能になります。
- [アサイン] を選択します。
- ツールへのアクセスを制御する場合は、ツールへのアクセス権を付与する必要があるグループを [保守担当者 ] フィールドに追加します。
-
Webhook を自動的に構成するプロジェクトを選択します。
また、管理モジュールの [ポーリングを有効にする] プロパティオプションを選択することで、夜間ポーリングを有効にして追跡対象のパイプラインのデータを取得することもできます。「DevOps 変更速度管理のプロパティ」を参照してください。
-
[構成] を選択します。
手動で構成するには、[ 手動で構成] を選択します。詳細については、「Webhook をGitLab で手動で構成」を参照してください。
重要:- ホームページまたはツールモジュールから接続している場合は、接続が完了し、[概要] ページに移動します。
- アプリケーションモジュールから接続している場合は、プロジェクトで利用可能なプラン、リポジトリ、およびパイプラインが検出されます。それらから履歴データを追跡してインポートできます。
-
アプリケーションに関連付けるパイプラインを選択し、[ パイプラインの関連付け] を選択します。
選択したパイプラインごとに、最後の正常な実行のすべてのステップがインポートされます。
- オプション:
[パイプラインステップにサービスをアサイン] アクティビティで、各パイプラインステップの ステップタイプ と サービス を指定します。
このステップをツールオンボーディングの一環として完了すると、 DevOps インサイト ダッシュボードに意味のあるデータがより多く即座に表示されるようになります。
- アプリケーションに関連付ける計画を選択し、[ 計画の関連付け] を選択します。
- アプリケーションに関連付けるリポジトリを選択し、 [リポジトリの関連付け] を選択します。
-
[履歴データのインポート] ステップで、[ 開始日 ] フィールドと [終了日 ] フィールドで日付範囲を選択し、[ データのインポート] を選択します。
注:最大 90 日間のデータをインポートできます。
- [次へ] を選択します。
-
[ サマリー ] ページで、正常に接続された GitLab ツールの詳細を確認します。
[ ツールレコードを表示 ] を選択して、接続されたインスタンスの詳細を確認します。