View a markdown version of this page

GitLab の接続 - AWS DevOps エージェント

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

GitLab の接続

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

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

GitLab は AWS アカウントレベルで登録され、そのアカウントのすべてのエージェントスペース間で共有されます。個々のエージェントスペースは、エージェントスペースに適用する特定のプロジェクトを選択できます。

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

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

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

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

  4. Pipeline「利用可能なプロバイダー」セクションで GitLab を検索し、登録をクリックします

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

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

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

  • Personal (デフォルト) – ユーザー名とプロファイルを持つ個々の GitLab ユーザーアカウント

  • グループ – GitLab では、グループを使用して 1 つ以上の関連プロジェクトを同時に管理します。

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

  • GitLab.com (デフォルト) – パブリック GitLab サービス

  • パブリックにアクセス可能なセルフホスト型 GitLab GitLab セルフホスト型エンドポイントの使用チェックボックスをオンにし、GitLab インスタンスへの URL を指定します。

注記

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

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

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

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

  3. 次のアクセス許可を持つ新しい個人用アクセストークンを作成します。

    • read_repository – リポジトリコンテンツにアクセスするために必要です

    • read_virtual_registry – 仮想レジストリ情報にアクセスするために必要です

    • read_registry – レジストリ情報にアクセスするために必要です

    • api – 読み取りおよび書き込み API アクセスに必要です

    • self_rotate - トークンのローテーションに必要です。この機能は現在、 AWS DevOps エージェントではサポートされていませんが、後日サポートされます。これで を追加すると、今後新しいトークンを作成する必要がなくなります。

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

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

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

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

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

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

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

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

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

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

  2. 機能タブに移動する

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

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

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

  6. 保存 をクリックします。

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

GitLab 接続の管理

  • アクセストークンの更新 – アクセストークンの有効期限が切れるか、更新する必要がある場合は、アカウントレベルで GitLab 登録を変更することで、 AWS DevOps エージェントコンソールで更新できます。

  • 接続されたプロジェクトの表示 – AWS DevOps エージェントコンソールで、エージェントスペースを選択し、機能タブに移動して、パイプラインセクションで接続されたプロジェクトを表示します。

  • GitLab 接続の削除 – GitLab プロジェクトをエージェントスペースから切断するには、パイプラインセクションで接続を選択し、削除をクリックします。GitLab 登録を完全に削除するには、まずすべてのエージェントスペースから削除してから、アカウントレベルで登録を削除します。