Menyebarkan penyusun API Data ke Azure Container Apps

Diagram urutan panduan penyebaran termasuk lokasi ini, secara berurutan: Gambaran Umum, Rencana, Siapkan, Terbitkan, Pantau, dan Pengoptimalan. Posisi 'Terbitkan' saat ini disorot.

Prasyarat

• Akun Azure dengan langganan aktif. Buat akun secara gratis.

• CLI penyusun API Data. PasangCLI .

• Azure CLI. Pasang Azure CLI.

• Database yang didukung dan sudah ada dapat diakses dari Azure.

Membangun file konfigurasi

Untuk memulai, buat file konfigurasi Penyusun API Data (DAB) untuk menyambungkan ke database Anda yang sudah ada. File ini digunakan nanti dengan kontainer akhir.

1. Buat direktori kosong di komputer lokal Anda untuk menyimpan file konfigurasi.

2. Inisialisasi file konfigurasi dasar baru menggunakan dab init. Gunakan pengaturan berikut minimal pada inisialisasi.

   Pengaturan	Nilai
   jenis database	Pilih jenis database yang didukung.
   string Koneksi	Gunakan fungsi @env() untuk mereferensikan variabel lingkungan DATABASE_CONNECTION_STRING.

   dab init --database-type "<database-type>" --connection-string "@env('DATABASE_CONNECTION_STRING')"
   

   Penting

   Beberapa jenis database akan memerlukan pengaturan konfigurasi tambahan pada inisialisasi.

3. Tambahkan setidaknya satu entitas database ke konfigurasi. Gunakan perintah dab add untuk mengonfigurasi entitas. Konfigurasikan setiap entitas untuk mengizinkan semua izin untuk pengguna anonim. Ulangi dab add sebanyak yang Anda suka untuk entitas Anda.

   dab add "<entity-name>" --source "<schema>.<table>" --permissions "anonymous:*"
   

4. Buka dan tinjau konten file dab-config.json. Anda akan menggunakan file ini nanti di panduan ini.

Konfigurasi host di Azure Files

Selanjutnya, unggah file konfigurasi ke berbagi file yang dibuat dalam Azure Files. Berbagi file ini akhirnya dipasang ke kontainer akhir sebagai volume.

