セルフマネージドへの接続 GitLabを作成する - デベロッパーツールコンソール

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

セルフマネージドへの接続 GitLabを作成する

セルフマネージドインストールを使用して、 GitLab Enterprise Edition または GitLab Community Edition の接続を作成できます。

AWS Management Console または AWS Command Line Interface (AWS CLI) を使用して、 GitLab セルフマネージド用の接続とホストを作成できます。

注記

この接続アプリケーションを GitLab セルフマネージドで承認することで、データを処理するためのアクセス許可をサービスに付与し、アプリケーションをアンインストールすることでいつでもアクセス許可を取り消すことができます。

GitLab セルフマネージドへの接続を作成する前に、以下のステップで説明するように、接続に使用するホストを作成する必要があります。インストール済みプロバイダー用のホスト作成ワークフローの概要については、「ホストを作成または更新するワークフロー」を参照してください。

オプションで、 を使用してホストを設定できますVPC。ホストリソースのネットワークとVPC設定の詳細については、(オプション) 前提条件: 接続のネットワークまたは Amazon VPC設定「」および「」のVPC前提条件を参照してくださいホストVPCの設定のトラブルシューティング

開始する前に:

  • でアカウントを作成済み GitLab で、セルフマネージドインストールの GitLab Enterprise Edition または GitLab Community Edition を持っている必要があります。詳細については、https://docs.gitlab.com/ee/「subscriptions/self_managed/」を参照してください。

    注記

    Connections は、接続の作成と承認に使用されたアカウント用のアクセスだけを提供します。

    注記

    所有者ロールがあるリポジトリへの接続を作成し GitLab、その接続を などのリソースで使用できます CodePipeline。グループ内のリポジトリでは、グループの所有者である必要はありません。

  • スコープダウンされたアクセス許可のみを持つ GitLab 個人用アクセストークン (PAT) をすでに作成しておく必要があります。API。詳細については、https://docs.gitlab.com/ee/user/profile/personal「_access_tokens.html」を参照してください。を作成して使用するには、管理者である必要がありますPAT。

    注記

    PAT はホストの認可に使用され、それ以外の場合は接続によって保存または使用されません。ホストをセットアップするには、一時 を作成しPAT、ホストをセットアップした後、 を削除できますPAT。

注記

GitHub Enterprise Server または GitLab セルフマネージド型の組織では、使用可能なホストを渡しません。組織内の接続ごとに新しいホストを作成し、ホストのネットワークフィールド (VPC ID、サブネットIDs、セキュリティグループ IDs) に必ず同じ情報を入力する必要があります。詳細については、「組織をサポートするインストール済みプロバイダーの接続とホストのセットアップ」を参照してください。

GitLab セルフマネージドへの接続を作成する (コンソール)

以下のステップを使用して、 コンソールでホストと GitLab セルフマネージドへの接続を作成します。でホストを設定する際の考慮事項についてはVPC、「」を参照してください(オプション) 前提条件: 接続のネットワークまたは Amazon VPC設定

注記

2024 年 7 月 1 日以降、コンソールはリソース codeconnectionsに との接続を作成しますARN。両方のサービスプレフィックスを持つリソースは、コンソールに引き続き表示されます。

注記

1 つの GitLab セルフマネージドインストール用のホストを作成し、そのホストへの 1 つ以上の GitLab セルフマネージド接続を管理できます。

