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

# Perbarui tindakan sumber GitHub (melalui OAuth aplikasi) ke tindakan sumber GitHub (melalui GitHub Aplikasi)
<a name="update-github-action-connections"></a>

Di AWS CodePipeline, ada dua versi aksi GitHub sumber yang didukung:
+ **Direkomendasikan:** Tindakan GitHub (melalui GitHub Aplikasi) menggunakan autentikasi berbasis aplikasi Github yang didukung oleh sumber daya. [CodeStarSourceConnection untuk Bitbucket Cloud, GitHub Enterprise Server GitHub, GitLab .com, dan tindakan yang dikelola GitLab sendiri](action-reference-CodestarConnectionSource.md) Ini menginstal aplikasi AWS CodeStar Connections ke GitHub organisasi Anda sehingga Anda dapat mengelola akses di GitHub.
+ **Tidak disarankan:** Tindakan GitHub (melalui OAuth aplikasi) menggunakan OAuth token untuk mengautentikasi GitHub dan menggunakan webhook terpisah untuk mendeteksi perubahan. Ini bukan lagi metode yang direkomendasikan.

**catatan**  
Koneksi tidak tersedia di Asia Pasifik (Hong Kong), Asia Pasifik (Hyderabad), Asia Pasifik (Jakarta), Asia Pasifik (Melbourne), Asia Pasifik (Osaka), Afrika (Cape Town), Timur Tengah (Bahrain), Timur Tengah (UEA), Eropa (Spanyol), Eropa (Zurich), Israel (Tel Aviv), atau (AS-Barat) Wilayah. AWS GovCloud Untuk mereferensikan tindakan lain yang tersedia, lihat[Integrasi produk dan layanan dengan CodePipeline](integrations.md). Untuk pertimbangan dengan tindakan ini di Wilayah Eropa (Milan), lihat catatan di[CodeStarSourceConnection untuk Bitbucket Cloud, GitHub Enterprise Server GitHub, GitLab .com, dan tindakan yang dikelola GitLab sendiri](action-reference-CodestarConnectionSource.md).