1. Masuk ke portal Microsoft Azure (https://portal.azure.com).

2. Buat grup sumber daya baru. Anda akan menggunakan grup sumber daya ini untuk semua sumber daya baru dalam panduan ini.

   

   Tips

   Sebaiknya beri nama grup sumber daya msdocs-dab-aca. Semua cuplikan layar dalam panduan ini menggunakan nama ini.

3. Buat akun Azure Storage. Gunakan pengaturan ini untuk mengonfigurasi akun.

   Pengaturan	Nilai
   Grup Sumber Daya	Pilih grup sumber daya yang Anda buat sebelumnya
   Nama akun penyimpanan	Masukkan nama yang unik secara global
   Wilayah	Pilih wilayah Azure
   Performa	Pilih Standar
   Redundansi	Pilih penyimpanan redundan lokal (LRS)
   Mengaktifkan akses kunci akun penyimpanan	Pilih Diaktifkan

   

4. Navigasikan ke akun penyimpanan baru di portal Microsoft Azure.

5. Pilih berbagi file di bagian penyimpanan data menu sumber daya. Kemudian, pilih File Share dari bilah menu untuk membuat berbagi baru di akun penyimpanan. Gunakan pengaturan berikut untuk mengonfigurasi berbagi file baru.

   Pengaturan	Nilai
   Nama	Masukkan config
   tingkat akses	Pilih Hot
   Aktifkan pencadangan	Jangan pilih

   

6. Unggah dab-config.json dan file lain yang diperlukan ke lokasi berbagi. Gunakan opsi Unggah di bilah perintah untuk membuka dialog Unggah file. Pilih kedua file lalu pilih Unggah.

   

7. Pilih Kunci akses di bagian Keamanan + jaringan dari menu sumber daya. Kemudian, rekam nama akun Penyimpanan dan nilai Kunci dari halaman ini. Anda akan menggunakan nilai-nilai ini nanti dalam panduan ini.

   

Membuat aplikasi kontainer dasar

Sekarang, buat kontainer di Azure menggunakan Azure Container Apps. Kontainer ini menghosting gambar penyusun API Data tanpa konfigurasi.

1. Buat sumber daya Azure Container Apps. Sebagai bagian dari proses pembuatan sumber daya aplikasi, Anda akan diminta untuk membuat lingkungan. Gunakan pengaturan ini untuk mengonfigurasi kedua sumber daya.

   Sumber daya	Pengaturan	Nilai
   Lingkungan	Nama Lingkungan	Masukkan nama yang unik secara global
   Lingkungan	jenis lingkungan	Pilih konsumsi saja
   Lingkungan	tujuan Log	Pilih Jangan simpan log
   Aplikasi	Grup Sumber Daya	Pilih grup sumber daya yang Anda buat sebelumnya
   Aplikasi	Nama akun penyimpanan	Masukkan nama yang unik secara global
   Aplikasi	Wilayah	Pilih wilayah yang sama dengan akun penyimpanan
   Aplikasi	Gunakan gambar startup cepat	Jangan pilih
   Aplikasi	Sumber gambar	Pilih Docker Hub atau registri lainnya
   Aplikasi	Jenis gambar	Pilih Publik
   Aplikasi	server masuk Registri	Masukkan mcr.microsoft.com
   Aplikasi	Gambar dan tag	Masukkan azure-databases/data-api-builder:latest
   Aplikasi	variabel lingkungan - Nama	Masukkan DATABASE_CONNECTION_STRING
   Aplikasi	variabel lingkungan - Nilai	Masukkan string koneksi untuk database Anda.
   Aplikasi	Masuk	Pastikan Diaktifkan dipilih
   Aplikasi	lalu lintas yang masuk	Pilih Menerima lalu lintas dari mana saja
   Aplikasi	mode untuk sertifikat klien	Pilih Abaikan
   Aplikasi	jenis Ingress	Pilih HTTP
   Aplikasi	port target	Masukkan 5000

   

   

   Tips

   Sebaiknya gunakan string koneksi yang tidak menyertakan kunci otorisasi. Sebagai gantinya, gunakan identitas terkelola dan kontrol akses berbasis peran untuk mengelola akses antara database dan host Anda. Untuk informasi selengkapnya, lihat Layanan Azure menggunakan identitas terkelola.

2. Navigasi ke aplikasi kontainer baru di portal Microsoft Azure.

3. Gunakan bidang URL Aplikasi di bagian Essentials untuk menelusuri situs web aplikasi kontainer. Perhatikan respons yang menunjukkan bahwa kontainer DAB beroperasi dan statusnya sehat.

   {
       "status": "healthy",
       "version": "1.1.7",
       "app-name": "dab_oss_1.1.7"
   }
   

   Nota

   Nomor dan nama versi akan bervariasi berdasarkan versi penyusun Data API Anda saat ini. Pada titik ini, Anda tidak dapat menavigasi ke titik akhir API apa pun. Titik akhir ini akan tersedia setelah Anda memasang file konfigurasi DAB.

Memasang file konfigurasi

Terakhir, pasang file konfigurasi dari berbagi Azure Files ke aplikasi kontainer. Langkah ini memungkinkan penyusun Api Data menggunakan file konfigurasi untuk menyambungkan ke database Anda.

1. Navigasikan ke lingkungan kontainer yang dibuat sebelumnya dalam panduan ini menggunakan portal Microsoft Azure.

2. Pilih file Azure di bagian Pengaturan dari menu sumber daya. Kemudian, pilih Tambahkan dari bilah perintah untuk menambahkan berbagi file yang ada ke lingkungan kontainer. Gunakan pengaturan berikut untuk mengonfigurasi berbagi file baru. Kemudian menyimpan konfigurasi berbagi file baru.

   Pengaturan	Nilai
   Nama	Masukkan config-share
   Nama akun penyimpanan	Nama akun penyimpanan yang direkam sebelumnya dalam panduan ini.
   kunci akun Penyimpanan	Kunci akun penyimpanan yang direkam sebelumnya dalam panduan ini.
   berbagi file	Masukkan config
   Mode Akses	Pilih Baca saja

   

3. Navigasikan ke aplikasi kontainer lagi di portal Microsoft Azure.

4. Pilih Revisi dan replika di bagian Aplikasi di menu sumber daya. Kemudian, pilih Buat revisi baru dari bilah perintah untuk memulai proses konfigurasi revisi baru untuk aplikasi kontainer Anda.

5. Navigasi ke bagian Volume dan pilih opsi Tambahkan. Gunakan pengaturan berikut untuk mengonfigurasi volume baru. Setelah mengonfigurasi volume, tambahkan volume ke revisi kontainer.

   Pengaturan	Nilai
   jenis Volume	Pilih volume file Azure
   Nama	Masukkan config-volume
   berbagi file	Masukkan config

   

6. Navigasi ke bagian Kontainer, pilih satu kontainer saat ini, lalu pilih opsi Edit. Gunakan pengaturan berikut untuk mengonfigurasi dua mount untuk kontainer. Simpan perubahan Anda.

   Pengaturan	Nilai
   Nama volume	Masukkan config-volume
   jalur pemasangan	Masukkan /App/dab-config.json
   sub jalur	Masukkan dab-config.json

   Pengaturan	Nilai
   Nama volume	Masukkan config-volume
   jalur pemasangan	Masukkan /App/schema.graphql
   sub jalur	Masukkan schema.graphql

   

7. Pilih Buat untuk membuat revisi baru dengan pemasangan volume yang Anda tentukan. Sambil menunggu revisi selesai diterapkan.

8. Gunakan bidang URL Aplikasi di bagian Essentials untuk menelusuri situs web aplikasi kontainer lagi. Perhatikan bahwa respons masih menunjukkan bahwa kontainer DAB sehat.

9. Navigasi ke jalur /api/swagger untuk aplikasi yang sedang berjalan saat ini. Gunakan antarmuka pengguna Swagger untuk mengeluarkan permintaan HTTP GET untuk salah satu entitas Anda.

Membersihkan sumber daya

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

1. Navigasikan ke grup sumber daya menggunakan portal Microsoft Azure.

2. Di bilah perintah , pilih Hapus.

Langkah berikutnya

Terintegrasi dengan Application Insights