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

# Menghubungkan GitHub
<a name="connecting-to-cicd-pipelines-connecting-github"></a>

GitHub integrasi memungkinkan AWS DevOps Agen untuk mengakses repositori kode dan menerima peristiwa penyebaran selama investigasi insiden. Integrasi ini mengikuti proses dua langkah: pendaftaran tingkat akun GitHub, diikuti dengan menghubungkan repositori tertentu ke Ruang Agen individu.

AWS DevOps Agen mendukung GitHub instans.com (SaaS) dan Server GitHub Perusahaan (yang dihosting sendiri).

## Prasyarat
<a name="prerequisites"></a>

Sebelum menghubungkan GitHub, pastikan Anda memiliki:
+ Akses ke konsol admin AWS DevOps Agen
+ Akun GitHub pengguna atau organisasi dengan izin admin
+ Otorisasi untuk menginstal GitHub aplikasi di akun atau organisasi

Untuk GitHub Enterprise Server, Anda juga membutuhkan:
+ Instans GitHub Enterprise Server (versi 3.x atau yang lebih baru) dapat diakses melalui HTTPS
+ URL HTTPS dari instance Server GitHub Perusahaan Anda (misalnya,`https://github.example.com`)
+ (Opsional) Koneksi pribadi, jika instans Server GitHub Perusahaan Anda tidak dapat diakses publik

## Mendaftar GitHub (tingkat akun)
<a name="registering-github-account-level"></a>

GitHub terdaftar di tingkat AWS akun dan dibagikan di antara semua Ruang Agen di akun itu. Anda hanya perlu mendaftar GitHub sekali per AWS akun.

### Langkah 1: Arahkan ke penyedia pipa
<a name="step-1-navigate-to-pipeline-providers"></a>

1. Masuk ke Konsol AWS Manajemen

1. Arahkan ke konsol AWS DevOps Agen

1. Buka tab **Kemampuan**

1. Di bagian **Pipeline**, klik **Tambah**

1. Pilih **GitHub**dari daftar penyedia yang tersedia

Jika GitHub belum terdaftar, Anda akan diminta untuk mendaftarkannya terlebih dahulu.

### Langkah 2: Pilih jenis koneksi
<a name="step-2-choose-connection-type"></a>

Pada layar “Daftarkan GitHub Akun/Organisasi”, pilih apakah Anda terhubung sebagai pengguna atau organisasi:
+ **Pengguna** — GitHub Akun pribadi Anda dengan nama pengguna dan profil
+ **Organisasi** — GitHub Akun bersama tempat banyak orang dapat berkolaborasi di banyak proyek sekaligus

Jika Anda terhubung ke instance GitHub Enterprise Server, centang kotak centang **Use GitHub Enterprise Server** dan masukkan URL HTTPS instance Anda (misalnya,`https://github.example.com`).

Jika instans Server GitHub Perusahaan Anda tidak dapat diakses publik, Anda dapat mengonfigurasi sambungan pribadi secara opsional agar AWS DevOps Agen dapat menjangkau instans Anda dengan aman. Untuk informasi selengkapnya, lihat [Menghubungkan ke alat yang dihosting secara pribadi](configuring-capabilities-for-aws-devops-agent-connecting-to-privately-hosted-tools.md).

**catatan**  
**Jangan sertakan `/api/v3` atau trailing path apa pun di URL — masukkan hanya URL dasar.

### Langkah 3: Siapkan GitHub Aplikasi
<a name="step-3-set-up-the-github-app"></a>

Klik **Kirim** untuk memulai proses penyiapan aplikasi. Langkah selanjutnya berbeda tergantung pada apakah Anda terhubung GitHub ke.com atau GitHub Enterprise Server.

#### Untuk GitHub .com
<a name="for-githubcom"></a>

1. Anda akan diarahkan GitHub untuk menginstal GitHub aplikasi AWS DevOps Agen.

1. Pilih akun atau organisasi mana yang akan menginstal aplikasi.

1. Aplikasi ini memungkinkan AWS DevOps Agen untuk menerima peristiwa dari repositori yang terhubung, termasuk peristiwa penerapan.

#### Untuk Server GitHub Perusahaan
<a name="for-github-enterprise-server"></a>

GitHub Enterprise Server menggunakan alur Manifes GitHub Aplikasi, yang secara otomatis menyiapkan GitHub Aplikasi baru di instans Anda. Ini melibatkan dua pengalihan ke instance Server GitHub Enterprise Anda.

1. Browser Anda akan diarahkan ke halaman “Buat GitHub Aplikasi” instance GitHub Enterprise Server Anda.

1. Anda akan melihat nama aplikasi yang sudah diisi sebelumnya. Jangan ragu untuk mengubah nama sesuai kebutuhan. Klik **Buat GitHub Aplikasi**.

1. Anda akan diarahkan kembali ke AWS DevOps Agen, yang menukar kode manifes dengan kredensi aplikasi.

### Langkah 4: Pilih repositori dan selesaikan instalasi
<a name="step-4-select-repositories-and-complete-installation"></a>

1. Anda akan melihat halaman **Instal & Otorisasi** untuk GitHub Aplikasi.

