Menerbitkan API dengan GitHub Actions
Anda menambahkan API ke aplikasi web dan keduanya berjalan secara lokal. Sekarang saatnya untuk menerbitkan API dan aplikasi Anda ke Azure Static Web Apps.
Saat Anda membuat instans Azure Static Web Apps dan memintanya untuk mengawasi cabang utama, GitHub Action dibuat untuk Anda. GitHub Action mendengarkan cabang utama repositori Anda untuk menerapkan dan menarik permintaan. Kemudian, saat GitHub Action mendeteksi perubahan ini, tindakan tersebut akan membuild dan menerbitkan aplikasi Anda.
Saat membuat sumber daya Azure Static Web Apps, Anda menyediakan lokasi folder untuk proyek API Anda dengan menerima nilai default Api. Azure Static Web Apps membangun dan menyebarkan aplikasi Azure Functions di folder tersebut. Namun, aplikasi tidak berfungsi karena HTTP GET API belum dibuat.
Memicu GitHub Action
GitHub Action siap untuk membuild dan menerbitkan aplikasi web dan API Anda setelah mendeteksi perubahan pada cabang utama. Anda dapat menerapkannya secara langsung atau membuat permintaan pull ke cabang utama. Kedua perubahan ini memicu GitHub Action. Ketika perubahan terdeteksi di cabang utama , itu memicu Tindakan GitHub untuk menerbitkan aplikasi di URL yang sama untuk situs web langsung Anda.
Lingkungan praproduksi dengan URL pratinjau
Terkadang, Anda ingin melihat perubahan di situs pentahapan sebelum menerbitkan ke situs web langsung. Azure Static Web Apps memungkinkan Anda melihat perubahan melalui lingkungan praproduksi yang masing-masing memiliki URL pratinjau mereka sendiri. Anda dapat membuat lingkungan praproduksi dengan membuat permintaan pull terhadap cabang yang sedang ditonton GitHub Action Anda. Situs web langsung Anda tidak terpengaruh. Sebagai gantinya, versi baru aplikasi Anda dibuat di lingkungan praproduksinya sendiri. Jika Anda kembali dan memeriksa permintaan pull di GitHub, Anda melihat bahwa tautan ke versi praproduksi diposting di tab Percakapan.
Tabel berikut ini memperlihatkan bagaimana Azure Static Web Apps menerbitkan aplikasi Anda ke URL yang berbeda. Aplikasi Anda diterbitkan ke satu URL saat permintaan pull ke cabang yang sama diterbitkan ke URL lain. URL yang dibuat secara otomatis ini disediakan oleh Azure Static Web Apps untuk aplikasi produksi dan permintaan pull. Anda dapat secara opsional menetapkan domain kustom ke aplikasi produksi.
| Sumber | Deskripsi | URL |
|---|---|---|
| cabang utama | Contoh URL situs web langsung | https://purple-rain-062d03304.azurestaticapps.net/ |
| Permintaan Pull #5 | Contoh URL pratinjau | https://purple-rain-062d03304-5.<location>.azurestaticapps.net/ |
Anda saat ini bekerja di cabang api. Anda membuat permintaan pull dari cabang api Anda ke cabang utama. Saat Anda membuat permintaan pull terhadap cabang utama , GitHub Action menerbitkan aplikasi ke lingkungan praproduksi.
Setelah alur kerja selesai membangun dan menyebarkan aplikasi Anda, bot GitHub menambahkan komentar ke permintaan pull Anda. Komentar ini berisi tautan ke URL lingkungan praproduksi. Anda dapat memilih tautan ini untuk melihat perubahan bertahap Anda.
Selanjutnya, Anda membuat permintaan pull dan mengunjungi versi bertahap aplikasi Anda.