

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Membuat host
<a name="connections-host-create"></a>

Anda dapat menggunakan Konsol Manajemen AWS atau AWS Command Line Interface (AWS CLI) untuk membuat koneksi ke repositori kode pihak ketiga yang diinstal pada infrastruktur Anda. Misalnya, Anda mungkin menjalankan GitHub Enterprise Server sebagai mesin virtual pada instans Amazon EC2. Sebelum Anda membuat koneksi ke GitHub Enterprise Server, Anda membuat host untuk digunakan untuk koneksi.

Untuk ikhtisar alur kerja pembuatan host untuk penyedia yang diinstal, lihat[Alur kerja untuk membuat atau memperbarui host](welcome-hosts-workflow.md).

Sebelum Anda memulai:
+ (Opsional) Jika Anda ingin membuat host Anda dengan VPC, Anda harus sudah membuat jaringan atau virtual private cloud (VPC).
+ Anda harus sudah membuat instans Anda dan, jika Anda berencana untuk terhubung dengan VPC Anda, luncurkan host Anda ke VPC Anda.
**catatan**  
Setiap VPC hanya dapat dikaitkan dengan satu host pada satu waktu.

Anda dapat mengonfigurasi host Anda secara opsional dengan VPC. Untuk informasi selengkapnya tentang konfigurasi jaringan dan VPC untuk sumber daya host Anda, lihat prasyarat VPC di dan. [(Opsional) Prasyarat: Konfigurasi VPC Jaringan atau Amazon untuk koneksi Anda](#connections-create-host-prereq) [Pemecahan masalah konfigurasi VPC untuk host Anda](troubleshooting-connections.md#troubleshooting-connections-host-vpc)

Untuk menggunakan konsol untuk membuat host dan koneksi ke GitHub Enterprise Server, lihat[Buat koneksi GitHub Enterprise Server Anda (konsol)](connections-create-gheserver-console.md#connections-create-gheserver-connection). Konsol membuat host Anda untuk Anda.

Untuk menggunakan konsol untuk membuat host dan koneksi ke GitLab kelola sendiri, lihat[Buat koneksi ke GitLab self-managed](connections-create-gitlab-managed.md). Konsol membuat host Anda untuk Anda.

## (Opsional) Prasyarat: Konfigurasi VPC Jaringan atau Amazon untuk koneksi Anda
<a name="connections-create-host-prereq"></a>

Jika infrastruktur Anda dikonfigurasi dengan koneksi jaringan, Anda dapat melewati bagian ini.

Jika host Anda hanya dapat diakses di VPC, ikuti persyaratan VPC ini sebelum melanjutkan.

### Persyaratan VPC
<a name="connections-create-host-prereq-vpc"></a>

Anda dapat memilih untuk membuat host Anda dengan VPC. Berikut ini adalah persyaratan VPC umum, tergantung pada VPC yang telah Anda atur untuk instalasi Anda.
+ Anda dapat mengonfigurasi VPC *publik* dengan subnet publik dan privat. Anda dapat menggunakan VPC default untuk Anda Akun AWS jika Anda tidak memiliki blok CIDR atau subnet pilihan.
+ Jika Anda memiliki VPC *pribadi* yang dikonfigurasi, dan Anda telah mengonfigurasi instance Server GitHub Perusahaan Anda untuk melakukan validasi TLS menggunakan otoritas sertifikat non-publik, Anda harus memberikan sertifikat TLS untuk sumber daya host Anda.
+ Saat koneksi membuat host Anda, titik akhir VPC (PrivateLink) untuk webhook dibuat untuk Anda. Untuk informasi selengkapnya, lihat [AWS CodeConnections dan antarmuka titik akhir VPC ()AWS PrivateLink](vpc-interface-endpoints.md).
+ Konfigurasi grup keamanan:
  + Grup keamanan yang digunakan selama pembuatan host memerlukan aturan masuk dan keluar yang memungkinkan antarmuka jaringan terhubung ke instance Server GitHub Perusahaan Anda
  + Grup keamanan yang dilampirkan ke instance GitHub Enterprise Server Anda (bukan bagian dari penyiapan host) memerlukan akses masuk dan keluar dari antarmuka jaringan yang dibuat oleh koneksi.
+ Subnet VPC Anda harus berada di Availability Zone yang berbeda di Wilayah Anda. Availability Zone adalah lokasi berbeda yang diisolasi dari kegagalan di Availability Zone lainnya. Setiap subnet harus berada sepenuhnya dalam satu Availability Zone dan tidak dapat merentangkan zona.

Untuk informasi selengkapnya tentang bekerja dengan VPCs dan subnet, lihat Ukuran [VPC dan Subnet untuk IPv4 di Panduan](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Subnets.html#vpc-sizing-ipv4) Pengguna *Amazon* VPC.

**Informasi VPC yang Anda berikan untuk penyiapan host**

Ketika Anda membuat sumber daya host Anda untuk koneksi Anda pada langkah berikutnya, Anda harus memberikan hal berikut: 
+ ID **VPC: ID** VPC untuk server tempat instans Server GitHub Perusahaan Anda diinstal atau VPC yang memiliki akses ke instans Server GitHub Perusahaan yang diinstal melalui VPN atau Direct Connect.
+ **Subnet ID atau IDs:** ID subnet untuk server tempat instans Server GitHub Enterprise Anda diinstal atau subnet dengan akses ke instance GitHub Enterprise Server yang diinstal melalui VPN atau Direct Connect.
+ **Grup atau grup keamanan:** Grup keamanan untuk server tempat instans Server GitHub Perusahaan Anda diinstal atau grup keamanan dengan akses ke instans Server GitHub Perusahaan yang diinstal melalui VPN atau Direct Connect.
+ **Titik akhir:** Siapkan titik akhir server Anda dan lanjutkan ke langkah berikutnya.

Untuk informasi lebih lanjut, termasuk pemecahan masalah koneksi VPC atau host, lihat [Pemecahan masalah konfigurasi VPC untuk host Anda](troubleshooting-connections.md#troubleshooting-connections-host-vpc).

### Persyaratan izin
<a name="connections-create-host-prereq-permissions"></a>

Sebagai bagian dari proses pembuatan host, AWS CodeConnections buat sumber daya jaringan atas nama Anda untuk memfasilitasi konektivitas VPC. Ini termasuk antarmuka jaringan AWS CodeConnections untuk kueri data dari host Anda, dan titik akhir VPC atau host *PrivateLink*untuk mengirim data peristiwa melalui webhook ke koneksi. Untuk dapat membuat sumber daya jaringan ini, pastikan bahwa peran yang digunakan untuk membuat host memiliki izin berikut:

```
ec2:CreateNetworkInterface
ec2:CreateTags
ec2:DescribeDhcpOptions
ec2:DescribeNetworkInterfaces
ec2:DescribeSubnets
ec2:DeleteNetworkInterface
ec2:DescribeVpcs
ec2:CreateVpcEndpoint
ec2:DeleteVpcEndpoints
ec2:DescribeVpcEndpoints
```

Untuk informasi selengkapnya tentang pemecahan masalah izin atau koneksi host di VPC, lihat [Pemecahan masalah konfigurasi VPC untuk host Anda](troubleshooting-connections.md#troubleshooting-connections-host-vpc).

Untuk informasi selengkapnya tentang VPC endpoint webhook, lihat [AWS CodeConnections dan antarmuka titik akhir VPC ()AWS PrivateLink](vpc-interface-endpoints.md).

**Topics**
+ [(Opsional) Prasyarat: Konfigurasi VPC Jaringan atau Amazon untuk koneksi Anda](#connections-create-host-prereq)
+ [Membuat host untuk koneksi (konsol)](#connections-host-create-console)
+ [Buat host untuk koneksi (CLI)](#connections-host-create-cli)

## Membuat host untuk koneksi (konsol)
<a name="connections-host-create-console"></a>

Untuk koneksi untuk instalasi, seperti dengan GitHub Enterprise Server atau dengan GitLab dikelola sendiri, Anda menggunakan host untuk mewakili titik akhir infrastruktur tempat penyedia pihak ketiga Anda diinstal.

**catatan**  
Mulai 1 Juli 2024, konsol membuat koneksi dengan `codeconnections` ARN sumber daya. Sumber daya dengan kedua awalan layanan akan terus ditampilkan di konsol.

Untuk mempelajari tentang pertimbangan menyiapkan host di VPC, lihat [Buat koneksi ke GitLab self-managed](connections-create-gitlab-managed.md).

Untuk menggunakan konsol untuk membuat host dan koneksi ke GitHub Enterprise Server, lihat[Buat koneksi GitHub Enterprise Server Anda (konsol)](connections-create-gheserver-console.md#connections-create-gheserver-connection). Konsol membuat host Anda untuk Anda.

Untuk menggunakan konsol untuk membuat host dan koneksi ke GitLab kelola sendiri, lihat[Buat koneksi ke GitLab self-managed](connections-create-gitlab-managed.md). Konsol membuat host Anda untuk Anda.

**catatan**  
Anda hanya membuat host satu kali per Server GitHub Perusahaan atau akun yang GitLab dikelola sendiri. Semua koneksi Anda ke Server GitHub Perusahaan tertentu atau akun yang GitLab dikelola sendiri akan menggunakan host yang sama.

## Buat host untuk koneksi (CLI)
<a name="connections-host-create-cli"></a>

Anda dapat menggunakan AWS Command Line Interface (AWS CLI) untuk membuat host untuk koneksi terinstal. 

**catatan**  
Anda hanya membuat host satu kali per akun GitHub Enterprise Server. Semua koneksi Anda ke akun GitHub Enterprise Server tertentu akan menggunakan host yang sama.

Anda menggunakan host untuk mewakili titik akhir infrastruktur tempat penyedia pihak ketiga Anda diinstal. Untuk membuat sebuah host dengan CLI, Anda menggunakan perintah **create-host**. Setelah Anda selesai membuat host, host dalam status **Tertunda**. Anda kemudian *mengatur* host untuk memindahkannya ke status **Tersedia**. Setelah host tersedia, Anda menyelesaikan langkah-langkah untuk membuat koneksi.

**penting**  
Host yang dibuat melalui status AWS CLI berada dalam `Pending` status secara default. Setelah Anda membuat host dengan CLI, gunakan konsol untuk mengatur host untuk membuat statusnya `Available`.

Untuk menggunakan konsol untuk membuat host dan koneksi ke GitHub Enterprise Server, lihat[Buat koneksi GitHub Enterprise Server Anda (konsol)](connections-create-gheserver-console.md#connections-create-gheserver-connection). Konsol membuat host Anda untuk Anda.

Untuk menggunakan konsol untuk membuat host dan koneksi ke GitLab kelola sendiri, lihat[Buat koneksi ke GitLab self-managed](connections-create-gitlab-managed.md). Konsol membuat host Anda untuk Anda.