Menyiapkan akses Amplify ke GitHub repositori - AWS Amplify Hosting
Menginstal dan mengotorisasi GitHub Aplikasi Amplify untuk penerapan baruMemigrasi aplikasi yang ada keOAuth Aplikasi Amplify GitHub Menyiapkan GitHub Aplikasi Amplify untukAWS CloudFormation, CLI, dan penerapan SDKMenyiapkan pratinjau web dengan GitHub Aplikasi Amplify

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

Menyiapkan akses Amplify ke GitHub repositori

Amplify sekarang menggunakan fitur GitHub Apps untuk mengotorisasi akses read-only Amplify ke GitHub repositori. Dengan GitHub Aplikasi Amplify, izin lebih baik disetel, memungkinkan Anda untuk memberikan akses Amplify hanya ke repositori yang Anda tentukan. Untuk mempelajari lebih lanjut tentang GitHub Aplikasi, lihat Tentang GitHub Aplikasi di GitHub situs web.

Saat Anda menghubungkan aplikasi baru yang disimpan di GitHub repo, secara default Amplify menggunakan GitHub Aplikasi untuk mengakses repo. Namun, aplikasi Amplify yang ada yang sebelumnya Anda sambungkan dari GitHub repo menggunakan OAuth untuk akses. CI/CD akan terus berfungsi untuk aplikasi ini, tetapi kami sangat menyarankan Anda memigrasinya untuk menggunakan GitHub Aplikasi Amplify baru.

Saat Anda menerapkan aplikasi baru atau memigrasi aplikasi yang ada menggunakan konsol Amplify, Anda secara otomatis diarahkan ke lokasi penginstalan untuk GitHub Aplikasi Amplify. Untuk mengakses halaman arahan penginstalan aplikasi secara manual, buka browser web dan navigasikan ke aplikasi berdasarkan wilayah. Gunakan formathttps://github.com/apps/aws-amplify-REGION, ganti REGION dengan wilayah tempat Anda akan menerapkan aplikasi Amplify Anda. Misalnya, untuk menginstal GitHub Aplikasi Amplify di wilayah AS Barat (Oregon), navigasikan ke https://github.com/apps/aws-amplify-us-west -2.

Menginstal dan mengotorisasi GitHub Aplikasi 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 GitHub Aplikasi.

Untuk menginstal dan mengotorisasi GitHub Aplikasi Amplify

  1. Masuk ke AWS Management Console, lalu buka Konsol Amplify.

  2. Dari halaman Semua aplikasi, pilih Aplikasi baru, lalu Host aplikasi web.

  3. Pada halaman Memulai dengan Amplify Hosting, pilih GitHub, lalu pilih Lanjutkan.

  4. Jika ini adalah pertama kalinya menghubungkan GitHub repositori, Halaman baru terbuka di browser Anda di GitHub .com, meminta izin untuk mengotorisasiAWS Amplify di GitHub akun Anda. Pilih Izinkan.

  5. Selanjutnya, Anda harus menginstal GitHub Aplikasi Amplify di GitHub akun Anda. Sebuah halaman terbuka di GitHub.com meminta izin untuk menginstal dan mengotorisasiAWS Amplify di GitHub akun Anda.

  6. Pilih GitHub akun tempat Anda ingin menginstal GitHub Aplikasi Amplify.

  7. Lakukan salah satu dari 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.

  8. Pilih Instal & Otorisasi.

  9. Anda akan diarahkan ke halaman Add repository branch untuk aplikasi Anda di konsol Amplify.

  10. Dalam daftar repositori yang baru diperbarui, pilih nama repositori yang akan dihubungkan.

  11. Di daftar Cabang, pilih nama cabang repositori untuk dihubungkan.

  12. Pilih Selanjutnya.

  13. Pada halaman Konfigurasi pengaturan build, pilih Berikutnya.

  14. Di halaman Tinjauan, pilih Simpan dan deploy.

Memigrasi aplikasi yang ada keOAuth Aplikasi Amplify GitHub

Aplikasi Amplify yang ada yang sebelumnya Anda sambungkan dari GitHub repositori menggunakan OAuth untuk akses repo. Kami sangat menyarankan Anda memigrasikan aplikasi ini untuk menggunakan GitHub Aplikasi Amplify.

Gunakan petunjuk berikut untuk memigrasi aplikasi dan menghapus webhook OAuth yang terkait di GitHub akun Anda. Perhatikan bahwa prosedur migrasi bervariasi tergantung pada apakah GitHub aplikasi Amplify sudah diinstal. Setelah memigrasi aplikasi pertama dan menginstal dan mengotorisasi GitHub Aplikasi, Anda hanya perlu memperbarui izin repositori untuk migrasi aplikasi berikutnya.