ステップ 1: ホストを作成する
  1. にサインインし AWS Management Console、 で AWS デベロッパーツールコンソールを開きますhttps://console.aws.amazon.com/codesuite/settings/connections

  2. [Hosts (ホスト)]タブで、[Create host (ホストの作成)]を選択します。

  3. [ホスト名]に、ホストに使用する名前を入力します。 

  4. プロバイダーの選択で、GitLabセルフマネージドを選択します。

  5. URL、プロバイダーがインストールされているインフラストラクチャのエンドポイントを入力します。

  6. サーバーが Amazon 内で設定VPCされていて、 に接続する場合はVPC、 の使用VPCを選択します。それ以外の場合は [いいえVPC] を選択します。

  7. (オプション) Amazon でホストを起動VPCし、 に接続する場合はVPC、 VPCを使用する を選択し、以下を完了します。

    注記

    GitHub Enterprise Server または GitLab セルフマネージド型の組織では、使用可能なホストを渡しません。組織内の接続ごとに新しいホストを作成し、ホストのネットワークフィールド (VPC ID、サブネットIDs、セキュリティグループ IDs) に必ず同じ情報を入力する必要があります。詳細については、「組織をサポートするインストール済みプロバイダーの接続とホストのセットアップ」を参照してください。

    1. VPC ID で、VPCID を選択します。ホストがインストールされているインフラストラクチャVPCの を選択するか、 または VPN Direct Connect を介してインスタンスVPCにアクセスできる を選択してください。

    2. プライベートVPCが設定されていて、非パブリック認証機関を使用してTLS検証を実行するようにホストを設定している場合は、TLS証明書に証明書 ID を入力します。Certificate 値は、TLS証明書のパブリックキーです。

  8. [Create host] (ホストの作成) を選択します。

  9. ホストの詳細ページが表示されたら、ホストの作成に伴ってホストのステータスが変化します。

    注記

    ホスト設定に VPC設定が含まれている場合は、ホストネットワークコンポーネントのプロビジョニングに数分かかります。

    ホストのステータスがPending (保留中) になるのを待ってから、セットアップを完了します。詳細については、「保留中のホストをセットアップする」を参照してください。

    ホストが保留中ステータスの GitLab セルフマネージドホストの詳細を示すコンソールのスクリーンショット。
ステップ 2: 保留中のホストを設定する
  1. [ホストをセットアップ] を選択します。

  2. セットアップhost_nameページが表示されます。「個人用アクセストークンを提供する」で、スコープダウンされたアクセス許可のみを に GitLab PAT付与しますapi

    注記

    を作成および使用できるのは管理者のみですPAT。

    新しいホストの GitLab 個人用アクセストークンエントリを示すコンソールのスクリーンショット
  3. ホストが正常に登録されると、ホストの詳細ページが表示され、ホストのステータスが Available (使用可能) になります。

    新しいホストの利用可能状態を示すコンソールのスクリーンショット
ステップ 3: 接続を作成する
  1. にサインインし AWS Management Console、 で AWS デベロッパーツールコンソールを開きますhttps://console.aws.amazon.com/codesuite/settings/connections

  2. [設定] を選択して、次に [接続] を選択します。[接続を作成] を選択します。

  3. GitLab リポジトリへの接続を作成するには、「プロバイダーの選択GitLab 」で、セルフマネージドを選択します。[接続名] に、作成する接続の名前を入力します。   

    セルフマネージド で GitLab選択された接続オプションを示すコンソールのスクリーンショット。
  4. URL、サーバーのエンドポイントを入力します。

  5. サーバーを Amazon で起動VPCし、 に接続する場合はVPC、 を使用する VPC を選択し、以下を完了します。

    1. VPC ID で、VPCID を選択します。ホストがインストールされているインフラストラクチャVPCの を選択するか、 または VPN Direct Connect を介してホストVPCにアクセスできる を選択してください。

    2. [サブネット ID] で、[Add] を選択します。このフィールドで、ホストに使用するサブネット ID を選択します。最大 10 個のサブネットを選択できます。

      ホストがインストールされているインフラストラクチャのサブネットを選択するか、 または VPN Direct Connect を介してインストールされたホストにアクセスできるサブネットを選択してください。

    3. セキュリティグループ IDsで、追加 を選択します。このフィールドで、ホストに使用するセキュリティグループを選択します。最大 10 個のセキュリティグループを選択できます。 

      ホストがインストールされているインフラストラクチャのセキュリティグループ、または VPNまたは Direct Connect を介してインストールされたホストにアクセスできるセキュリティグループを必ず選択してください。

    4. プライベートVPCが設定されていて、非パブリック認証機関を使用してTLS検証を実行するようにホストを設定している場合は、TLS証明書に証明書 ID を入力します。Certificate 値は、TLS証明書のパブリックキーである必要があります。

  6. GitLab セルフマネージドに接続するを選択します。作成された接続は、Pending (保留中) のステータスで表示されます。指定したサーバ情報との接続用に、ホストリソースが作成されます。ホスト名には、 URLが使用されます。

  7. 保留中の接続の更新を選択します。

  8. のサインインページ GitLab が表示されたら、認証情報を使用してログインし、サインインを選択します。

  9. アカウントにアクセスするための接続の認可を要求するメッセージが認可ページに表示されます GitLab 。

    [承認] を選択します。

  10. ブラウザは接続コンソールページに戻ります。 GitLab 「接続の作成」に、新しい接続が接続名に表示されます。

  11. GitLab セルフマネージドに接続するを選択します。

    接続が正常に作成されると、成功バナーが表示されます。接続の詳細は、[接続設定] ページに表示されます。

