翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# GitLab の接続
<a name="connecting-to-cicd-pipelines-connecting-gitlab"></a>

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

## GitLab の登録 (アカウントレベル)
<a name="registering-gitlab-account-level"></a>

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

### ステップ 1: パイプラインプロバイダーに移動する
<a name="step-1-navigate-to-pipeline-providers"></a>

1.  AWS マネジメントコンソールにサインインする

1.  AWS DevOps エージェントコンソールに移動する

1. **機能プロバイダー**ページに移動する (サイドナビゲーションからアクセス可能)

1. **Pipeline** の**「利用可能な**プロバイダー」セクションで **GitLab** を検索し、**登録**を選択します

### ステップ 2: GitLab 接続を設定する
<a name="step-2-configure-gitlab-connection"></a>

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

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

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

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

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

1. 別のブラウザタブで、GitLab アカウントにログインします。

1. ユーザー設定に移動し、**アクセストークン**を選択する

1. 次のアクセス許可を持つ新しい個人用アクセストークンを作成します。
   + `read_repository` – リポジトリコンテンツにアクセスするために必要です
   + `read_virtual_registry` – 仮想レジストリ情報にアクセスするために必要です
   + `read_registry` – レジストリ情報にアクセスするために必要です
   + `api` – 読み取りおよび書き込み API アクセスに必要です
   + `self_rotate` - トークンのローテーションに必要です。この機能は現在、 AWS DevOps エージェントではサポートされていませんが、後日サポートされる予定です。これで を追加すると、今後新しいトークンを作成する必要がなくなります。

1. トークンの有効期限を現在の日付から最大 365 日に設定します。

1. 生成されたトークンをコピーする

1.  AWS DevOps エージェントコンソールに戻る

1. トークンを「アクセストークン」フィールドに貼り付けます。

### ステップ 3: 登録を完了する
<a name="step-3-complete-registration"></a>

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

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

## エージェントスペースへのプロジェクトの接続
<a name="connecting-projects-to-an-agent-space"></a>

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

1.  AWS DevOps エージェントコンソールで、エージェントスペースを選択します。

1. **機能**タブに移動する

1. **パイプライン**セクションで、**追加** を選択します。

1. 利用可能なプロバイダーのリストから **GitLab** を選択する

1. 使用するプロジェクトを含む GitLab 登録を選択します。

1. エージェントスペースに関連する GitLab プロジェクトを選択する

1. **[保存]** を選択します。

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

## コードレビューと自動テストの設定
<a name="configuring-code-review-and-automated-testing"></a>

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

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

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

1. プロジェクトを接続したら、GitLab 統合設定の**コードレビューと自動テスト**セクションに移動します。

1. プロジェクトごとに、自動マージリクエスト**のレビューが必要かどうかに応じて、自動トリガー変更**レビュー機能を有効または無効にします。

1. マネージド**検証環境で自動検証テスト**を行うかどうかに応じて、プロジェクトごとに[自動検証テスト](release-management-release-readiness-code-review.md)機能を有効または無効にします。

1. 必要に応じて、選択したプロジェクトで自動機能を実行するときに DevOps Agent が引き受ける**ランタイムロールドロップダウンから IAM ロール**を選択します。

1. **保存**を選択して設定を適用します。

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

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