

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

# Pemecahan masalah koneksi
<a name="troubleshooting-connections"></a>

Informasi berikut dapat membantu Anda memecahkan masalah umum dengan koneksi ke sumber daya di AWS CodeBuild, AWS CodeDeploy, dan AWS CodePipeline.

**Topics**
+ [Saya tidak dapat membuat koneksi](#troubleshooting-connections-cannot-create)
+ [Saya mendapatkan kesalahan izin saat mencoba membuat atau menyelesaikan koneksi](#troubleshooting-connections-permissions-error-console)
+ [Saya mendapatkan kesalahan izin saat mencoba menggunakan koneksi](#troubleshooting-connections-permissions-error-useconnection)
+ [Koneksi tidak dalam status tersedia atau tidak lagi tertunda](#troubleshooting-connections-error-notpending)
+ [Tambahkan GitClone izin untuk koneksi](#troubleshooting-connections-gitclone-permissions)
+ [Host tidak dalam status tersedia](#troubleshooting-connections-host-pending)
+ [Memecahkan masalah host dengan kesalahan koneksi](#troubleshooting-connections-host-errors)
+ [Saya tidak dapat membuat koneksi untuk host saya](#troubleshooting-connections-host-cannot-create)
+ [Pemecahan masalah konfigurasi VPC untuk host Anda](#troubleshooting-connections-host-vpc)
+ [Memecahkan masalah titik akhir VPC webhook (PrivateLink) untuk koneksi Server Perusahaan GitHub](#troubleshooting-connections-host-vpc-webhook)
+ [GitHub Koneksi Server Perusahaan tetap dalam Pending (proxy keluar atau firewall memblokir webhook instalasi)](#troubleshooting-GHES-webhook-blocked)
+ [Pemecahan masalah untuk host yang dibuat sebelum 24 November 2020](#troubleshooting-connections-host-vpc-webhook-host)
+ [Tidak dapat membuat koneksi untuk GitHub repositori](#troubleshooting-connections-GitHub-admin)
+ [Mengedit izin aplikasi koneksi GitHub Enterprise Server Anda](#troubleshooting-GHES-app-permissions)
+ [Kesalahan koneksi saat menghubungkan ke GitHub: “Terjadi masalah, pastikan cookie diaktifkan di browser Anda” atau “Pemilik organisasi harus menginstal GitHub aplikasi”](#troubleshooting-GitHub-organization-owner)
+ [Awalan layanan koneksi di sumber daya mungkin perlu diperbarui untuk kebijakan IAM](#troubleshoot-service-prefix)
+ [Kesalahan izin karena awalan layanan dalam sumber daya yang dibuat menggunakan konsol](#troubleshoot-service-prefix-console-permissions)
+ [Penyiapan koneksi dan host untuk penyedia yang mendukung organisasi yang diinstal](#troubleshooting-organization-host)
+ [Saya ingin meningkatkan batas saya untuk koneksi](#troubleshooting-connections-limit-increase)

## Saya tidak dapat membuat koneksi
<a name="troubleshooting-connections-cannot-create"></a>

Anda mungkin tidak memiliki izin untuk membuat koneksi. Untuk informasi lebih lanjut, lihat [Izin dan contoh untukAWS CodeConnections](security_iam_id-based-policy-examples-connections.md).

## Saya mendapatkan kesalahan izin saat mencoba membuat atau menyelesaikan koneksi
<a name="troubleshooting-connections-permissions-error-console"></a>

Pesan kesalahan berikut mungkin dikembalikan saat Anda mencoba membuat atau melihat koneksi di CodePipeline konsol.

Pengguna: {{username}} tidak berwenang untuk melakukan: {{permission}} pada sumber daya: {{connection-ARN}} 

Jika pesan ini muncul, pastikan bahwa Anda memiliki izin yang memadai.

Izin untuk membuat dan melihat koneksi di AWS Command Line Interface (AWS CLI) atau hanya Konsol Manajemen AWS sebagian dari izin yang Anda perlukan untuk membuat dan menyelesaikan koneksi di konsol. Izin yang diperlukan untuk hanya melihat, mengedit, atau membuat koneksi dan kemudian menyelesaikan koneksi yang tertunda harus dicakupkan ke bawah untuk pengguna yang hanya perlu melakukan tugas-tugas tertentu. Untuk informasi lebih lanjut, lihat [Izin dan contoh untukAWS CodeConnections](security_iam_id-based-policy-examples-connections.md).

## Saya mendapatkan kesalahan izin saat mencoba menggunakan koneksi
<a name="troubleshooting-connections-permissions-error-useconnection"></a>

Salah satu atau kedua pesan kesalahan berikut mungkin dikembalikan jika Anda mencoba menggunakan koneksi di CodePipeline konsol, meskipun Anda memiliki izin untuk membuat daftar, mendapatkan, dan membuat izin.

Anda gagal mengotentikasi akun Anda. 

Pengguna: tidak {{username}} berwenang untuk melakukan: codestar-connection: pada sumber daya: UseConnection {{connection-ARN}} 

Jika hal ini terjadi, pastikan bahwa Anda memiliki izin yang memadai.

Pastikan Anda memiliki izin untuk menggunakan koneksi, termasuk mencantumkan repositori yang tersedia di lokasi penyedia. Untuk informasi lebih lanjut, lihat [Izin dan contoh untukAWS CodeConnections](security_iam_id-based-policy-examples-connections.md).

## Koneksi tidak dalam status tersedia atau tidak lagi tertunda
<a name="troubleshooting-connections-error-notpending"></a>

Jika konsol menampilkan pesan bahwa koneksi tidak dalam status tersedia, pilih **Selesaikan koneksi**.

Jika Anda memilih untuk menyelesaikan koneksi dan muncul pesan bahwa koneksi tidak dalam status tertunda, Anda dapat membatalkan permintaan karena koneksi sudah dalam status tersedia.

Jika koneksi Anda ke Server GitHub Perusahaan mencapai AWS melalui internet publik melalui proxy atau firewall, webhook instalasi yang diblokir dapat meninggalkan koneksi di `Pending` negara bagian tersebut. Lihat [GitHub Koneksi Server Perusahaan tetap dalam Pending (proxy keluar atau firewall memblokir webhook instalasi)](#troubleshooting-GHES-webhook-blocked).

## Tambahkan GitClone izin untuk koneksi
<a name="troubleshooting-connections-gitclone-permissions"></a>

Saat Anda menggunakan AWS CodeStar koneksi dalam tindakan sumber dan CodeBuild tindakan, ada dua cara artefak input dapat diteruskan ke build:
+ Default: Tindakan sumber menghasilkan file zip yang berisi kode yang CodeBuild diunduh.
+ Klon Git: Kode sumber dapat langsung diunduh ke lingkungan pembangunan. 

  Mode klon Git memungkinkan Anda untuk berinteraksi dengan kode sumber sebagai repositori Git yang berfungsi. Untuk menggunakan mode ini, Anda harus memberikan izin CodeBuild lingkungan Anda untuk menggunakan koneksi.

Untuk menambahkan izin ke kebijakan peran CodeBuild layanan Anda, Anda membuat kebijakan yang dikelola pelanggan yang Anda lampirkan ke peran CodeBuild layanan Anda. Langkah-langkah berikut membuat kebijakan di mana izin `UseConnection` ditentukan di bidang `action`, dan koneksi Amazon Resource Name (ARN) ditentukan di bidang `Resource`. 

**Untuk menggunakan konsol untuk menambahkan UseConnection izin**

1. Untuk menemukan ARN koneksi untuk alur Anda, buka alur Anda dan pilih ikon (**i**) pada tindakan sumber Anda. Panel Konfigurasi terbuka, dan koneksi ARN muncul di sebelah ** ConnectionArn**. Anda menambahkan koneksi ARN ke kebijakan peran CodeBuild layanan Anda.

1. Untuk menemukan peran CodeBuild layanan Anda, buka proyek build yang digunakan dalam pipeline Anda dan navigasikan ke ** tab Detail ** build.

1. Di bagian Lingkungan, pilih tautan **Peran layanan**. Ini membuka konsol AWS Identity and Access Management (IAM), tempat Anda dapat menambahkan kebijakan baru yang memberikan akses ke koneksi Anda.

1. Pada konsol IAM, pilih **Lampirkan kebijakan**, lalu pilih **Buat kebijakan**.

   Gunakan templat kebijakan sampel berikut. Tambahkan ARN koneksi Anda di bidang `Resource`, seperti yang ditunjukkan dalam contoh ini.

------
#### [ JSON ]

****  

   ```
   {
       "Version":"2012-10-17",		 	 	 
       "Statement": [
           {
               "Effect": "Allow",
               "Action": "codestar-connections:UseConnection",
               "Resource": "{{arn:aws:iam::*:role/Service*}}"
           }
       ]
   }
   ```

------

   Pada tab **JSON**, tempel kebijakan Anda.

1. Pilih **Tinjau kebijakan**. Masukkan nama untuk kebijakan (misalnya, **connection-permissions**), lalu pilih **Buat kebijakan**.

1. Kembali ke halaman **Lampirkan Izin** peran layanan, segarkan daftar kebijakan, dan pilih kebijakan yang baru saja Anda buat. Pilih **Lampirkan kebijakan**.

## Host tidak dalam status tersedia
<a name="troubleshooting-connections-host-pending"></a>

Jika konsol menampilkan pesan bahwa host tidak dalam status `Available`, pilih **Menyiapkan host**.

Langkah pertama untuk pembuatan host menghasilkan host yang dibuat sekarang dalam status `Pending`. Untuk memindahkan host ke status `Available`, Anda harus memilih untuk menyiapkan host di konsol. Untuk informasi selengkapnya, lihat [Menyiapkan host yang tertunda](connections-host-setup.md). 

**catatan**  
Anda tidak dapat menggunakan AWS CLI untuk mengatur `Pending` host.

## Memecahkan masalah host dengan kesalahan koneksi
<a name="troubleshooting-connections-host-errors"></a>

Koneksi dan host dapat pindah ke status kesalahan jika GitHub aplikasi yang mendasarinya dihapus atau dimodifikasi. Host dan koneksi dalam status kesalahan tidak dapat dipulihkan dan host harus dibuat ulang.
+ Tindakan seperti mengubah kunci pem aplikasi, mengubah nama aplikasi (setelah pembuatan awal) akan menyebabkan host dan semua koneksi terkait masuk ke status kesalahan.

Jika konsol atau CLI mengembalikan host atau koneksi yang terkait dengan host dengan status `Error`, Anda mungkin perlu melakukan langkah berikut:
+ Hapus dan buat ulang sumber daya host dan kemudian instal ulang aplikasi pendaftaran host. Untuk informasi selengkapnya, lihat [Membuat host](connections-host-create.md). 

**catatan**  
Jika koneksi tetap dalam `Pending` status (bukan `Error` status) karena AWS tidak menerima webhook instalasi, Anda dapat memulihkannya tanpa menghapus host atau koneksi. Lihat [GitHub Koneksi Server Perusahaan tetap dalam Pending (proxy keluar atau firewall memblokir webhook instalasi)](#troubleshooting-GHES-webhook-blocked).

## Saya tidak dapat membuat koneksi untuk host saya
<a name="troubleshooting-connections-host-cannot-create"></a>

 

Untuk membuat koneksi atau host, syarat-syarat berikut diperlukan.
+ Host Anda harus dalam status **TERSEDIA**. Untuk informasi selengkapnya, lihat 
+ Koneksi harus dibuat di Wilayah yang sama dengan host.

## Pemecahan masalah konfigurasi VPC untuk host Anda
<a name="troubleshooting-connections-host-vpc"></a>

Saat Anda membuat sumber daya host, Anda harus menyediakan koneksi jaringan atau informasi VPC untuk infrastruktur tempat instans Server GitHub Perusahaan diinstal. Untuk memecahkan masalah konfigurasi VPC atau subnet untuk host Anda, gunakan contoh informasi VPC yang ditampilkan di sini sebagai referensi.

**catatan**  
Gunakan bagian ini untuk pemecahan masalah yang terkait dengan konfigurasi host Server GitHub Perusahaan Anda dalam Amazon VPC. Untuk pemecahan masalah yang terkait dengan koneksi Anda yang dikonfigurasi untuk menggunakan titik akhir webhook untuk VPC (PrivateLink), lihat. [Memecahkan masalah titik akhir VPC webhook (PrivateLink) untuk koneksi Server Perusahaan GitHub](#troubleshooting-connections-host-vpc-webhook)

Untuk contoh ini, Anda akan menggunakan proses berikut untuk mengonfigurasi VPC dan server tempat instans Server GitHub Enterprise Anda akan diinstal:

1. Membuat VPC. Untuk informasi lebih lanjut, lihat [https://docs.aws.amazon.com/vpc/latest/userguide/working-with-vpcs.html#Create-VPC](https://docs.aws.amazon.com/vpc/latest/userguide/working-with-vpcs.html#Create-VPC).

1. Membuat subnet di VPC Anda. Untuk informasi lebih lanjut, lihat [https://docs.aws.amazon.com/vpc/latest/userguide/working-with-vpcs.html#AddaSubnet](https://docs.aws.amazon.com/vpc/latest/userguide/working-with-vpcs.html#AddaSubnet).

1. Meluncurkan instans ke VPC Anda. Untuk informasi selengkapnya, lihat [https://docs.aws.amazon.com/vpc/latest/userguide/working-with-vpcs.html#VPC_Launch_Instance](https://docs.aws.amazon.com/vpc/latest/userguide/working-with-vpcs.html#VPC_Launch_Instance).

**catatan**  
Setiap VPC hanya dapat dikaitkan dengan satu host (instance GitHub Enterprise Server) pada satu waktu.

Gambar berikut menunjukkan instance EC2 yang diluncurkan menggunakan GitHub Enterprise AMI.

![Tangkapan layar konsol yang menampilkan deskripsi instans](https://docs.aws.amazon.com/id_id/dtconsole/latest/userguide/images/instance-vpc.png)


Saat Anda menggunakan VPC untuk koneksi Server GitHub Perusahaan, Anda harus menyediakan hal-hal berikut untuk infrastruktur saat menyiapkan host:
+ **ID VPC: ** VPC untuk server tempat instans Server GitHub Perusahaan diinstal atau VPC yang memiliki akses ke instans Server GitHub Perusahaan yang diinstal melalui VPN atau Direct Connect.
+ **ID atau ID Subnet: Sub ** net untuk server tempat instans Server GitHub Perusahaan diinstal atau subnet dengan akses ke instans Server GitHub Perusahaan yang diinstal melalui VPN atau Direct Connect.
+ **Grup atau grup keamanan: ** Grup keamanan untuk server tempat instans Server GitHub Perusahaan 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 tentang bekerja dengan VPC dan subnet, lihat [Pengukuran VPC dan Subnet untuk IPv4](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Subnets.html#vpc-sizing-ipv4) di *Panduan Pengguna Amazon VPC*.

**Topics**
+ [Saya tidak bisa mendapatkan host dalam status tertunda](#troubleshooting-connections-host-vpc-failed)
+ [Saya tidak bisa mendapatkan host dalam status tersedia](#troubleshooting-connections-host-vpc-app)
+ [connection/host Saya bekerja dan telah berhenti bekerja sekarang](#troubleshooting-connections-host-vpc-stopped)
+ [Saya tidak dapat menghapus antarmuka jaringan saya](#troubleshooting-connections-host-vpc-delete)

### Saya tidak bisa mendapatkan host dalam status tertunda
<a name="troubleshooting-connections-host-vpc-failed"></a>

Jika host Anda memasuki status VPC\_CONFIG\_FAILED\_INITIALIZATION, hal ini mungkin karena masalah dengan VPC, subnet, atau grup keamanan yang telah Anda pilih untuk host Anda.
+ VPC, subnet, dan grup keamanan semuanya harus dimiliki oleh akun yang membuat host.
+ Subnet dan grup keamanan harus milik VPC yang dipilih.
+ Setiap subnet yang disediakan harus berada di Availability Zone yang berbeda.
+ Pengguna yang membuat host harus memiliki izin IAM berikut:

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

### Saya tidak bisa mendapatkan host dalam status tersedia
<a name="troubleshooting-connections-host-vpc-app"></a>

Jika Anda tidak dapat menyelesaikan penyiapan CodeConnections aplikasi untuk host Anda, itu mungkin karena masalah dengan konfigurasi VPC atau instans Server GitHub Perusahaan Anda.
+ Jika Anda tidak menggunakan otoritas sertifikat publik, Anda harus memberikan sertifikat TLS ke host yang digunakan oleh Instans GitHub Perusahaan Anda. Nilai Sertifikat TLS harus menjadi kunci publik sertifikat.
+ Anda harus menjadi administrator instance GitHub Enterprise Server untuk membuat GitHub aplikasi.

### connection/host Saya bekerja dan telah berhenti bekerja sekarang
<a name="troubleshooting-connections-host-vpc-stopped"></a>

Jika a berfungsi connection/host sebelumnya dan tidak berfungsi sekarang, itu bisa karena perubahan konfigurasi di VPC Anda atau GitHub aplikasi telah dimodifikasi. Periksa hal-hal berikut:
+ Grup keamanan yang dilampirkan ke sumber daya host yang Anda buat untuk koneksi sekarang telah berubah atau tidak lagi memiliki akses ke Server GitHub Perusahaan. CodeConnections memerlukan grup keamanan yang memiliki konektivitas ke instance Server GitHub Enterprise.
+ IP Server DNS baru-baru ini berubah. Anda dapat memverifikasi ini dengan memeriksa opsi DHCP yang dilampirkan ke VPC yang ditentukan dalam sumber daya host yang Anda buat untuk koneksi Anda. Perhatikan bahwa jika Anda baru saja pindah dari AmazonProvided DNS ke Server DNS khusus atau mulai menggunakan Server DNS khusus baru, itu host/connection akan berhenti berfungsi. Untuk memperbaikinya, hapus host Anda yang ada dan buat ulang, yang akan menyimpan pengaturan DNS terbaru di basis data kami.
+ Pengaturan ACL jaringan telah berubah dan tidak lagi mengizinkan koneksi HTTP ke subnet tempat infrastruktur Server GitHub Perusahaan Anda berada.
+ Konfigurasi CodeConnections aplikasi apa pun di Server GitHub Perusahaan Anda telah berubah. Modifikasi pada konfigurasi apa pun, seperti URL atau rahasia aplikasi, dapat merusak konektivitas antara instance Server GitHub Perusahaan yang diinstal dan CodeConnections.

### Saya tidak dapat menghapus antarmuka jaringan saya
<a name="troubleshooting-connections-host-vpc-delete"></a>

Jika Anda tidak dapat mendeteksi antarmuka jaringan Anda, periksa hal berikut:
+ Antarmuka Jaringan yang dibuat oleh hanya CodeConnections dapat dihapus dengan menghapus host. Mereka tidak dapat dihapus secara manual oleh pengguna.
+ Anda harus memiliki izin berikut:

  ```
  ec2:DescribeNetworkInterfaces
  ec2:DeleteNetworkInterface
  ```

## Memecahkan masalah titik akhir VPC webhook (PrivateLink) untuk koneksi Server Perusahaan GitHub
<a name="troubleshooting-connections-host-vpc-webhook"></a>

Saat Anda membuat host dengan konfigurasi VPC, VPC endpoint webhook dibuat untuk Anda. 

**catatan**  
Gunakan bagian ini untuk pemecahan masalah yang terkait dengan koneksi Anda yang dikonfigurasi untuk menggunakan titik akhir webhook untuk VPC ()PrivateLink. Untuk pemecahan masalah yang terkait dengan konfigurasi host Server GitHub Enterprise Anda dalam Amazon VPC, lihat[Pemecahan masalah konfigurasi VPC untuk host Anda](#troubleshooting-connections-host-vpc).

Ketika Anda membuat koneksi ke jenis penyedia yang diinstal, dan Anda telah menentukan bahwa server Anda dikonfigurasi dalam VPC, kemudian membuat host AWS CodeConnections Anda, dan titik akhir VPC (PrivateLink) untuk webhook dibuat untuk Anda. Ini memungkinkan tuan rumah mengirim data acara melalui webhook ke AWS layanan terintegrasi Anda melalui jaringan Amazon. Untuk informasi selengkapnya, lihat [AWS CodeConnections dan antarmuka titik akhir VPC ()AWS PrivateLink](vpc-interface-endpoints.md).

**Topics**
+ [Saya tidak dapat menghapus VPC endpoint webhook saya](#troubleshooting-connections-host-vpc-webhook-delete)

### Saya tidak dapat menghapus VPC endpoint webhook saya
<a name="troubleshooting-connections-host-vpc-webhook-delete"></a>

AWS CodeConnections mengelola siklus hidup titik akhir VPC webhook untuk host Anda. Jika Anda ingin menghapus titik akhir, Anda harus melakukan ini dengan menghapus sumber daya host yang sesuai.
+ Titik akhir VPC webhook (PrivateLink) yang dibuat oleh hanya CodeConnections dapat dihapus dengan [ menghapus ](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-host-delete.html) host. Mereka tidak dapat dihapus secara manual.
+ Anda harus memiliki izin berikut:

  ```
  ec2:DescribeNetworkInterfaces
  ec2:DeleteNetworkInterface
  ```

## GitHub Koneksi Server Perusahaan tetap dalam Pending (proxy keluar atau firewall memblokir webhook instalasi)
<a name="troubleshooting-GHES-webhook-blocked"></a>

Saat Anda membuat koneksi ke Server GitHub Perusahaan yang menjangkau AWS melalui internet publik, instance Server GitHub Enterprise Anda harus mengirim `installation.created` webhook satu kali ke AWS. Instans Anda mengirimkan webhook ini setelah Anda menginstal GitHub Aplikasi, dan men AWS daftarkan penginstalan aplikasi hanya ketika menerima webhook. Jika proxy atau firewall keluar di depan instans Server GitHub Enterprise Anda memblokir permintaan itu, jangan AWS pernah mendaftarkan instalasi, dan Anda tidak dapat menyelesaikan koneksi.

**Gejala **
+ Host Anda mencapai `Available` status dan GitHub Aplikasi berhasil diinstal di Server GitHub Perusahaan, tetapi koneksi tetap dalam `Pending` status tersebut.
+ Saat Anda menggunakan koneksi, AWS mengembalikan kesalahan berikut:

  ProviderResourceNotFoundException: Instal {{id}} asi tidak ada 

Kesalahan ini berarti bahwa AWS tidak menerima webhook instalasi, sehingga instalasi tidak pernah terdaftar. Itu tidak berarti ID instalasi tidak valid.

**Resolusi**

1. Izinkan HTTPS keluar (port 443) dari instance Server GitHub Perusahaan Anda (termasuk melalui proxy atau firewall apa pun) ke titik akhir CodeConnections webhook untuk Wil AWS ayah Anda:. `https://{{region}}.codestar-connections.webhooks.aws/` Ganti {{region}} dengan AWS Wilayah host dan koneksi Anda. Misalnya, di Wilayah Timur AS (Virginia Utara):`https://us-east-1.codestar-connections.webhooks.aws/`. Jika proxy Anda mendukung wildcard dan Anda menggunakan lebih dari satu Wilayah, Anda dapat mengi `https://*.codestar-connections.webhooks.aws/` zinkannya.
**catatan**  
Instans Server GitHub Enterprise Anda mengirimkan `installation.created` webhook hanya sekali, saat Anda menginstal aplikasi. Setelah Anda mengizinkan titik akhir, Anda harus mengirim ulang webhook menggunakan salah satu opsi berikut. Mengizinkan titik akhir saja tidak menyelesaikan koneksi yang sudah dalam `Pending` status.

1. Re-send instalasi webhook menggunakan salah satu opsi berikut. Anda tidak perlu menghapus host atau koneksi Anda untuk memulihkan koneksi yang ada di `Pending` negara bagian.

**Opsi 1: Mengirimkan kembali webhook yang gagal (disarankan)**

   1. Di GitHub Enterprise Server, sebagai pemilik aplikasi, buka pengaturan lanjutan aplikasi. Dari drop-down pada foto profil Anda, pilih Peng ** aturan**. Pilih ** Pengaturan pengembang**, lalu pilih ** GitHub Aplikasi**. Dalam daftar aplikasi, pilih nama aplikasi untuk koneksi Anda (nama aplikasi default adalah ** AWS**; jika Anda memilih nama yang berbeda saat membuat koneksi, pilih nama itu sebagai gantinya), lalu pilih L ** anjutan**.

   1. Di ** bawah Pengiriman ** Terbaru, temukan `installation.created` pengiriman yang gagal dan perluas.

   1. Pilih Men ** girim Ul ** ang, dan konfirmasikan bahwa pengiriman sekarang berhasil.

   1. Kembali ke koneksi di AWS konsol dan pilih Per ** barui koneksi yang tertunda ** untuk menyelesaikan penyiapan.

**Opsi 2: Instal ulang GitHub Aplikasi**

   1. Di Server GitHub Perusahaan, buka aplikasi yang diinstal organisasi Anda. Pilih Peng ** aturan organisasi Anda**, lalu pilih GitHub Aplikasi ** yang diinstal**.

   1. Untuk CodeConnections aplikasi, pilih ** Konfigurasi**, lalu pilih ** Uninstall**.

   1. Kembali ke koneksi di AWS konsol dan pilih Perbarui koneksi ** yang tertunda**. Menyelesaikan alur menginstal ulang aplikasi dan mengirimkan webhook instalasi baru.

**catatan**  
Bagian ini berlaku untuk host yang terhubung melalui internet publik. Jika host Anda dikonfigurasi dalam Amazon VPC, webhook dikirimkan melalui titik akhir VPC () PrivateLink sebagai gantinya. Untuk konfigurasi tersebut, lihat[Memecahkan masalah titik akhir VPC webhook (PrivateLink) untuk koneksi Server Perusahaan GitHub](#troubleshooting-connections-host-vpc-webhook).

## Pemecahan masalah untuk host yang dibuat sebelum 24 November 2020
<a name="troubleshooting-connections-host-vpc-webhook-host"></a>

Mulai 24 November 2020, saat AWS CodeConnections menyiapkan host Anda, dukungan VPC endpoint (PrivateLink) tambahan disiapkan untuk Anda. Untuk host yang dibuat sebelum pembaruan ini, gunakan bagian pemecahan masalah ini.

Untuk informasi lebih lanjut, lihat [AWS CodeConnections dan antarmuka titik akhir VPC ()AWS PrivateLink](vpc-interface-endpoints.md).

**Topics**
+ [Saya memiliki host yang dibuat sebelum 24 November 2020 dan saya ingin menggunakan titik akhir VPC (PrivateLink) untuk webhook](#troubleshooting-connections-host-vpc-webhook-create)
+ [Saya tidak bisa mendapatkan host dalam status tersedia (kesalahan VPC)](#troubleshooting-connections-host-vpc-error-pre-webhook)

### Saya memiliki host yang dibuat sebelum 24 November 2020 dan saya ingin menggunakan titik akhir VPC (PrivateLink) untuk webhook
<a name="troubleshooting-connections-host-vpc-webhook-create"></a>

Saat Anda mengatur host untuk GitHub Enterprise Server, titik akhir webhook dibuat untuk Anda. Koneksi sekarang menggunakan titik akhir PrivateLink webhook VPC. Jika Anda membuat host sebelum 24 November 2020, dan Anda ingin menggunakan titik akhir PrivateLink webhook VPC, Anda harus terlebih dahulu [ menghapus host ](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-host-delete.html) Anda dan kemudian [ membuat host ](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-host-create.html) baru.

### Saya tidak bisa mendapatkan host dalam status tersedia (kesalahan VPC)
<a name="troubleshooting-connections-host-vpc-error-pre-webhook"></a>

Jika host Anda dibuat sebelum 24 November 2020, dan Anda tidak dapat menyelesaikan penyiapan CodeConnections aplikasi untuk host Anda, itu mungkin karena masalah dengan konfigurasi VPC atau instans Server GitHub Perusahaan Anda.

VPC Anda akan memerlukan NAT Gateway (atau akses internet keluar) sehingga instance Server GitHub Enterprise Anda dapat mengirim lalu lintas jaringan keluar untuk webhook. GitHub 

## Tidak dapat membuat koneksi untuk GitHub repositori
<a name="troubleshooting-connections-GitHub-admin"></a>

**Masalah: ** 

Karena koneksi ke GitHub repositori menggunakan AWS Konektor untuk GitHub, Anda memerlukan izin pemilik organisasi atau izin admin ke repositori untuk membuat koneksi.

**Kemungkinan perbaikan: Untuk informasi tentang tingkat izin ** untuk GitHub repositori, lihat [ https://docs.github.com/en/free-pro-team @ latest/github /setting-up-and-managing- teams/permission organizations-dan- -levels-for-an-organization. ](https://docs.github.com/en/free-pro-team@latest/github/setting-up-and-managing-organizations-and-teams/permission-levels-for-an-organization)

## Mengedit izin aplikasi koneksi GitHub Enterprise Server Anda
<a name="troubleshooting-GHES-app-permissions"></a>

Jika Anda menginstal aplikasi untuk Server GitHub Perusahaan pada atau sebelum 23 Desember 2020, Anda mungkin perlu memberikan Read-only akses aplikasi kepada anggota organisasi. Jika Anda adalah pemilik GitHub aplikasi, ikuti langkah-langkah berikut untuk mengedit izin untuk aplikasi yang diinstal saat host Anda dibuat.

**catatan**  
Anda harus menyelesaikan langkah-langkah ini pada instans Server GitHub Enterprise Anda, dan Anda harus menjadi pemilik GitHub aplikasi.

1. Di Server GitHub Perusahaan, dari opsi drop-down pada foto profil Anda, pilih Peng ** aturan**.

1. Pilih ** Pengaturan pengembang**, lalu pilih ** GitHub Aplikasi**.

1. Dalam daftar aplikasi, pilih nama aplikasi untuk koneksi Anda, lalu pilih **Izin dan peristiwa** di tampilan pengaturan.

1. Di bawah ** Izin Organisasi**, untuk ** Anggota**, pilih ** Read-only ** dari ** drop-down ** Akses.  
![Antarmuka izin organisasi menunjukkan Anggota diatur ke tingkat Read-only akses.](https://docs.aws.amazon.com/id_id/dtconsole/latest/userguide/images/ghes-app-permissions.png)

1. Di **Menambahkan catatan ke pengguna**, tambahkan deskripsi alasan pembaruan. Pilih **Simpan perubahan**.

## Kesalahan koneksi saat menghubungkan ke GitHub: “Terjadi masalah, pastikan cookie diaktifkan di browser Anda” atau “Pemilik organisasi harus menginstal GitHub aplikasi”
<a name="troubleshooting-GitHub-organization-owner"></a>

**Masalah: ** 

Untuk membuat koneksi untuk GitHub repositori, Anda harus menjadi pemilik GitHub organisasi. Untuk repositori yang tidak berada di bawah organisasi, Anda harus menjadi pemilik repositori. Ketika koneksi dibuat oleh orang lain selain pemilik organisasi, permintaan dibuat untuk pemilik organisasi, dan salah satu kesalahan berikut ditampilkan: 

Masalah terjadi, pastikan cookie diaktifkan di browser Anda

ATAU

Pemilik organisasi harus menginstal GitHub aplikasi

**Kemungkinan perbaikan: ** Untuk repositori dalam GitHub organisasi, pemilik organisasi harus membuat koneksi ke GitHub repositori. Untuk repositori yang tidak berada di bawah organisasi, Anda harus menjadi pemilik repositori. 

## Awalan layanan koneksi di sumber daya mungkin perlu diperbarui untuk kebijakan IAM
<a name="troubleshoot-service-prefix"></a>

Pada 29 Maret 2024, layanan diubah namanya dari Connec AWS CodeStar tions menjadi AWS CodeConnections. Mulai 1 Juli 2024, konsol membuat koneksi dengan `codeconnections` sumber daya ARN. Sumber daya dengan kedua awalan layanan akan terus ditampilkan di konsol. Awalan layanan untuk sumber daya yang dibuat menggunakan konsol adalah`codeconnections`. Sumber SDK/CLI daya baru dibuat dengan `codeconnections` sumber daya ARN. Sumber daya yang dibuat akan secara otomatis memiliki awalan layanan baru. 

Berikut ini adalah sumber daya yang dibuat di AWS CodeConnections:
+ Koneksi
+ Host

**Masalah: **

Sumber daya yang telah dibuat dengan `codestar-connections` di ARN tidak akan secara otomatis diganti namanya menjadi awalan layanan baru di sumber daya ARN. Membuat sumber daya baru akan membuat sumber daya yang memiliki awalan layanan koneksi. Namun, kebijakan IAM dengan awalan `codestar-connections` layanan tidak akan berfungsi untuk sumber daya dengan awalan layanan baru. 

**Kemungkinan perbaikan: ** Untuk menghindari masalah akses atau izin untuk sumber daya, selesaikan tindakan berikut: 
+ Perbarui kebijakan IAM untuk awalan layanan baru. Jika tidak, sumber daya yang diubah namanya atau dibuat tidak akan dapat menggunakan kebijakan IAM.
+ Perbarui sumber daya untuk awalan layanan baru dengan membuatnya menggunakan konsol atau CLI/CDK/CFN.

Perbarui tindakan, sumber daya, dan kondisi dalam kebijakan yang sesuai. Dalam contoh berikut, `Resource` bidang telah diperbarui untuk kedua awalan layanan.

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": {
        "Effect": "Allow",
        "Action": [
            "codeconnections:UseConnection"
        ],
        "Resource": [
            "arn:aws:codestar-connections:*:*:connection/*",
            "arn:aws:codeconnections:*:*:connection/*"
        ]
    }
}
```

------

## Kesalahan izin karena awalan layanan dalam sumber daya yang dibuat menggunakan konsol
<a name="troubleshoot-service-prefix-console-permissions"></a>

Saat ini, sumber daya koneksi yang dibuat menggunakan konsol hanya akan memiliki awalan `codestar-connections` layanan. Untuk sumber daya yang dibuat menggunakan konsol, tindakan pernyataan kebijakan harus disertakan `codestar-connections` sebagai awalan layanan. 

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

**Masalah: **

Saat membuat sumber daya koneksi menggunakan konsol, awalan `codestar-connections` layanan harus digunakan dalam kebijakan. Saat menggunakan kebijakan dengan awalan `codeconnections` layanan dalam kebijakan, sumber daya koneksi yang dibuat menggunakan konsol menerima pesan kesalahan berikut: 

```
User: {{user_ARN}} is not authorized to perform: codestar-connections:{{action}} on resource: {{resource_ARN}} because no identity-based policy allows the codestar-connections:{{action}} action
```

**Kemungkinan perbaikan: ** Untuk sumber daya yang dibuat menggunakan konsol, tindakan pernyataan kebijakan harus disertakan `codestar-connections` sebagai awalan layanan, seperti yang ditunjukkan pada contoh kebijakan di[Contoh: Kebijakan untuk membuatAWS CodeConnectionsdengan konsol](security_iam_id-based-policy-examples-connections.md#security_iam_id-based-policy-examples-connections-console).

## Penyiapan koneksi dan host untuk penyedia yang mendukung organisasi yang diinstal
<a name="troubleshooting-organization-host"></a>

Untuk penyedia terinstal yang mendukung organisasi, seperti GitHub Organisasi, Anda tidak melewati host yang tersedia. Anda membuat host baru untuk setiap koneksi di organisasi Anda dan pastikan untuk memasukkan informasi yang sama di bidang jaringan berikut: 
+ **ID VPC **
+ **ID Subnet **
+ **ID grup keamanan **

Lihat langkah-langkah terkait untuk membuat koneksi [ GHES ](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-create-gheserver.html) atau koneksi yang [ GitLab dikelola sendiri. ](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-create-gitlab-managed.html)

## Saya ingin meningkatkan batas saya untuk koneksi
<a name="troubleshooting-connections-limit-increase"></a>

Anda dapat meminta kenaikan batas untuk batas tertentu di CodeConnections. Lihat informasi yang lebih lengkap di [Kuota untuk koneksi](limits-connections.md).