Menyebarkan penyusun API Data ke Azure Container Instances

Diagram posisi saat ini ('Terbitkan') dalam urutan panduan penyebaran.

Sebarkan penyusun API Data dengan cepat ke Azure hanya menggunakan file konfigurasi dan tanpa kode kustom. Panduan ini mencakup langkah-langkah untuk menghosting gambar kontainer pembangun API Data dari Docker sebagai kontainer di Azure Container Instances.

Dalam panduan ini, telusuri langkah-langkah untuk membuat file konfigurasi penyusun API Data, menghosting file di Azure Files, lalu memasang file ke kontainer di Azure Container Instances.

Prasyarat

Sebuah akun Azure dengan langganan aktif. Buat akun secara gratis.
CLI penyusun API Data. PasangCLI .
Azure CLI. Instal 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.

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

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.

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:*"
```
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.

Masuk ke portal Microsoft Azure (https://portal.azure.com).
Buat grup sumber daya baru. Anda akan menggunakan grup sumber daya ini untuk semua sumber daya baru dalam panduan ini.

Petunjuk / Saran

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

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
Kinerja	Pilih Standar
Redundansi	Pilih penyimpanan redundan lokal (LRS)
Mengaktifkan akses kunci akun penyimpanan	Pilih Diaktifkan

Cuplikan layar tab 'Buat akun penyimpanan' halaman 'Tingkat Lanjut' di portal Microsoft Azure.

Navigasikan ke akun penyimpanan baru di portal Microsoft Azure.
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
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.
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.

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

Membuat instans kontainer dasar

Terakhir, buat kontainer di Azure menggunakan Azure Container Instances. Kontainer ini menghosting gambar penyusun API Data dengan file konfigurasi untuk menyambungkan ke database Anda.

Penting

Saat ini, satu-satunya cara untuk membuat instans kontainer dengan volume yang dipasang adalah dengan Azure CLI.

Buat sumber daya Azure Container Instances menggunakan az container create. Gunakan pengaturan ini untuk mengonfigurasi sumber daya.

Pengaturan	Nilai
grup Sumber Daya	Menggunakan grup sumber daya yang Anda buat sebelumnya
Nama kontainer	Masukkan nama yang unik secara global
Wilayah	Menggunakan wilayah yang sama dengan akun penyimpanan
SKU	Gunakan Standar
Jenis gambar	Gunakan Publik
Gambar	Masukkan `mcr.microsoft.com/azure-databases/data-api-builder:latest`
Jenis OS	Menggunakan Linux
Jenis jaringan	Gunakan Publik
Port jaringan	Masukkan `5000`
Label nama DNS	Masukkan label unik global
Variabel lingkungan	Masukkan `DATABASE_CONNECTION_STRING` dan string koneksi untuk database Anda.

az container create \
    --resource-group "<resource-group-name>" \
    --name "<unique-container-instance-name>" \
    --image "mcr.microsoft.com/azure-databases/data-api-builder:latest" \
    --location "<region>" \
    --sku "Standard" \
    --os-type "Linux" \
    --ip-address "public" \
    --ports "5000" \
    --dns-name-label "<unique-dns-label>" \
    --environment-variables "DATABASE_CONNECTION_STRING=<database-connection-string>" \
    --azure-file-volume-mount-path "/cfg" \
    --azure-file-volume-account-name "<storage-account-name>" \
    --azure-file-volume-account-key "<storage-account-key>" \
    --azure-file-volume-share-name "config" \
    --command-line "dotnet Azure.DataApiBuilder.Service.dll --ConfigFileName /cfg/dab-config.json"
    --

Petunjuk / Saran

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.

Gunakan az container show untuk mengkueri nama domain yang sepenuhnya memenuhi syarat (FQDN) untuk instans kontainer baru Anda. Kemudian, buka situs web instansia kontainer.

az container show \
    --resource-group "<resource-group-name>" \
    --name "<unique-container-instance-name>" \
    --query "join('://', ['https', ipAddress.fqdn])" \
    --output "tsv"

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.
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 penerapan dan semua sumber daya yang terkait.

Navigasikan ke grup sumber daya menggunakan portal Microsoft Azure.
Di bilah perintah , pilih Hapus.

Langkah selanjutnya

Terintegrasi dengan Application Insights

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2025-07-17