GitLab の登録 (アカウントレベル)エージェントスペースへのプロジェクトの接続コードレビューと自動テストの設定 GitLab 接続の管理

GitLab の接続

GitLab 統合により、 AWS DevOps Agent は GitLab Pipelines からのデプロイをモニタリングし、インシデント対応中に因果調査に通知できます。この統合は、GitLab のアカウントレベルの登録と、特定のプロジェクトを個々のエージェントスペースに接続するという 2 つのステップのプロセスに従います。

GitLab の登録 (アカウントレベル)

GitLab は AWS アカウントレベルで登録され、そのアカウントのすべてのエージェントスペース間で共有されます。各登録は、1 人の GitLab ユーザーまたは 1 つの GitLab グループにリンクされます。

ステップ 1: パイプラインプロバイダーに移動する

AWS マネジメントコンソールにサインインする
AWS DevOps エージェントコンソールに移動する
機能プロバイダーページに移動する (サイドナビゲーションからアクセス可能)
Pipeline の「利用可能なプロバイダー」セクションで GitLab を検索し、登録を選択します

ステップ 2: GitLab 接続を設定する

GitLab 登録ページで、以下を設定します。

接続タイプ – 人として接続するかグループとして接続するかを選択します。

Personal (デフォルト) – ユーザー名とプロファイルを持つ個々の GitLab ユーザーアカウント
グループ – GitLab では、グループを使用して 1 つ以上の関連プロジェクトを同時に管理します。

GitLab インスタンスタイプ – 接続先の GitLab インスタンスのタイプを選択します。

GitLab.com (デフォルト) – パブリック GitLab サービス
パブリックにアクセス可能なセルフホスト型 GitLab – GitLab セルフホストエンドポイントの使用チェックボックスをオンにし、GitLab インスタンスへの URL を指定します。

注記

現在、パブリックにアクセス可能な GitLab インスタンスのみがサポートされています。

アクセストークン – GitLab 個人用アクセストークンを提供します。

別のブラウザタブで、GitLab アカウントにログインします。
ユーザー設定に移動し、アクセストークンを選択する
次のアクセス許可を持つ新しい個人用アクセストークンを作成します。
- read_repository – リポジトリコンテンツにアクセスするために必要です
- read_virtual_registry – 仮想レジストリ情報にアクセスするために必要です
- read_registry – レジストリ情報にアクセスするために必要です
- api – 読み取りおよび書き込み API アクセスに必要です
- self_rotate - トークンのローテーションに必要です。この機能は現在、 AWS DevOps エージェントではサポートされていませんが、後日サポートされる予定です。これでを追加すると、今後新しいトークンを作成する必要がなくなります。
トークンの有効期限を現在の日付から最大 365 日に設定します。
生成されたトークンをコピーする
AWS DevOps エージェントコンソールに戻る
トークンを「アクセストークン」フィールドに貼り付けます。

ステップ 3: 登録を完了する

(オプション) タグ – 組織の目的で GitLab 登録に AWS タグを追加します。

Next を選択して設定を確認し、Submit を選択して GitLab 登録プロセスを完了します。システムはアクセストークンを検証し、接続を確立します。

エージェントスペースへのプロジェクトの接続

アカウントレベルで GitLab を登録したら、特定のプロジェクトを個々のエージェントスペースに接続できます。

AWS DevOps エージェントコンソールで、エージェントスペースを選択します。
機能タブに移動する
パイプラインセクションで、追加を選択します。
利用可能なプロバイダーのリストから GitLab を選択する
使用するプロジェクトを含む GitLab 登録を選択します。
エージェントスペースに関連する GitLab プロジェクトを選択する
[保存] を選択します。

AWS DevOps Agent は、GitLab Pipelines からのデプロイについてこれらのプロジェクトをモニタリングし、因果調査を通知します。1 つのエージェントスペースで、複数の登録のプロジェクトを使用できます。別の登録からプロジェクトを追加するには、以下の手順を繰り返します。

コードレビューと自動テストの設定

GitLab 接続ステップでプロジェクトを選択すると、コードレビューと自動テストセクションに自動的に追加されます。このセクションでは、リリース準備状況コードレビューおよび自動テスト機能を自動的にトリガーするプロジェクトを設定します。

コードレビューと自動テストの設定には以下が含まれます。

機能 — 各プロジェクトのコードレビューと自動テスト機能を選択します。このセクションでは、プロジェクトごとに 2 つの設定を提供します。
- 自動トリガー変更レビュー — プロジェクトで有効にすると、DevOps Agent はマージリクエストがオープンまたは更新リリース準備状況コードレビューされるたびにを自動的に実行します。レビューの結果は、マージリクエストにインラインコメントとして表示されます。これは、接続されているすべてのプロジェクトでデフォルトで有効になっています。
- 自動検証テスト — プロジェクトで有効にすると、DevOps Agent はコードレビュー中にマネージド検証環境でコード変更を構築、実行、テストします。これにより、静的分析以外の機能検証が可能になります。詳細については、「自動検証テスト」を参照してください。これは、接続されているすべてのプロジェクトでデフォルトで有効になっています。
プロジェクトリスト — 接続ステップ中に選択したすべてのプロジェクトを表示します。検索フィールドを使用して、プロジェクトを名前でフィルタリングします。各プロジェクトには、両方の機能に対して独立したチェックボックスがあります。
ランタイムロール (オプション) — 選択したプロジェクトで自動機能を実行するために DevOps Agent が引き受ける IAM ロールを選択します。このロールは、プライベートパッケージレジストリやアーティファクトストレージシステムなど、ビルド中に必要な内部サービスにアクセスするときに使用されます。プライマリエージェントロールとは異なるロールを使用することをお勧めします。

自動レビューを設定するには:

プロジェクトを接続したら、GitLab 統合設定のコードレビューと自動テストセクションに移動します。
プロジェクトごとに、自動マージリクエストのレビューが必要かどうかに応じて、自動トリガー変更レビュー機能を有効または無効にします。
マネージド検証環境で自動検証テストを行うかどうかに応じて、プロジェクトごとに自動検証テスト機能を有効または無効にします。
必要に応じて、選択したプロジェクトで自動機能を実行するときに DevOps Agent が引き受けるランタイムロールドロップダウンから IAM ロールを選択します。
保存を選択して設定を適用します。

設定すると、自動トリガー変更レビューが有効になっているプロジェクト内の新しいマージリクエストによって、リリース準備状況コードレビューが自動的にトリガーされます。自動検証テストも有効になっている場合、レビューには検証環境での機能検証が含まれます。コードレビューの詳細については、「」を参照してくださいリリース準備状況コードレビュー。

GitLab 接続の管理

アクセストークンの更新 – アクセストークンの有効期限が切れるか、更新する必要がある場合は、アカウントレベルで GitLab 登録を変更することで、 AWS DevOps エージェントコンソールで更新できます。
接続されたプロジェクトの表示 – AWS DevOps エージェントコンソールで、エージェントスペースを選択し、機能タブに移動して、パイプラインセクションで接続されたプロジェクトを表示します。
GitLab 接続の削除 – GitLab プロジェクトをエージェントスペースから切断するには、パイプラインセクションで接続を選択し、削除を選択します。GitLab 登録を完全に削除するには、まずすべてのエージェントスペースから削除してから、アカウントレベルで登録を削除します。

ドキュメントの表記規則

GitHub の接続

MCP サーバーの接続