1. Pilih repositori mana yang memungkinkan aplikasi mengakses:
   + **Semua repositori** - Berikan akses ke semua repositori saat ini dan masa depan
   + **Hanya pilih repositori - Pilih repositori** tertentu dari akun atau organisasi Anda

1. Klik **Instal & Otorisasi**.

1. Anda akan diarahkan kembali ke konsol AWS DevOps Agen, di mana GitHub akan muncul sebagai terdaftar di tingkat akun.

## Menghubungkan repositori ke Ruang Agen
<a name="connecting-repositories-to-an-agent-space"></a>

Setelah mendaftar GitHub di tingkat akun, Anda dapat menghubungkan repositori tertentu ke Ruang Agen individual:

1. Di konsol AWS DevOps Agen, pilih Ruang Agen

1. Buka tab **Kemampuan**

1. Di bagian **Pipeline**, klik **Tambah**

1. Pilih **GitHub**dari daftar penyedia yang tersedia

1. Pilih subset repositori yang relevan dengan Ruang Agen ini

1. Klik **Tambah** untuk menyelesaikan koneksi

Anda dapat menghubungkan kumpulan repositori yang berbeda ke Ruang Agen yang berbeda berdasarkan kebutuhan organisasi Anda.

## Memahami GitHub aplikasi
<a name="understanding-the-github-app"></a>

 GitHub Aplikasi AWS DevOps Agen:
+ Meminta akses ke repositori Anda — Anda dapat meninjau izin tertentu selama instalasi Aplikasi GitHub 
+ Menerima peristiwa penyebaran dan acara repositori lainnya
+ Memungkinkan AWS DevOps Agen untuk mengkorelasikan perubahan kode dengan insiden operasional
+ Dapat di-uninstall kapan saja melalui pengaturan Anda GitHub 

Untuk Server GitHub Perusahaan, GitHub Aplikasi secara otomatis dibuat pada instans Anda saat pendaftaran. Anda dapat mengelola akses repositori aplikasi atau menghapus instalannya melalui **Pengaturan> Aplikasi > Aplikasi** Terinstal. GitHub Untuk menghapus definisi aplikasi sepenuhnya, buka **Pengaturan > Pengaturan pengembang > GitHub Aplikasi**.

## GitHub Pembaruan izin aplikasi
<a name="github-app-permission-updates"></a>

AWS DevOps Agen dapat meminta pembaruan izin setelah Anda menginstal GitHub Aplikasi untuk mendukung fitur baru. Ketika ini terjadi:

1. Anda akan menerima pemberitahuan dari GitHub mengenai permintaan pembaruan izin.

1. Tinjau detail pembaruan untuk memahami izin baru apa yang diminta.

1. Terima permintaan untuk memberikan izin yang diperbarui.

Tidak ada perubahan yang diperlukan dalam layanan atau aplikasi Anda. Setelah Anda menerima izin yang diperbarui, token akses instalasi berikutnya yang diminta AWS DevOps Agen GitHub akan secara otomatis menyertakan izin baru.

**catatan**  
**Sampai Anda menerima pembaruan izin, AWS DevOps Agen terus beroperasi dengan izin yang diberikan sebelumnya. Kemampuan baru yang bergantung pada izin yang diperbarui tidak akan tersedia sampai Anda menyetujui permintaan tersebut.

## Mengelola GitHub koneksi
<a name="managing-github-connections"></a>
+ **Memperbarui akses repositori** — Untuk mengubah repositori mana yang dapat diakses GitHub aplikasi, buka pengaturan GitHub akun atau organisasi Anda (atau pengaturan instans Server GitHub Perusahaan Anda), navigasikan ke aplikasi yang diinstal, dan ubah konfigurasi GitHub aplikasi Agen. AWS DevOps 
+ **Melihat repositori yang terhubung** - Di konsol AWS DevOps Agen, pilih Ruang Agen Anda dan buka tab Kemampuan untuk melihat repositori yang terhubung di bagian Pipeline.
+ **Menghapus GitHub koneksi** - Untuk memutuskan sambungan GitHub dari Ruang Agen, pilih koneksi di bagian Pipeline dan klik **Hapus**. Untuk menghapus instalan GitHub aplikasi sepenuhnya, hapus instalannya dari pengaturan GitHub akun atau organisasi Anda. Untuk Server GitHub Perusahaan, karena GitHub Aplikasi dibuat langsung pada instans Anda saat pendaftaran, Anda dapat membersihkan aplikasi secara opsional sepenuhnya dengan melakukan kedua hal berikut:
  + **Copot pemasangan aplikasi** — Buka **Pengaturan> Aplikasi > GitHub Aplikasi Terinstal**, klik **Konfigurasi** pada aplikasi, lalu hapus instalannya.
  + **Hapus aplikasi** — Buka **Pengaturan> Pengaturan pengembang > GitHub Aplikasi**, pilih aplikasi, buka tab **Lanjutan**, dan pilih **Hapus GitHub Aplikasi**. **Peringatan:** Menghapus GitHub Aplikasi bersifat permanen dan tidak dapat dibatalkan. Jika Anda menghapusnya, Anda harus mendaftarkan ulang GitHub Enterprise Server dari awal di konsol AWS DevOps Agen untuk membuat aplikasi baru.