Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menyiapkan akses Amplify ke repositori GitHub
Amplify sekarang menggunakan fitur GitHub Apps untuk mengotorisasi akses hanya-baca Amplify ke repositori. GitHub Dengan GitHub Aplikasi Amplify, izin lebih disesuaikan, memungkinkan Anda memberikan Amplify akses hanya ke repositori yang Anda tentukan. Untuk mempelajari lebih lanjut tentang GitHub Aplikasi, lihat [Tentang GitHub Aplikasi](https://docs.github.com/en/developers/apps/getting-started-with-apps/about-apps#about-github-apps) di GitHub situs web.
Saat Anda menghubungkan aplikasi baru yang disimpan dalam GitHub repo, secara default Amplify menggunakan GitHub Aplikasi untuk mengakses repo. Namun, aplikasi Amplify yang sudah ada yang sebelumnya Anda sambungkan dari GitHub repo digunakan untuk OAuth akses. CI/CD akan terus berfungsi untuk aplikasi ini, tetapi kami sangat menyarankan Anda memigrasikannya untuk menggunakan Aplikasi GitHub Amplify baru.
Saat menerapkan aplikasi baru atau memigrasikan aplikasi yang sudah ada menggunakan konsol Amplify, Anda akan secara otomatis diarahkan ke lokasi penginstalan untuk Aplikasi Amplify. GitHub Untuk mengakses halaman arahan instalasi aplikasi secara manual, buka browser web dan navigasikan ke aplikasi berdasarkan wilayah. Gunakan format`https://github.com/apps/aws-amplify-{{REGION}}`, ganti {{REGION}} dengan wilayah tempat Anda akan menerapkan aplikasi Amplify. Misalnya, untuk menginstal GitHub Aplikasi Amplify di wilayah AS Barat (Oregon), navigasikan ke -2. https://github.com/apps/ aws-amplify-us-west
**Topics**
+ [Menginstal dan mengotorisasi Aplikasi GitHub Amplify untuk penerapan baru](#setting-up-github-app)
+ [Memigrasi aplikasi yang ada ke OAuth Aplikasi Amplify GitHub](#migrating-to-github-app-auth)
+ [Menyiapkan GitHub Aplikasi Amplify untuk penerapan, CloudFormation CLI, dan SDK](#setting-up-github-app-cloudformation)
+ [Menyiapkan pratinjau web dengan Aplikasi Amplify GitHub](#setting-up-github-app-pr-previews)
## Menginstal dan mengotorisasi Aplikasi GitHub Amplify untuk penerapan baru
Saat Anda menerapkan aplikasi baru ke Amplify dari kode yang ada di GitHub repo, gunakan petunjuk berikut untuk menginstal dan mengotorisasi Aplikasi. GitHub
**Untuk menginstal dan mengotorisasi Aplikasi Amplify GitHub**
1. Masuk ke Konsol Manajemen AWS dan buka konsol [Amplify](https://console.aws.amazon.com/amplify/).
1. Dari halaman **Semua aplikasi**, pilih **Aplikasi baru**, lalu **Host aplikasi web**.
1. **Pada halaman **Memulai dengan Amplify Hosting**, pilih **GitHub**, lalu pilih Lanjutkan.**
1. Jika ini adalah pertama kalinya menghubungkan GitHub repositori, Halaman baru terbuka di browser Anda di GitHub .com, meminta izin untuk mengotorisasi AWS Amplify di akun Anda. GitHub Pilih **Izinkan**.
1. Selanjutnya, Anda harus menginstal GitHub Aplikasi Amplify di akun Anda GitHub . Halaman terbuka di GitHub.com meminta izin untuk menginstal dan mengotorisasi AWS Amplify di akun Anda. GitHub
1. Pilih GitHub akun tempat Anda ingin menginstal Aplikasi Amplify GitHub .
1. Lakukan salah satu tindakan berikut:
+ Untuk menerapkan instalasi ke semua repositori, pilih **Semua** repositori.
+ Untuk membatasi instalasi ke repositori tertentu yang Anda pilih, pilih **Hanya pilih** repositori. Pastikan untuk menyertakan repo untuk aplikasi yang Anda migrasi di repo yang Anda pilih.
1. Pilih **Instal & Otorisasi**.
1. Anda diarahkan ke halaman **cabang Add repositori** untuk aplikasi Anda di konsol Amplify.
1. Dalam daftar **repositori yang baru diperbarui**, pilih nama repositori yang akan dihubungkan.
1. Dalam daftar **Branch**, pilih nama cabang repositori untuk terhubung.
1. Pilih **Berikutnya**.
1. Pada halaman **Konfigurasi pengaturan build**, pilih **Berikutnya**.
1. Di halaman **Tinjauan**, pilih **Simpan dan deploy**.
## Memigrasi aplikasi yang ada ke OAuth Aplikasi Amplify GitHub
Aplikasi Amplify yang ada yang sebelumnya Anda sambungkan dari GitHub repositori digunakan OAuth untuk akses repo. Kami sangat menyarankan Anda memigrasikan aplikasi ini untuk menggunakan Aplikasi GitHub Amplify.
Gunakan petunjuk berikut untuk memigrasikan aplikasi dan menghapus OAuth webhook yang sesuai di akun Anda GitHub . Perhatikan bahwa prosedur migrasi bervariasi tergantung pada apakah aplikasi GitHub Amplify sudah diinstal. Setelah memigrasikan aplikasi pertama Anda dan menginstal serta mengotorisasi GitHub Aplikasi, Anda hanya perlu memperbarui izin repositori untuk migrasi aplikasi berikutnya.
**Untuk memigrasikan aplikasi dari Aplikasi OAuth ke Aplikasi GitHub**
1. Masuk ke Konsol Manajemen AWS dan buka konsol [Amplify](https://console.aws.amazon.com/amplify/).
1. Pilih aplikasi yang ingin Anda migrasi.
1. Di halaman informasi aplikasi, cari pesan biru **Migrasi ke GitHub Aplikasi kami** dan pilih **Mulai migrasi**.
1. Pada halaman **Instal dan otorisasi GitHub Aplikasi**, pilih **Konfigurasi GitHub Aplikasi**.
1. Halaman baru terbuka di browser Anda di GitHub .com, meminta izin untuk mengotorisasi AWS Amplify di akun Anda GitHub . Pilih **Izinkan**.
1. Pilih GitHub akun tempat Anda ingin menginstal Aplikasi Amplify GitHub .
1. Lakukan salah satu tindakan berikut:
+ Untuk menerapkan instalasi ke semua repositori, pilih **Semua** repositori.
+ Untuk membatasi instalasi ke repositori tertentu yang Anda pilih, pilih **Hanya pilih** repositori. Pastikan untuk menyertakan repo untuk aplikasi yang Anda migrasi di repositori yang Anda pilih.
1. Pilih **Instal & Otorisasi**.
1. Anda diarahkan ke halaman **Instal dan otorisasi GitHub Aplikasi untuk aplikasi** Anda di konsol Amplify. Jika GitHub otorisasi berhasil, Anda akan melihat pesan sukses. Pilih, **Berikutnya**.
1. Pada halaman **Instalasi lengkap**, pilih **Instalasi lengkap**. Langkah ini menghapus webhook yang ada, membuat yang baru, dan menyelesaikan migrasi.
## Menyiapkan GitHub Aplikasi Amplify untuk penerapan, CloudFormation CLI, dan SDK
Aplikasi Amplify yang ada yang sebelumnya Anda sambungkan dari GitHub repositori digunakan OAuth untuk akses repo. Ini dapat mencakup aplikasi yang Anda gunakan menggunakan Amplify Command Line Interface (CLI) CloudFormation,, atau file. SDKs Kami sangat menyarankan Anda memigrasikan aplikasi ini untuk menggunakan Aplikasi GitHub Amplify yang baru. Migrasi harus dilakukan di konsol Amplify di. Konsol Manajemen AWS Untuk petunjuk, lihat [Memigrasi aplikasi yang ada ke OAuth Aplikasi Amplify GitHub](#migrating-to-github-app-auth).
Anda dapat menggunakan CloudFormation, Amplify CLI, dan SDKs untuk menerapkan aplikasi Amplify baru yang menggunakan Aplikasi untuk akses repo. GitHub Proses ini mengharuskan Anda menginstal GitHub Aplikasi Amplify terlebih dahulu di akun Anda GitHub . Selanjutnya, Anda perlu membuat token akses pribadi di GitHub akun Anda. Terakhir, terapkan aplikasi dan tentukan token akses pribadi.
**Instal GitHub Aplikasi Amplify di akun Anda**
1. Buka browser web dan navigasikan ke lokasi penginstalan untuk Amplify GitHub App di AWS Wilayah tempat Anda akan menerapkan aplikasi.
Gunakan format`https://github.com/apps/aws-amplify-{{REGION}}/installations/new`, ganti {{REGION}} dengan input Anda sendiri. Misalnya, jika Anda menginstal aplikasi di wilayah AS Barat (Oregon), tentukan`https://github.com/apps/aws-amplify-us-west-2/installations/new`.
1. Pilih GitHub akun tempat Anda ingin menginstal aplikasi Amplify GitHub .
1. Lakukan salah satu tindakan berikut:
+ Untuk menerapkan instalasi ke semua repositori, pilih **Semua** repositori.
+ Untuk membatasi instalasi ke repositori tertentu yang Anda pilih, pilih **Hanya pilih** repositori. Pastikan untuk menyertakan repo untuk aplikasi yang Anda migrasi di repo yang Anda pilih.
1. Pilih **Instal**.
**Buat token akses pribadi di GitHub akun Anda**
1. Masuk ke GitHub akun Anda.
1. Di sudut kanan atas, cari foto profil Anda dan pilih **Pengaturan** dari menu.
1. Di menu navigasi kiri, pilih **Pengaturan pengembang**.
1. Pada halaman **GitHub Aplikasi**, di menu navigasi kiri, pilih **Token akses pribadi**.
1. Pada halaman **Token akses pribadi**, pilih **Hasilkan token baru**.
1. Pada halaman **token akses pribadi baru**, untuk **Catatan** masukkan nama deskriptif untuk token.
1. Di bagian **Pilih cakupan**, pilih **admin:repo\_hook**.
1. Pilih **Hasilkan token**.
1. Salin dan simpan token akses pribadi. Anda harus menyediakannya saat Anda menerapkan aplikasi Amplify dengan CLI CloudFormation,, atau. SDKs
Setelah GitHub aplikasi Amplify diinstal di GitHub akun Anda dan Anda telah membuat token akses pribadi, Anda dapat menerapkan aplikasi baru dengan Amplify CLI,, atau. CloudFormation SDKs Gunakan `accessToken` bidang untuk menentukan token akses pribadi yang Anda buat di prosedur sebelumnya. Untuk informasi selengkapnya, lihat [CreateApp](https://docs.aws.amazon.com/amplify/latest/APIReference/API_CreateApp.html#API_CreateApp_RequestSyntax)di *referensi Amplify API* dan [AWS::Amplify::App](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-amplify-app.html)di *AWS CloudFormation Panduan Pengguna*.
Perintah CLI berikut menerapkan aplikasi Amplify baru yang menggunakan Aplikasi untuk akses repositori. GitHub Ganti {{myapp-using-githubapp}}{{https://github.com/Myaccount/react-app}},, dan {{MY\_TOKEN}} dengan informasi Anda sendiri.
```
aws amplify create-app --name {{myapp-using-githubapp}} --repository {{https://github.com/Myaccount/react-app}} --access-token {{MY_TOKEN}}
```
## Menyiapkan pratinjau web dengan Aplikasi Amplify GitHub
Pratinjau web menyebarkan setiap permintaan tarik (PR) yang dibuat ke GitHub repositori Anda ke URL pratinjau unik. Pratinjau sekarang menggunakan Aplikasi GitHub Amplify untuk akses ke GitHub repo Anda. Untuk petunjuk tentang menginstal dan mengotorisasi GitHub App untuk pratinjau web, lihat. [Aktifkan pratinjau web untuk permintaan tarik](pr-previews.md#enable-web-previews)