Pratinjau web untuk permintaan tarik - AWS Amplify Hosting
Mengaktifkan pratinjau webAkses pratinjau web dengan subdomain

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

Pratinjau web untuk permintaan tarik

Dengan pratinjau web, tim pengembangan dan penjaminan kualitas (QA) dapat melihat pratinjau perubahan dari permintaan tarik (PR) sebelum kode digabungkan ke cabang produksi atau integrasi. Permintaan tarik membantu Anda memberi tahu orang lain tentang perubahan yang telah Anda dorong ke cabang di repositori. Setelah permintaan tarik dibuka, Anda dapat mendiskusikan dan meninjau kemungkinan perubahan dengan kolaborator dan menambahkan penerapan tindak lanjut sebelum perubahan digabungkan ke cabang dasar.

Pratinjau web menyebarkan setiap permintaan tarik yang dibuat ke repositori Anda ke URL pratinjau unik yang sama sekali berbeda dari URL yang digunakan situs utama Anda. Untuk aplikasi dengan lingkungan backend yang disediakan menggunakan Amplify CLI atau Amplify Studio, setiap permintaan tarik (hanya repositori Git pribadi) membuat backend sementara yang dihapus saat PR ditutup.

Saat pratinjau web diaktifkan untuk aplikasi Anda, setiap PR dihitung dalam kuota Amplify 50 cabang per aplikasi. Untuk menghindari melebihi kuota ini, pastikan untuk menutup PR Anda. Untuk informasi lebih lanjut tentang kuota, lihatKuota layanan Amplify Hosting.

catatan

Saat ini, variabel AWS_PULL_REQUEST_ID lingkungan tidak tersedia saat digunakan AWS CodeCommit sebagai penyedia repositori Anda.

Mengaktifkan pratinjau web

Untuk aplikasi yang disimpan dalam GitHub repo, pratinjau menggunakan GitHub Aplikasi Amplify untuk akses repo. Jika Anda mengaktifkan pratinjau web di aplikasi Amplify yang sudah ada yang sebelumnya Anda gunakan dari GitHub repo menggunakan OAuth untuk akses, Anda harus terlebih dahulu memigrasikan aplikasi untuk menggunakan Aplikasi Amplify. GitHub Untuk petunjuk migrasi, lihatMemigrasi aplikasi yang ada keOAuth Aplikasi Amplify GitHub .

penting

Untuk tujuan keamanan, Anda dapat mengaktifkan pratinjau web di semua aplikasi dengan repositori pribadi, tetapi tidak pada semua aplikasi dengan repositiori publik. Jika repositori Git Anda bersifat publik, Anda dapat mengatur pratinjau hanya untuk aplikasi yang tidak memerlukan peran layanan IAM.

Misalnya, aplikasi dengan backend dan aplikasi yang digunakan ke platform WEB_COMPUTE hosting memerlukan peran layanan IAM. Oleh karena itu, Anda tidak dapat mengaktifkan pratinjau web untuk jenis aplikasi ini jika repositori mereka bersifat publik.

Amplify memberlakukan pembatasan ini untuk mencegah pihak ketiga mengirimkan kode arbitrer yang akan berjalan menggunakan izin peran IAM aplikasi Anda.

Cara mengaktifkan pratinjau web untuk permintaan tarik

  1. Pilih Hosting, lalu Pratinjau.

    catatan

    Pratinjau terlihat di menu Pengaturan aplikasi hanya ketika aplikasi disiapkan untuk penerapan berkelanjutan dan terhubung ke repositori git. Untuk langkah-langkah seputar jenis deployment ini, lihat Memulai dengan kode yang ada.

  2. Hanya untuk GitHub repositori, lakukan hal berikut untuk menginstal dan mengotorisasi Aplikasi Amplify GitHub di akun Anda:

    1. Di jendela Instal GitHub Aplikasi untuk mengaktifkan pratinjau, pilih Instal GitHub aplikasi.

    2. Pilih GitHub akun tempat Anda ingin mengonfigurasi Aplikasi Amplify GitHub.

    3. Halaman terbuka di GitHub.com untuk mengonfigurasi izin repositori untuk akun Anda.

    4. Lakukan salah satu hal berikut ini:

      • 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 aktifkan pratinjau web di repositori yang Anda pilih.

    5. Pilih Simpan.

  3. Setelah Anda mengaktifkan pratinjau untuk repo Anda, kembali ke konsol Amplify untuk mengaktifkan pratinjau untuk cabang tertentu. Pada halaman Pratinjau, pilih cabang dari daftar dan pilih Edit pengaturan.

  4. Pada halaman Kelola pengaturan pratinjau, aktifkan Pratinjau permintaan tarik. Lalu, pilih Konfirmasi.

  5. Untuk aplikasi fullstack lakukan salah satu hal berikut:

    • Pilih, Buat lingkungan backend baru untuk setiap Permintaan Tarik. Opsi ini memungkinkan Anda untuk menguji perubahan tanpa memengaruhi produksi.

    • Pilih Arahkan semua Permintaan Tarik untuk cabang ini ke lingkungan yang ada.

  6. Pilih Konfirmasi.

Lain kali Anda mengirimkan permintaan tarik untuk cabang, Amplify membangun dan menerapkan PR Anda ke URL pratinjau. Setelah permintaan tarik ditutup, URL pratinjau akan dihapus, dan setiap lingkungan backend sementara yang tertaut ke permintaan tarik akan dihapus. Hanya untuk GitHub repositori, Anda dapat mengakses pratinjau URL Anda langsung dari permintaan tarik di akun Anda GitHub .

Akses pratinjau web dengan subdomain

Pratinjau web untuk permintaan tarik dapat diakses dengan subdomain untuk aplikasi Amplify yang terhubung ke domain khusus yang dikelola oleh Amazon Route 53. Ketika permintaan tarik ditutup, cabang dan subdomain yang terkait dengan permintaan tarik akan dihapus secara otomatis. Ini adalah perilaku default untuk pratinjau web setelah Anda mengatur deployment cabang fitur berbasis pola untuk aplikasi. Untuk langkah-langkah seputar pengaturan subdomain otomatis, lihat Menyiapkan subdomain otomatis untuk domain kustom Amazon Route 53.