翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# ホストを作成する
AWS マネジメントコンソール または AWS Command Line Interface (AWS CLI) を使用して、インフラストラクチャにインストールされているサードパーティーのコードリポジトリへの接続を作成できます。例えば、GitHub Enterprise Server を Amazon EC2 インスタンス上で仮想マシンとして実行しているとします。GitHub Enterprise Server への接続を作成する前に、接続に使用するホストを作成します。
インストール済みプロバイダー用のホスト作成ワークフローの概要については、「[ホストを作成または更新するワークフロー](welcome-hosts-workflow.md)」を参照してください。
開始する前に:
+ (オプション) VPC を使用してホストを作成する場合は、ネットワークまたは仮想プライベートクラウド (VPC) をあらかじめ作成しておく必要があります。
+ インスタンスをあらかじめ作成しておく必要があります。VPC に接続するときは、ホストを VPC で起動しておく必要があります。
**注記**
各 VPC は、一度に 1 つのホストにのみ関連付けることができます。
オプションで VPC を使用してホストを設定できます。ホストリソース用のネットワークおよび VPC 設定の詳細については、「[(オプション) 前提条件: 接続用のネットワーク設定または Amazon VPC 設定](#connections-create-host-prereq)」および「[ホストの VPC 設定のトラブルシューティング](troubleshooting-connections.md#troubleshooting-connections-host-vpc)」を参照してください。
コンソールを使用してホストを作成し、GitHub Enterprise Server への接続を作成するには、「[GitHub Enterprise Server 接続を作成する (コンソール)](connections-create-gheserver-console.md#connections-create-gheserver-connection)」を参照してください。コンソールでホストが作成されます。
コンソールを使用してホストを作成し、GitHub セルフマネージドへの接続を作成するには、「[GitLab セルフマネージドへの接続を作成する](connections-create-gitlab-managed.md)」を参照してください。コンソールでホストが作成されます。
## (オプション) 前提条件: 接続用のネットワーク設定または 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)](vpc-interface-endpoints.md)」を参照してください。
+ セキュリティグループの設定
+ ホストの作成時に使用されるセキュリティグループには、ネットワークインターフェイスが GitHub Enterprise Server インスタンスに接続できるようにするインバウンドルールとアウトバウンドルールが必要です。
+ GitHub Enterprise Server インスタンス (ホスト設定の一部ではない) にアタッチされたセキュリティグループには、接続によって作成されたネットワークインターフェイスからのインバウンドアクセスとアウトバウンドアクセスが必要です。
+ VPC サブネットは、リージョン内の異なるアベイラビリティーゾーンに存在している必要があります。アベイラビリティーゾーンとは、他のアベイラビリティーゾーンで発生した障害から切り離すために作られた場所です。各サブネットが完全に 1 つのアベイラビリティーゾーン内に含まれている必要があり、1 つのサブネットが複数のゾーンに、またがることはできません。
VPC とサブネットの使用方法の詳細については、*Amazon VPC ユーザーガイド* の「[IPv4 用の VPC とサブネットのサイズ設定](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Subnets.html#vpc-sizing-ipv4)」を参照してください。
**ホストセットアップ用に提供する VPC 情報**
次のステップで接続用のホストリソースを作成するときは、以下を提供する必要があります。
+ **VPC ID: **GitHub Enterprise Server インスタンスがインストールされているサーバーの VPC、または VPN または Direct Connect を介してインストールされた GitHub Enterprise Server インスタンスにアクセスできる VPC の ID。
+ **サブネット ID:** GitHub Enterprise Server インスタンスがインストールされているサーバーのサブネット、または VPN または Direct Connect を介してインストールされた GitHub Enterprise Server インスタンスにアクセスできるサブネットの ID。
+ **セキュリティグループ:** GitHub Enterprise Server インスタンスがインストールされているサーバーのセキュリティグループ、または VPN または Direct Connect を介してインストールされた GitHub Enterprise Server インスタンスにアクセスできるセキュリティグループ。
+ **エンドポイント:** サーバーエンドポイントを準備して、次のステップに進みます。
VPC またはホスト接続のトラブルシューティングなどの詳細については、「[ホストの VPC 設定のトラブルシューティング](troubleshooting-connections.md#troubleshooting-connections-host-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 設定のトラブルシューティング](troubleshooting-connections.md#troubleshooting-connections-host-vpc)」を参照してください。
ウェブフック VPC エンドポイントの詳細については、「[AWS CodeConnections およびインターフェイス VPC エンドポイント (AWS PrivateLink)](vpc-interface-endpoints.md)」を参照してください。
**Topics**
+ [(オプション) 前提条件: 接続用のネットワーク設定または Amazon VPC 設定](#connections-create-host-prereq)
+ [接続用のホストを作成する (コンソール)](#connections-host-create-console)
+ [接続用のホストを作成する (CLI)](#connections-host-create-cli)
## 接続用のホストを作成する (コンソール)
GitHub Enterprise Server や GitLab セルフマネージドなど、インストールの接続では、ホストを使用して、サードパーティーのプロバイダーがインストールされているインフラストラクチャのエンドポイントを表します。
**注記**
2024 年 7 月 1 日以降、コンソールはリソース ARN `codeconnections`に との接続を作成します。両方のサービスプレフィックスを持つリソースは、コンソールに引き続き表示されます。
VPC でホストをセットアップする際の考慮事項については、「[GitLab セルフマネージドへの接続を作成する](connections-create-gitlab-managed.md)」を参照してください。
コンソールを使用してホストを作成し、GitHub Enterprise Server への接続を作成するには、「[GitHub Enterprise Server 接続を作成する (コンソール)](connections-create-gheserver-console.md#connections-create-gheserver-connection)」を参照してください。コンソールでホストが作成されます。
コンソールを使用してホストを作成し、GitHub セルフマネージドへの接続を作成するには、「[GitLab セルフマネージドへの接続を作成する](connections-create-gitlab-managed.md)」を参照してください。コンソールでホストが作成されます。
**注記**
ホストは、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 への接続を作成するには、「[GitHub Enterprise Server 接続を作成する (コンソール)](connections-create-gheserver-console.md#connections-create-gheserver-connection)」を参照してください。コンソールでホストが作成されます。
コンソールを使用してホストを作成し、GitHub セルフマネージドへの接続を作成するには、「[GitLab セルフマネージドへの接続を作成する](connections-create-gitlab-managed.md)」を参照してください。コンソールでホストが作成されます。