Mulai cepat: Menggunakan penyusun API Data dengan Azure SQL dan Azure Container Apps

Dalam panduan cepat ini, Anda meng-deploy Penyusun API Data (DAB) sebagai kontainer Docker ke Azure Container Apps. Anda menggunakan templat Azure Developer CLI (AZD) untuk menyebarkan DAB bersama dengan database Azure SQL menggunakan praktik terbaik terbaru. Templat ini juga menyebarkan contoh aplikasi web yang terhubung ke titik akhir DAB menggunakan GraphQL.

Prasyarat

• Azure Developer CLI
• .NET 9.0

Jika Anda tidak memiliki akun Azure, buat akun gratis sebelum memulai.

Menginisialisasi proyek

Gunakan Azure Developer CLI (azd) untuk membuat akun Azure SQL, menyebarkan DAB sebagai solusi kontainer, dan menyebarkan aplikasi sampel dalam kontainer. Aplikasi sampel menggunakan DAB untuk mengkueri data sampel.

1. Buka terminal di direktori kosong.

2. Jika Anda belum diautentikasi, autentikasi ke Azure Developer CLI menggunakan azd auth login. Ikuti langkah-langkah yang ditentukan oleh alat untuk mengautentikasi ke CLI menggunakan kredensial Azure pilihan Anda.

   azd auth login
   

3. Gunakan azd init untuk menginisialisasi proyek.

   azd init --template dab-azure-sql-quickstart
   

4. Selama inisialisasi, konfigurasikan nama lingkungan yang unik.

5. Pastikan Docker berjalan di komputer Anda sebelum melanjutkan ke langkah berikutnya.

6. Sebarkan solusi lengkap ke Azure menggunakan azd up. Templat Bicep menyebarkan akun Azure SQL DAB ke Azure Container Apps, dan aplikasi web sampel.

   azd up
   

7. Selama proses provisi, pilih langganan dan lokasi yang Anda inginkan. Tunggu hingga proses provisi selesai. Prosesnya dapat memakan waktu sekitar tujuh menit.

8. Setelah provisi sumber daya Azure Anda selesai, URL ke aplikasi web yang sedang berjalan disertakan dalam output.

   Deploying services (azd deploy)
   
   (✓) Done: Deploying service api
   - Endpoint: <https://[container-app-sub-domain].azurecontainerapps.io>
   
   (✓) Done: Deploying service web
   - Endpoint: <https://[container-app-sub-domain].azurecontainerapps.io>
   
   SUCCESS: Your up workflow to provision and deploy to Azure completed in 7 minutes 0 seconds.
   

9. Catat nilai untuk URL API dan layanan web . Anda akan menggunakan nilai-nilai ini dalam panduan ini nanti.

Konfigurasikan koneksi database

Sekarang, telusuri ke setiap aplikasi kontainer di Azure Container Apps untuk memvalidasi bahwa aplikasi berfungsi seperti yang diharapkan.

1. Pertama, buka URL untuk layanan API . URL ini menautkan ke instans DAB yang sedang berjalan.

2. Amati output JSON dari DAB. Ini harus menunjukkan bahwa kontainer DAB berjalan dan statusnya sehat.

   {
     "status": "healthy",
     "version": "1.4.35",
     "app-name": "dab_oss_1.4.35"
   }
   

3. Arahkan ke jalur relatif /swagger untuk instans DAB. URL ini harus membuka Swagger UI REST integrated development environment (IDE).

4. Di IDE Swagger, jalankan permintaan GET untuk semua baris dalam tabel Azure SQL products.

5. Terakhir, buka URL untuk layanan web . URL ini menautkan ke contoh aplikasi web yang sedang berjalan yang tersambung ke titik akhir GraphQL yang Anda akses di langkah sebelumnya.

6. Amati aplikasi web yang sedang berjalan dan tinjau data output.

   

Pembersihan

Saat Anda tidak lagi memerlukan aplikasi contoh atau sumber daya, hapus penerapan dan semua sumber daya yang terkait.

1. Hapus penyebaran dari langganan Azure Anda.

   azd down
   

2. Hapus codespace yang sedang berjalan untuk memaksimalkan penyimpanan dan kapasitas inti Anda jika Anda menggunakan GitHub Codespaces.

Langkah selanjutnya

titik akhir REST