セルフマネージド (CLI) への接続 GitLabを作成する

AWS Command Line Interface (AWS CLI) を使用して、セルフマネージド型の GitLabホストと接続を作成できます。

これを行うには、create-host および create-connection コマンドを使用します。

重要

AWS CLI または を介して作成された接続 AWS CloudFormation は、デフォルトで PENDINGステータスです。CLI または との接続を作成したら AWS CloudFormation、コンソールを使用して接続を編集し、ステータスを にしますAVAILABLE

ステップ 1: GitLab セルフマネージド型のホストを作成するには (CLI)
  1. ターミナル (Linux/macOS/Unix) またはコマンドプロンプト (Windows) を開きます。を使用して create-host コマンド AWS CLI を実行し、--provider-endpoint接続に --name--provider-type、および を指定します。この例では、サードパーティープロバイダー名は GitLabSelfManaged で、エンドポイントは my-instance.dev です。

    aws codeconnections create-host --name MyHost --provider-type GitLabSelfManaged --provider-endpoint "https://my-instance.dev"

    成功すると、このコマンドは次のようなホスト Amazon リソースネーム (ARN) 情報を返します。

    { "HostArn": "arn:aws:codeconnections:us-west-2:account_id:host/My-Host-28aef605" }

    この手順の後、ホストのステータスは PENDING になります。

  2. コンソールを使用してホストのセットアップを完了し、次のステップでホストのステータスを Available に移行します。

ステップ 2: コンソールで保留中のホストを設定するには
  1. にサインイン AWS Management Console し、 でデベロッパーツールコンソールを開きますhttps://console.aws.amazon.com/codesuite/settings/connections

  2. コンソールでホストのセットアップを完了し、ホストのステータスを Available に移行します。「保留中のホストをセットアップする」を参照してください。

ステップ 3: GitLab セルフマネージド型の接続を作成するには (CLI)
  1. ターミナル (Linux/macOS/Unix) またはコマンドプロンプト (Windows) を開きます。を使用して create-connection コマンド AWS CLI を実行し、接続--connection-name--host-arnと を指定します。

    aws codeconnections create-connection --host-arn arn:aws:codeconnections:us-west-2:account_id:host/MyHost-234EXAMPLE --connection-name MyConnection

    成功すると、このコマンドは次のような接続ARN情報を返します。

    { "ConnectionArn": "arn:aws:codeconnections:us-west-2:account_id:connection/aEXAMPLE-8aad" }
  2. 次のステップでコンソールを使用して、保留中の接続を設定します。

ステップ 4: コンソールで GitLab セルフマネージド の接続を完了するには
  1. にサインイン AWS Management Console し、 でデベロッパーツールコンソールを開きますhttps://console.aws.amazon.com/codesuite/settings/connections

  2. コンソールを使用して、保留中の接続を設定し、接続のステータスを Available に移行します。詳細については、「保留中の接続の更新」を参照してください。