GitLab セルフマネージドへの接続を作成する (コンソール）セルフマネージド (CLI) への接続 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: ホストを作成する

にサインインし AWS Management Console、で AWS デベロッパーツールコンソールを開きますhttps://console.aws.amazon.com/codesuite/settings/connections。
[Hosts (ホスト)]タブで、[Create host (ホストの作成)]を選択します。
[ホスト名]に、ホストに使用する名前を入力します。　
プロバイダーの選択で、GitLabセルフマネージドを選択します。
でURL、プロバイダーがインストールされているインフラストラクチャのエンドポイントを入力します。
サーバーが Amazon 内で設定VPCされていて、に接続する場合はVPC、 の使用VPCを選択します。それ以外の場合は [いいえVPC] を選択します。
（オプション) 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証明書のパブリックキーです。
[Create host] (ホストの作成) を選択します。
ホストの詳細ページが表示されたら、ホストの作成に伴ってホストのステータスが変化します。

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

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

ステップ 2: 保留中のホストを設定する

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

注記
を作成および使用できるのは管理者のみですPAT。
ホストが正常に登録されると、ホストの詳細ページが表示され、ホストのステータスが Available (使用可能) になります。

ステップ 3: 接続を作成する

にサインインし AWS Management Console、で AWS デベロッパーツールコンソールを開きますhttps://console.aws.amazon.com/codesuite/settings/connections。
[設定] を選択して、次に [接続] を選択します。[接続を作成] を選択します。
GitLab リポジトリへの接続を作成するには、「プロバイダーの選択GitLab 」で、セルフマネージドを選択します。[接続名] に、作成する接続の名前を入力します。　　　
でURL、サーバーのエンドポイントを入力します。
サーバーを 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証明書のパブリックキーである必要があります。
GitLab セルフマネージドに接続するを選択します。作成された接続は、Pending (保留中) のステータスで表示されます。指定したサーバ情報との接続用に、ホストリソースが作成されます。ホスト名には、 URLが使用されます。
保留中の接続の更新を選択します。
のサインインページ GitLab が表示されたら、認証情報を使用してログインし、サインインを選択します。
アカウントにアクセスするための接続の認可を要求するメッセージが認可ページに表示されます GitLab 。

[承認] を選択します。
ブラウザは接続コンソールページに戻ります。 GitLab 「接続の作成」に、新しい接続が接続名に表示されます。
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）

ターミナル (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 になります。
コンソールを使用してホストのセットアップを完了し、次のステップでホストのステータスを Available に移行します。

ステップ 2: コンソールで保留中のホストを設定するには

にサインイン AWS Management Console し、でデベロッパーツールコンソールを開きますhttps://console.aws.amazon.com/codesuite/settings/connections。
コンソールでホストのセットアップを完了し、ホストのステータスを Available に移行します。「保留中のホストをセットアップする」を参照してください。

ステップ 3: GitLab セルフマネージド型の接続を作成するには (CLI）

ターミナル (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"
}
```
次のステップでコンソールを使用して、保留中の接続を設定します。

ステップ 4: コンソールで GitLab セルフマネージドの接続を完了するには

にサインイン AWS Management Console し、でデベロッパーツールコンソールを開きますhttps://console.aws.amazon.com/codesuite/settings/connections。
コンソールを使用して、保留中の接続を設定し、接続のステータスを Available に移行します。詳細については、「保留中の接続の更新」を参照してください。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

への接続を作成する GitLab

保留中の接続の更新