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

# 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: パイプラインプロバイダーに移動する
<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 タグを追加します。

**次へ**をクリックして設定を確認し、**送信**をクリックして GitLab 登録プロセスを完了します。システムはアクセストークンを検証し、接続を確立します。

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

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

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

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

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

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

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

1. **保存 **をクリックします。

AWS DevOps エージェントは、GitLab Pipelines からのデプロイについてこれらのプロジェクトをモニタリングし、因果調査を通知します。

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