Dukungan API di Azure Static Web Apps dengan Azure Container Apps
Azure Container Apps adalah platform terkelola untuk menghosting kontainer dan layanan mikro tanpa server.
Saat Anda menautkan aplikasi kontainer ke aplikasi web statis, permintaan apa pun ke aplikasi web statis Anda dengan rute yang dimulai dengan /api diproksikan ke rute yang sama di aplikasi kontainer.
Secara default, ketika aplikasi kontainer ditautkan ke aplikasi web statis, aplikasi kontainer hanya menerima permintaan yang diproksi melalui aplikasi web statis yang ditautkan. Aplikasi kontainer dapat ditautkan ke satu aplikasi web statis pada satu waktu.
Opsi API untuk Static Web Apps mencakup layanan Azure berikut:
Lihat gambaran umum API untuk informasi selengkapnya.
Catatan
Integrasi dengan Azure Container Apps memerlukan paket Static Web Apps Standard.
Integrasi backend tidak didukung pada lingkungan permintaan penarikan Static Web Apps.
Prasyarat
Untuk menautkan aplikasi kontainer ke aplikasi web statis, Anda harus memiliki sumber daya Container Apps yang sudah ada dan aplikasi web statis.
| Sumber daya | Deskripsi |
|---|---|
| Azure Container Apps | Jika Anda belum memilikinya, ikuti langkah-langkah dalam panduan Menyebarkan aplikasi kontainer pertama Anda. |
| Aplikasi web statis yang ada | Jika Anda belum memilikinya, ikuti langkah-langkah dalam panduan memulai untuk membuat aplikasi web statis Tanpa Kerangka Kerja . |
Contoh
Pertimbangkan instans Azure Container App yang sudah ada yang mengekspos titik akhir melalui lokasi berikut.
https://my-container-app.red-river-123.eastus2.azurecontainerapps.io/api/getProducts
Setelah ditautkan, Anda dapat mengakses titik akhir yang sama melalui jalur api dari aplikasi web statis Anda, seperti yang ditunjukkan dalam URL contoh ini.
https://red-sea-123.azurestaticapps.net/api/getProducts
Kedua URL menunjuk ke titik akhir API yang sama. Titik akhir pada aplikasi kontainer harus memiliki /api awalan, karena Static Web Apps cocok dengan permintaan yang dibuat dan /api menproksi seluruh jalur ke sumber daya yang ditautkan.
Menautkan aplikasi kontainer
Untuk menautkan aplikasi kontainer sebagai backend API untuk aplikasi web statis, ikuti langkah-langkah berikut:
Di portal Azure, buka aplikasi web statis.
Pilih API dari menu navigasi.
Temukan lingkungan yang ingin Anda tautkan instans API Management. Pilih Tautkan.
Di Jenis sumber daya backend, pilih Aplikasi Kontainer.
Di Langganan, pilih langganan yang berisi aplikasi kontainer yang ingin Anda tautkan.
Di Nama sumber daya, pilih aplikasi kontainer.
Pilih Tautkan.
Ketika proses penautan selesai, permintaan ke rute yang dimulai dengan /api diproksikan ke aplikasi kontainer yang ditautkan.
Mengelola akses ke aplikasi kontainer
Aplikasi kontainer Anda dikonfigurasi dengan idP bernama Azure Static Web Apps (Linked) yang hanya mengizinkan lalu lintas yang diproksi melalui aplikasi web statis. Untuk membuat aplikasi kontainer Anda dapat diakses oleh aplikasi lain, perbarui konfigurasi autentikasinya untuk menambahkan penyedia identitas lain atau mengubah pengaturan keamanan untuk memungkinkan akses yang tidak diautentikasi.
Membatalkan tautan aplikasi kontainer
Untuk membatalkan tautan aplikasi kontainer dari aplikasi web statis, ikuti langkah-langkah berikut:
Di portal Azure, buka aplikasi web statis.
Pilih API dari menu navigasi.
Temukan lingkungan yang ingin Anda batalkan tautannya dan pilih nama aplikasi kontainer.
Pilih Batalkan tautan.
Ketika proses pembatalan tautan selesai, permintaan ke rute yang dimulai dengan /api tidak lagi diproksikan ke aplikasi kontainer Anda.
Catatan
Untuk mencegah secara tidak sengaja mengekspos aplikasi kontainer Anda ke lalu lintas anonim, IdP yang dibuat oleh proses penautan tidak dihapus secara otomatis. Anda dapat menghapus penyedia identitas bernama Azure Static Web Apps (Tertaut) dari pengaturan autentikasi aplikasi kontainer.
Menghapus autentikasi dari sumber daya Container Apps
Untuk mengaktifkan sumber daya Container Apps Anda untuk menerima lalu lintas anonim, ikuti langkah-langkah berikut untuk menghapus penyedia identitas:
Di portal Azure, navigasikan ke sumber daya Aplikasi Kontainer.
Pilih Autentikasi dari menu navigasi.
Dari daftar Penyedia identitas, hapus idP yang terkait dengan sumber daya Static Web Apps.
Pilih Hapus autentikasi untuk menghapus autentikasi dan mengizinkan lalu lintas anonim ke sumber daya Container Apps Anda.
Sumber daya Container Apps Anda sekarang dapat menerima lalu lintas anonim.