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

フォーカスモード

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

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

GitLab セルフマネージドのインストールで、Enterprise Edition または 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 などのリソースで使用できます。グループ内のリポジトリでは、グループの所有者である必要はありません。
スコープダウンされたアクセス許可: api のみで GitLab 個人アクセストークン (PAT) を作成済みである必要があります。詳細については、https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html を参照してください。PAT を作成して使用するには、管理者である必要があります。

注記
PAT はホストの認可に使用され、それ以外の方法で保存または接続に使用されることはありません。ホストを設定するには、一時的な PAT を作成し、ホストを設定した後に PAT を削除できます。

注記

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

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

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

注記

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

注記

単一の 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 を使用] を選択して、以下を完了します。

注記
GitHub Enterprise Server または GitLab セルフマネージドの組織では、使用可能なホストを渡しません。組織内の接続ごとに新しいホストを作成し、ホストのネットワークフィールド (VPC ID、サブネット IDs、セキュリティグループ IDs) に必ず同じ情報を入力する必要があります。詳細については、「組織をサポートするインストール済みプロバイダーの接続とホストのセットアップ」を参照してください。
1. [VPC ID] で、 VPC ID を選択します。ホストがインストールされているインフラストラクチャに VPC を選択するか、VPN または Direct Connect を介してインスタンスにアクセスできる VPC を選択します。
2. プライベート VPC を設定していて、非公開認証局を使用して TLS 検証を実行するようにホストを設定している場合は、[TLS 証明書] に証明書 ID を入力します。TLS 証明書の値は証明書のパブリックキーです。
[Create host] (ホストの作成) を選択します。
ホストの詳細ページが表示されたら、ホストの作成に伴ってホストのステータスが変化します。

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

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

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

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

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

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

にサインインし AWS Management Console、で AWS 開発者ツールコンソールを開きますhttps://console.aws.amazon.com/codesuite/settings/connections。
[設定] を選択して、次に [接続] を選択します。[接続を作成] を選択します。
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 セルフマネージドへの接続] を選択します。

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

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

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 コマンドを実行し、接続--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) を開きます。 AWS CLI を使用して create-connection コマンドを実行し、接続--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: コンソールで GitHub セルフマネージド用の接続を完了するには

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

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

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

ドキュメントの表記規則

GitLab への接続を作成する

保留中の接続の更新

次のトピック

保留中の接続の更新

前のトピック:

GitLab への接続を作成する

ヘルプが必要ですか?

このページの内容

このページは役に立ちましたか?

フィードバックを送信

プライバシーサイト規約 Cookie の設定

Cookie の設定を選択する

Cookie の設定をカスタマイズする

Essential

Performance

Functional

Advertising

Cookie の設定を保存できません