Meninjau permintaan pull di lingkungan pra-produksi
Artikel ini memperlihatkan kepada Anda cara menggunakan lingkungan pra-produksi untuk meninjau perubahan pada aplikasi yang disebarkan dengan Azure Static Web Apps. Lingkungan pra-produksi adalah versi bertahap yang berfungsi penuh dari aplikasi Anda yang menyertakan perubahan yang tidak tersedia dalam produksi.
Catatan
Lingkungan permintaan pull tidak didukung secara otomatis untuk Azure DevOps, tetapi Anda dapat menggunakan lingkungan bernama untuk menyiapkannya secara manual.
Azure Static Web Apps menghasilkan alur kerja YAML di repositori. Saat permintaan pull dibuat terhadap cabang yang ditonton alur kerja, lingkungan pra-produksi akan dibangun. Lingkungan pra-produksi mentahapkan aplikasi, sehingga Anda dapat meninjau perubahan sebelum mendorongnya ke produksi. Siklus hidup lingkungan pra-produksi terkait dengan permintaan pull. Setelah permintaan pull ditutup, lingkungan pra-produksi akan dihapus secara otomatis.
Anda dapat melakukan tugas berikut dalam lingkungan pra-produksi:
- Tinjau perubahan visual antara produksi dan penahapan, seperti pembaruan pada konten dan tata letak
- Menunjukkan perubahan pada tim Anda
- Membandingkan versi aplikasi Anda yang berbeda
- Memvalidasi perubahan menggunakan pengujian penerimaan
- Lakukan pemeriksaan kewarasan sebelum Anda menyebarkan ke produksi
Prasyarat
- Repositori GitHub yang ada dikonfigurasi dengan Azure Static Web Apps. Lihat Membuat aplikasi statis pertama Anda jika belum memilikinya.
Membuat perubahan
Buat perubahan dalam repositori Anda langsung di GitHub, seperti yang ditunjukkan pada langkah-langkah berikut.
Buka repositori proyek Anda di GitHub, lalu pilih Cabang.
Masukkan nama cabang dan pilih Buat cabang.
Buka folder aplikasi Anda dan ubah beberapa konten teks, seperti judul atau paragraf. Pilih Edit untuk membuat perubahan dalam file.
Pilih Terapkan perubahan saat Anda selesai.
Membuat permintaan pull
Buat permintaan pull untuk menerbitkan pembaruan Anda.
Buka tab Permintaan pull proyek Anda di GitHub.
Pilih Bandingkan &tarik permintaan.
Secara opsional, masukkan detail tentang perubahan Anda, lalu pilih Buat permintaan pull.
Tetapkan peninjau dan tambahkan komentar untuk membahas perubahan Anda, jika diperlukan.
Beberapa lingkungan pra-produksi dapat ada bersamaan pada saat yang sama saat Anda menggunakan Azure Static Web Apps. Setiap kali Anda membuat permintaan pull terhadap cabang yang ditonton, versi bertahap dengan perubahan Anda disebarkan ke lingkungan pra-produksi yang berbeda.
Anda dapat membuat beberapa perubahan dan mendorong penerapan baru ke cabang Anda. Permintaan pull secara otomatis diperbarui untuk mencerminkan semua perubahan.
Meninjau perubahan
Alur kerja penyebaran GitHub Actions berjalan dan menyebarkan perubahan permintaan pull Anda ke lingkungan pra-produksi.
Setelah alur kerja selesai membangun dan menyebarkan aplikasi Anda, bot GitHub menambahkan komentar ke permintaan pull Anda, yang berisi URL lingkungan pra-produksi.
Pilih URL pra-produksi untuk melihat perubahan bertahap Anda.
URL terdiri seperti ini:
https://<SUBDOMAIN-PULL_REQUEST_ID>.<AZURE_REGION>.azurestaticapps.net. Untuk permintaan pull tertentu, URL tetap sama, bahkan jika Anda mendorong pembaruan baru. Lingkungan pra-produksi yang sama juga digunakan kembali untuk masa pakai permintaan pull.
Untuk mengotomatiskan proses peninjauan dengan pengujian end-to-end, GitHub Action untuk menyebarkan Azure Static Web Apps memiliki static_web_app_url variabel output.
Anda dapat mereferensikan URL ini di sisa alur kerja Anda untuk menjalankan pengujian terhadap lingkungan pra-produksi.
Menerbitkan perubahan
Gabungkan permintaan pull untuk diterbitkan ke produksi.
Pilih Gabungkan permintaan pull.
Perubahan Anda akan disalin ke cabang yang dilacak (cabang "produksi"). Kemudian, alur kerja penyebaran dimulai pada cabang yang dilacak dan perubahan ditayangkan setelah pembangunan kembali aplikasi Anda.
Buka URL produksi Anda untuk memuat versi langsung situs web dan verifikasi.
Pembatasan
Siapa pun dapat mengakses versi bertahap aplikasi Anda melalui URL mereka, bahkan jika repositori GitHub Anda bersifat pribadi.
Peringatan
Berhati-hatilah dengan konten sensitif, karena siapa pun dapat mengakses lingkungan pra-produksi.
Jumlah lingkungan pra-produksi yang tersedia untuk setiap aplikasi yang disebarkan dengan Static Web Apps bergantung pada paket hosting Anda. Misalnya, dengan tingkat Gratis, Anda dapat memiliki tiga lingkungan pra-produksi bersama dengan lingkungan produksi.
Lingkungan pra-produksi tidak didistribusikan secara geografis.
Hanya penyebaran Tindakan GitHub yang mendukung lingkungan pra-produksi.