翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
ホストを作成する
AWS Management Console または AWS Command Line Interface (AWS CLI) を使用して、インフラストラクチャにインストールされているサードパーティーのコードリポジトリへの接続を作成できます。例えば、Amazon EC2 インスタンスで Enterprise Server を仮想マシンとして実行しているとします GitHub。 GitHub Enterprise Server への接続を作成する前に、接続に使用するホストを作成します。
インストール済みプロバイダー用のホスト作成ワークフローの概要については、「ホストを作成または更新するワークフロー」を参照してください。
開始する前に:
-
(オプション) VPC を使用してホストを作成する場合は、ネットワークまたは仮想プライベートクラウド (VPC) をあらかじめ作成しておく必要があります。
-
インスタンスをあらかじめ作成しておく必要があります。VPC に接続するときは、ホストを VPC で起動しておく必要があります。
注記
各 VPC は、一度に 1 つのホストにのみ関連付けることができます。
オプションで VPC を使用してホストを設定できます。ホストリソース用のネットワークおよび VPC 設定の詳細については、「(オプション) 前提条件: 接続用のネットワーク設定または Amazon VPC 設定」および「ホストの VPC 設定のトラブルシューティング」を参照してください。
コンソールを使用してホストと GitHub Enterprise Server への接続を作成するには、「」を参照してくださいEnterprise Server 接続を作成する GitHub (コンソール)。コンソールでホストが作成されます。
コンソールを使用してホストと GitLab セルフマネージドへの接続を作成するには、「」を参照してくださいセルフマネージドへの接続 GitLabを作成する。コンソールでホストが作成されます。
(オプション) 前提条件: 接続用のネットワーク設定または Amazon VPC 設定
インフラストラクチャにネットワーク接続が設定されている場合は、このセクションをスキップできます。
ホストに VPC でのみアクセスできる場合は、続行する前に、これらの VPC 要件に従ってください。
VPC の要件
オプションで VPC を使用してホストを作成することもできます。以下は、インストール用に設定した VPC に応じた、一般的な VPC 要件を示します。
-
パブリックサブネットとプライベートサブネットを使用してパブリック VPC を構成できます。優先 CIDR ブロックまたはサブネットがない場合は、 AWS アカウント にデフォルトの VPC を使用できます。
-
プライベート VPC が設定されていて、非パブリック認証機関を使用して TLS 検証を実行するように GitHub Enterprise Server インスタンスを設定している場合は、ホストリソースの TLS 証明書を提供する必要があります。
-
接続によってホストが作成されると、ウェブフック用の VPC エンドポイント (PrivateLink) が自動的に作成されます。詳細については、「AWS CodeConnections およびインターフェイスVPCエンドポイント (AWS PrivateLink)」を参照してください。
-
セキュリティグループの設定
-
ホストの作成中に使用されるセキュリティグループには、ネットワークインターフェイスが GitHub Enterprise Server インスタンスに接続できるようにするインバウンドルールとアウトバウンドルールが必要です。
-
GitHub Enterprise Server インスタンスにアタッチされたセキュリティグループ (ホスト設定の一部ではない) には、接続によって作成されたネットワークインターフェイスからのインバウンドおよびアウトバウンドのアクセスが必要です。
-
-
VPC サブネットは、リージョン内の異なるアベイラビリティーゾーンに存在している必要があります。アベイラビリティーゾーンとは、他のアベイラビリティーゾーンで発生した障害から切り離すために作られた場所です。各サブネットが完全に 1 つのアベイラビリティーゾーン内に含まれている必要があり、1 つのサブネットが複数のゾーンに、またがることはできません。
VPC とサブネットの使用方法の詳細については、Amazon VPC ユーザーガイド の「IPv4 用の VPC とサブネットのサイズ設定」を参照してください。
ホストセットアップ用に提供する VPC 情報
次のステップで接続用のホストリソースを作成するときは、以下を提供する必要があります。
-
VPC ID: GitHub Enterprise Server インスタンスがインストールされているサーバーの VPC、または VPN または Direct Connect を介してインストールされた GitHub Enterprise Server インスタンスにアクセスできる VPC の ID。
-
サブネット ID : Enterprise Server インスタンスがインストールされているサーバーのサブネットの ID、または VPN または Direct Connect を介してインストールされた Enterprise Server インスタンスにアクセスできるサブネットの IDs。 GitHub GitHub
-
セキュリティグループ: GitHub Enterprise Server インスタンスがインストールされているサーバーのセキュリティグループ、または VPN または Direct Connect を介してインストール GitHubされた Enterprise Server インスタンスにアクセスできるセキュリティグループ。
-
エンドポイント: サーバーエンドポイントを準備して、次のステップに進みます。
VPC またはホスト接続のトラブルシューティングなどの詳細については、「ホストの VPC 設定のトラブルシューティング」を参照してください。
アクセス許可の要件
ホスト作成プロセスの一環として、 はユーザーに代わってネットワークリソース AWS CodeConnections を作成し、VPC 接続を容易にします。これには、ホストからデータをクエリ AWS CodeConnections するための のネットワークインターフェイス、およびウェブフック経由で接続にイベントデータを送信する VPC エンドポイントまたは ホストPrivateLinkが含まれます。これらのネットワークリソースを作成できるようにするには、ホストを作成するロールに次のアクセス許可があることを確認してください。
ec2:CreateNetworkInterface ec2:CreateTags ec2:DescribeDhcpOptions ec2:DescribeNetworkInterfaces ec2:DescribeSubnets ec2:DeleteNetworkInterface ec2:DescribeVpcs ec2:CreateVpcEndpoint ec2:DeleteVpcEndpoints ec2:DescribeVpcEndpoints
VPC 内のアクセス許可またはホスト接続のトラブルシューティングの詳細については、「ホストの VPC 設定のトラブルシューティング」を参照してください。
ウェブフック VPC エンドポイントの詳細については、「AWS CodeConnections およびインターフェイスVPCエンドポイント (AWS PrivateLink)」を参照してください。
接続用のホストを作成する (コンソール)
GitHub Enterprise Server や GitLabセルフマネージドなどのインストール用の接続では、ホストを使用して、サードパーティープロバイダーがインストールされているインフラストラクチャのエンドポイントを表します。
注記
現在、コンソールを使用して接続を作成する場合、リソース ARN codestar-connections
に を持つリソースのみが作成されます。ARN にcodeconnections
サービスプレフィックスを持つリソースを作成するには、 CLI、SDK、または CFN を使用します。両方のサービスプレフィックスを持つリソースは、引き続きコンソールに表示されます。コンソールリソースの作成は、2024 年 7 月 1 日から開始されます。
VPC でホストをセットアップする際の考慮事項については、「セルフマネージドへの接続 GitLabを作成する」を参照してください。
コンソールを使用してホストと GitHub Enterprise Server への接続を作成するには、「」を参照してくださいEnterprise Server 接続を作成する GitHub (コンソール)。コンソールでホストが作成されます。
コンソールを使用してホストと GitLab セルフマネージドへの接続を作成するには、「」を参照してくださいセルフマネージドへの接続 GitLabを作成する。コンソールでホストが作成されます。
注記
ホストは、 GitHub Enterprise Server または GitLab セルフマネージドアカウントごとに 1 回のみ作成します。特定の GitHub Enterprise Server または GitLabセルフマネージドアカウントへのすべての接続は、同じホストを使用します。
接続用のホストを作成する (CLI)
AWS Command Line Interface (AWS CLI) を使用して、インストールされた接続用のホストを作成できます。
注記
ホストは、 GitHub Enterprise Server アカウントごとに 1 回のみ作成します。特定の GitHub Enterprise Server アカウントへのすべての接続は、同じホストを使用します。
ホストを使用して、サードパーティーのプロバイダがインストールされているインフラストラクチャのエンドポイントを表します。CLI を使用してホストを作成するには、create-host コマンドを実行します。ホストの作成が完了すると、ホストのステータスが Pending (保留中) になります。次に、ホストを設定して、ホストのステータスが Available (使用可能) に移行します。ホストが使用可能になったら、接続を作成する手順を完了します。
重要
を通じて作成されたホスト AWS CLI は、デフォルトで Pending
ステータスです。CLI でホストを作成後、コンソールでホストを設定し、ステータスを Available
にします。
コンソールを使用してホストと GitHub Enterprise Server への接続を作成するには、「」を参照してくださいEnterprise Server 接続を作成する GitHub (コンソール)。コンソールでホストが作成されます。
コンソールを使用してホストと GitLab セルフマネージドへの接続を作成するには、「」を参照してくださいセルフマネージドへの接続 GitLabを作成する。コンソールでホストが作成されます。