Memigrasi aplikasi dari OAuth ke GitHub Aplikasi

  1. Masuk ke AWS Management Console, lalu buka Konsol Amplify.

  2. Pilih aplikasi yang ingin Anda migrasikan.

  3. Di halaman informasi aplikasi, cari warna biru Migrasi ke pesan GitHub Aplikasi kami dan pilih Mulai migrasi.

  4. Pada halaman Instal dan otorisasi GitHub Aplikasi, pilih Konfigurasi GitHub Aplikasi.

  5. Halaman baru terbuka di browser Anda di GitHub .com, meminta izin untuk mengotorisasiAWS Amplify di GitHub akun Anda. Pilih Izinkan.

  6. Pilih GitHub akun tempat Anda ingin menginstal GitHub Aplikasi Amplify.

  7. Lakukan salah satu dari 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.

  8. Pilih Instal & Otorisasi.

  9. Anda akan 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.

  10. Pada halaman Instalasi lengkap, pilih Instalasi lengkap. Langkah ini menghapus webhook Anda yang ada, membuat yang baru, dan menyelesaikan migrasi.

Menyiapkan GitHub Aplikasi Amplify untukAWS CloudFormation, CLI, dan penerapan SDK

Aplikasi Amplify yang ada yang sebelumnya Anda sambungkan dari GitHub repositori menggunakan OAuth untuk akses repo. Ini dapat mencakup aplikasi yang Anda gunakan menggunakan Amplify Command Line Interface (CLI)AWS CloudFormation, atau SDK. Kami sangat menyarankan Anda memigrasikan aplikasi ini untuk menggunakan GitHub Aplikasi Amplify baru. Migrasi harus dilakukan di konsol Amplify diAWS Management Console. Untuk petunjuk, lihat Memigrasi aplikasi yang ada keOAuth Aplikasi Amplify GitHub .

Anda dapat menggunakanAWS CloudFormation, Amplify CLI, dan SDK untuk menerapkan aplikasi Amplify baru yang menggunakan GitHub Aplikasi untuk akses repo. Proses ini mengharuskan Anda menginstal GitHub Aplikasi Amplify terlebih dahulu di GitHub akun Anda. Selanjutnya, Anda perlu membuat token akses pribadi di GitHub akun Anda. Terakhir, men-deploy aplikasi dan tentukan token akses pribadi.

Instal GitHub Aplikasi Amplify di akun Anda

  1. Buka browser web dan arahkan ke lokasi instalasi untuk GitHub Aplikasi Amplify diAWS Wilayah tempat Anda akan menerapkan aplikasi Anda.

    Gunakan formathttps://github.com/apps/aws-amplify-REGION/installations/new, ganti REGION dengan input Anda sendiri. Misalnya, jika Anda menginstal aplikasi di wilayah US West (Oregon), tentukanhttps://github.com/apps/aws-amplify-us-west-2/installations/new.

  2. Pilih GitHub akun tempat Anda ingin menginstal GitHub aplikasi Amplify.

  3. Lakukan salah satu dari 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.

  4. Pilih Instal.

Buat token akses pribadi di GitHub akun Anda

  1. Masuk ke GitHub akun Anda.

  2. Di sudut kanan atas, cari foto profil Anda dan pilih Pengaturan dari menu.

  3. Di menu navigasi kiri, pilih Pengaturan pengembang.

  4. Pada halaman GitHub Aplikasi, di menu navigasi kiri, pilih Token akses pribadi.

  5. Pada halaman Token akses pribadi, pilih Hasilkan token baru.

  6. Pada halaman token akses pribadi baru, untuk Catatan masukkan nama deskriptif untuk token.

  7. Di bagian Select scopes, pilih admin:repo_hook.

  8. Pilih Hasilkan token.

  9. Salin dan simpan token akses pribadi. Anda harus menyediakannya saat Anda menerapkan aplikasi Amplify dengan CLI,AWS CloudFormation, atau SDK.

Setelah GitHub aplikasi Amplify diinstal di GitHub akun Anda dan Anda telah membuat token akses pribadi, Anda dapat menerapkan aplikasi baru dengan Amplify CLIAWS CloudFormation,, atau SDK. GunakanaccessToken bidang untuk menentukan token akses pribadi yang Anda buat di prosedur sebelumnya. Untuk informasi selengkapnya, lihat CreateAppdi referensi Amplify API dan AWS::Amplify::Appdi PanduanAWS CloudFormation Pengguna.

Perintah CLI berikut menerapkan aplikasi Amplify baru yang menggunakan GitHub App untuk akses repositori. 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 GitHub Aplikasi Amplify

Pratinjau web men-deploy setiap permintaan tarik pada GitHub repositori Anda ke URL pratinjau unik. Pratinjau sekarang menggunakan GitHub Aplikasi Amplify untuk akses ke GitHub repo Anda. Untuk petunjuk tentang menginstal dan mengotorisasi GitHub App untuk pratinjau web, lihatMengaktifkan pratinjau web.