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 設定のトラブルシューティング」を参照してください。

開始する前に:

でアカウントを既に作成 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 を削除できます。

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

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

注記

現在、コンソールを使用して接続を作成する場合、リソース ARN codestar-connectionsにを持つリソースのみが作成されます。ARN にcodeconnectionsサービスプレフィックスを持つリソースを作成するには、 CLI、SDK、または CFN を使用します。両方のサービスプレフィックスを持つリソースは、引き続きコンソールに表示されます。コンソールリソースの作成は、2024 年 7 月 1 日から開始されます。

注記

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 に接続する場合は、 Use a VPC (VPC を使用) を選択します。それ以外の場合、[No VPC] を選択します。
(オプション) Amazon VPC でホストを起動し、VPC に接続する場合は、[VPC を使用] を選択して、以下を完了します。
1. [VPC ID] で、 VPC ID を選択します。ホストがインストールされているインフラストラクチャに VPC を選択するか、VPN または Direct Connect を介してインスタンスにアクセスできる VPC を選択します。
2. プライベート VPC を設定していて、非公開認証局を使用して TLS 検証を実行するようにホストを設定している場合は、[TLS 証明書] に証明書 ID を入力します。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。
[設定] を選択して、次に [接続] を選択します。[Create connection] (接続の作成) を選択します。
GitLab リポジトリへの接続を作成するには、「プロバイダーの選択」で、GitLab セルフマネージド を選択します。[接続名] に、作成する接続の名前を入力します。　　　
[URL] に、サーバーのエンドポイントを入力します。
Amazon VPC でサーバーを起動し、VPC に接続する場合は、[Use a VPC] (VPC を使用) をクリックして、以下を完了します。
1. [VPC ID] で、 VPC ID を選択します。ホストがインストールされているインフラストラクチャに VPC を選択するか、VPN または Direct Connect を介してホストにアクセスできる VPC を選択します。
2. [サブネット ID] で、[Add] を選択します。このフィールドで、ホストに使用するサブネット ID を選択します。最大 10 個のサブネットを選択できます。
  
  ホストがインストールされているインフラストラクチャにサブネットを選択するか、VPN または Direct Connect を介してインストールされたホストにアクセスできるサブネットを選択します。
3. [Security group IDs] (セキュリティグループ ID) で、[Add] (追加) を選択します。このフィールドで、ホストに使用するセキュリティグループを選択します。最大 10 個のセキュリティグループを選択できます。　
  
  ホストがインストールされているインフラストラクチャにセキュリティグループを選択するか、VPN または Direct Connect を介してインストールされたホストにアクセスできるセキュリティグループを選択します。
4. プライベート VPC を設定していて、非公開認証局を使用して TLS 検証を実行するようにホストを設定している場合は、[TLS 証明書] に証明書 ID を入力します。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) を開きます。 AWS CLI を使用して create-host コマンドを実行し、接続に --name、--provider-type、および --provider-endpointを指定します。この例では、サードパーティープロバイダー名は 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

保留中の接続の更新