Bagikan melalui


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.

Untuk menautkan aplikasi kontainer sebagai backend API untuk aplikasi web statis, ikuti langkah-langkah berikut:

  1. Di portal Azure, buka aplikasi web statis.

  2. Pilih API dari menu navigasi.

  3. Temukan lingkungan yang ingin Anda tautkan instans API Management. Pilih Tautkan.

  4. Di Jenis sumber daya backend, pilih Aplikasi Kontainer.

  5. Di Langganan, pilih langganan yang berisi aplikasi kontainer yang ingin Anda tautkan.

  6. Di Nama sumber daya, pilih aplikasi kontainer.

  7. 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.

Untuk membatalkan tautan aplikasi kontainer dari aplikasi web statis, ikuti langkah-langkah berikut:

  1. Di portal Azure, buka aplikasi web statis.

  2. Pilih API dari menu navigasi.

  3. Temukan lingkungan yang ingin Anda batalkan tautannya dan pilih nama aplikasi kontainer.

  4. 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:

  1. Di portal Azure, navigasikan ke sumber daya Aplikasi Kontainer.

  2. Pilih Autentikasi dari menu navigasi.

  3. Dari daftar Penyedia identitas, hapus idP yang terkait dengan sumber daya Static Web Apps.

  4. 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.

Langkah berikutnya