Bagikan melalui


Mulai cepat: Menggunakan penyusun API Data dengan Azure SQL dan Azure Static Web 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 (Antarmuka Garis Perintah Pengembang Azure)
  • .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. 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
    
  6. Selama proses provisi, pilih langganan dan lokasi yang Anda inginkan. Tunggu hingga proses provisi selesai. Prosesnya dapat memakan waktu sekitar tujuh menit.

  7. 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.
    
  8. Catat nilai untuk URL API dan layanan web . Anda akan menggunakan nilai ini nanti dalam panduan ini.

Mengonfigurasi 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.1.7",
      "app-name": "dab_oss_1.1.7"
    }
    
  3. Ikuti 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.

    Cuplikan layar aplikasi web yang sedang berjalan di Azure Container Apps.

Bersihkan

Saat Anda tidak lagi memerlukan aplikasi sampel atau sumber daya, hapus penyebaran dan semua sumber daya yang sesuai.

  1. Hapus penyebaran dari langganan Azure Anda.

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

Langkah berikutnya

titik akhir REST