Ada beberapa keuntungan penting menggunakan tindakan GitHub (melalui GitHub Aplikasi) alih-alih tindakan GitHub (melalui OAuth aplikasi):
+ Dengan koneksi, CodePipeline tidak lagi memerlukan OAuth aplikasi atau token akses pribadi untuk mengakses repositori Anda. Saat membuat sambungan, Anda menginstal GitHub Aplikasi yang mengelola autentikasi ke GitHub repositori dan mengizinkan izin di tingkat organisasi. Anda harus mengotorisasi OAuth token sebagai pengguna untuk mengakses repositori. Untuk informasi selengkapnya tentang GitHub akses OAuth berbasis yang berbeda dengan GitHub akses berbasis Aplikasi, lihat. [https://docs.github.com/en/developers/apps/differences-between-github-apps-and-oauth-apps](https://docs.github.com/en/developers/apps/differences-between-github-apps-and-oauth-apps)
+ Ketika Anda mengelola GitHub (melalui GitHub Aplikasi) tindakan di CLI atau CloudFormation, Anda tidak lagi harus menyimpan token akses pribadi Anda sebagai rahasia di Secrets Manager. Anda tidak lagi harus mereferensikan rahasia yang disimpan secara dinamis dalam konfigurasi CodePipeline tindakan Anda. Anda malah menambahkan ARN koneksi ke konfigurasi tindakan Anda. Untuk contoh konfigurasi tindakan, lihat[CodeStarSourceConnection untuk Bitbucket Cloud, GitHub Enterprise Server GitHub, GitLab .com, dan tindakan yang dikelola GitLab sendiri](action-reference-CodestarConnectionSource.md).
+ Saat membuat sumber daya koneksi untuk digunakan dengan tindakan GitHub (melalui GitHub Aplikasi) CodePipeline, Anda dapat menggunakan sumber daya koneksi yang sama untuk mengaitkan layanan lain yang didukung, seperti CodeGuru Peninjau, dengan repositori Anda.
+ Di Github (melalui GitHub Aplikasi), Anda dapat mengkloning repositori untuk mengakses metadata git dalam CodeBuild tindakan selanjutnya, sementara di Github (melalui OAuth aplikasi) Anda hanya dapat mengunduh sumbernya.
+ Administrator menginstal aplikasi untuk repositori organisasi Anda. Anda tidak lagi harus melacak OAuth token yang bergantung pada individu yang membuat token.

Semua aplikasi yang diinstal ke organisasi memiliki akses ke kumpulan repositori yang sama. Untuk mengubah siapa yang dapat mengakses setiap repositori, ubah kebijakan IAM untuk setiap koneksi. Sebagai contoh, lihat [Contoh: Kebijakan cakupan bawah untuk menggunakan koneksi dengan repositori tertentu](https://docs.aws.amazon.com/dtconsole/latest/userguide/security_iam_id-based-policy-examples-connections.html#security_iam_id-based-policy-examples-connections-reposcope).

Anda dapat menggunakan langkah-langkah dalam topik ini untuk menghapus tindakan sumber GitHub (melalui OAuth aplikasi) dan menambahkan tindakan sumber GitHub (melalui GitHub Aplikasi) dari CodePipeline konsol.

**Topics**
+ [Langkah 1: Ganti GitHub tindakan Anda (melalui OAuth aplikasi)](#connections-pipelines-github-action)
+ [Langkah 2: Buat koneksi ke GitHub](#connections-pipelines-github-create)
+ [Langkah 3: Simpan tindakan GitHub sumber Anda](#connections-pipelines-github-save)

## Langkah 1: Ganti GitHub tindakan Anda (melalui OAuth aplikasi)
<a name="connections-pipelines-github-action"></a>

Gunakan halaman edit pipeline untuk mengganti tindakan (melalui OAuth aplikasi) Anda dengan GitHub tindakan GitHub (melalui GitHub Aplikasi).

**Untuk mengganti GitHub tindakan Anda (melalui OAuth aplikasi)**

1. Masuk ke CodePipeline konsol.

1. Pilih pipeline Anda, dan pilih **Edit**. Pilih **Edit tahap** pada tahap sumber Anda. Sebuah pesan menampilkan yang merekomendasikan Anda memperbarui tindakan Anda.

1. Di **penyedia Tindakan**, pilih **GitHub (melalui GitHub Aplikasi)**.

1. Lakukan salah satu tindakan berikut:
   + Di bawah **Koneksi**, jika Anda belum membuat sambungan ke penyedia Anda, pilih **Connect to GitHub**. Lanjutkan ke Langkah 2: Buat koneksi ke GitHub.
   + Di bawah **Koneksi**, jika Anda telah membuat koneksi ke penyedia Anda, pilih koneksi. Lanjutkan ke Langkah 3: Simpan Tindakan Sumber untuk Koneksi Anda.

## Langkah 2: Buat koneksi ke GitHub
<a name="connections-pipelines-github-create"></a>

Setelah Anda memilih untuk membuat koneksi, GitHub halaman **Connect to** ditampilkan.

**Untuk membuat koneksi ke GitHub**

1. Di bawah **pengaturan GitHub koneksi**, nama koneksi Anda ditampilkan di **Nama koneksi**.

   Di bawah **GitHub Aplikasi**, pilih penginstalan aplikasi atau pilih **Instal aplikasi baru** untuk membuatnya.
**catatan**  
Anda menginstal satu aplikasi untuk semua koneksi Anda ke penyedia tertentu. Jika Anda telah menginstal GitHub aplikasi, pilih dan lewati langkah ini.

1. Jika halaman otorisasi untuk GitHub ditampilkan, masuk dengan kredensional Anda dan kemudian pilih untuk melanjutkan.

1. Di halaman penginstalan aplikasi, pesan menunjukkan bahwa AWS CodeStar aplikasi mencoba terhubung ke GitHub akun Anda.
**catatan**  
Anda hanya menginstal aplikasi sekali untuk setiap GitHub akun. Jika sebelumnya Anda menginstal aplikasi, Anda dapat memilih **Konfigurasi** untuk melanjutkan ke halaman modifikasi untuk instalasi aplikasi Anda, atau Anda dapat menggunakan tombol kembali untuk kembali ke konsol.

1. Pada AWS CodeStar halaman **Instal**, pilih **Instal**.

1. Pada GitHub halaman **Connect to**, ID koneksi untuk instalasi baru Anda ditampilkan. Pilih **Hubungkan**.

## Langkah 3: Simpan tindakan GitHub sumber Anda
<a name="connections-pipelines-github-save"></a>

Selesaikan pembaruan Anda di halaman **Edit tindakan** untuk menyimpan tindakan sumber baru Anda.

**Untuk menyimpan tindakan GitHub sumber Anda**

1. Di **Repositori**, masukkan nama repositori pihak ketiga Anda. Di **Branch**, masukkan cabang tempat Anda ingin pipeline mendeteksi perubahan sumber.
**catatan**  
Di **Repository**, ketik `owner-name/repository-name` seperti yang ditunjukkan dalam contoh ini:   

   ```
   my-account/my-repository
   ```

1. Dalam **format artefak Output**, pilih format untuk artefak Anda. 
   + Untuk menyimpan artefak keluaran dari GitHub tindakan menggunakan metode default, pilih **CodePipeline default**. Tindakan mengakses file dari GitHub repositori dan menyimpan artefak dalam file ZIP di toko artefak pipa.
   + **Untuk menyimpan file JSON yang berisi referensi URL ke repositori sehingga tindakan hilir dapat melakukan perintah Git secara langsung, pilih klon Penuh.** Opsi ini hanya dapat digunakan oleh tindakan CodeBuild hilir.

     Jika Anda memilih opsi ini, Anda perlu memperbarui izin untuk peran layanan CodeBuild proyek Anda seperti yang ditunjukkan pada[Tambahkan CodeBuild GitClone izin untuk koneksi ke Bitbucket,, GitHub Enterprise Server GitHub, atau .com GitLab](troubleshooting.md#codebuild-role-connections). Untuk tutorial yang menunjukkan cara menggunakan opsi **klon Penuh**, lihat[Tutorial: Gunakan klon lengkap dengan sumber GitHub pipa](tutorials-github-gitclone.md).

1. Di **artefak Output**, Anda dapat mempertahankan nama artefak keluaran untuk tindakan ini, seperti. `SourceArtifact` Pilih **Selesai** untuk menutup halaman **tindakan Edit**.

1. Pilih **Selesai** untuk menutup halaman pengeditan panggung. Pilih **Simpan** untuk menutup halaman pengeditan pipeline.