Membuat host

Anda dapat menggunakan AWS Management Console 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, lihatAlur kerja untuk membuat atau memperbarui host.

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 Pemecahan masalah konfigurasi VPC untuk host Anda

Untuk menggunakan konsol untuk membuat host dan koneksi ke GitHub Enterprise Server, lihatBuat koneksi GitHub Enterprise Server Anda (konsol). Konsol membuat host Anda untuk Anda.

Untuk menggunakan konsol untuk membuat host dan koneksi ke GitLab kelola sendiri, lihatBuat koneksi ke GitLab self-managed. Konsol membuat host Anda untuk Anda.

(Opsional) Prasyarat: Konfigurasi VPC Jaringan atau Amazon untuk koneksi Anda

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

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

Persyaratan VPC

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 AWS CodeStar Connections membuat host Anda, titik akhir VPC (PrivateLink) untuk webhook dibuat untuk Anda. Untuk informasi selengkapnya, lihat AWS CodeStar Koneksi dan antarmuka VPC endpoint (AWS PrivateLink).

• 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 lebih lanjut tentang bekerja dengan VPC dan subnet, lihat Pengukuran VPC dan Subnet untuk IPv4 di Panduan 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 ID: 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.

Persyaratan izin

Sebagai bagian dari proses pembuatan host, AWS CodeStar Connections menciptakan sumber daya jaringan atas nama Anda untuk memfasilitasi konektivitas VPC. Ini termasuk antarmuka jaringan untuk AWS Codestar Connections untuk menanyakan data dari host Anda, dan titik akhir VPC PrivateLinkatau host untuk mengirim data peristiwa melalui webhook ke Connections. AWS CodeStar 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.

Untuk informasi selengkapnya tentang VPC endpoint webhook, lihat AWS CodeStar Koneksi dan antarmuka VPC endpoint (AWS PrivateLink).

Membuat host untuk koneksi (konsol)

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.

Untuk mempelajari tentang pertimbangan menyiapkan host di VPC, lihat Buat koneksi ke GitLab self-managed.

Untuk menggunakan konsol untuk membuat host dan koneksi ke GitHub Enterprise Server, lihatBuat koneksi GitHub Enterprise Server Anda (konsol). Konsol membuat host Anda untuk Anda.

Untuk menggunakan konsol untuk membuat host dan koneksi ke GitLab kelola sendiri, lihatBuat koneksi ke GitLab self-managed. 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)

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

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 AWS CLI dalam status Pending 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, lihatBuat koneksi GitHub Enterprise Server Anda (konsol). Konsol membuat host Anda untuk Anda.

Untuk menggunakan konsol untuk membuat host dan koneksi ke GitLab kelola sendiri, lihatBuat koneksi ke GitLab self-managed. Konsol membuat host Anda untuk Anda.