Menggunakan lingkungan file konfigurasi di penyusun API Data

Penyusun API Data mendukung beberapa lingkungan konfigurasi, mirip dengan ASP.NET Core appsettings.json. Anda dapat menentukan konfigurasi dasar (dab-config.json) dan varian khusus lingkungan (dab-config.Development.json, dab-config.Production.json). Fitur ini memungkinkan manajemen fleksibel string koneksi, pengaturan autentikasi, dan perubahan konfigurasi lainnya di seluruh lingkungan.

Langkah 1: Membuat konfigurasi dasar

Membuat .env file

DEV_CONNECTION_STRING=Server=tcp:127.0.0.1,1433;User ID=<username>;Password=<password>;
PROD_CONNECTION_STRING=Server=tcp:127.0.0.1,1433;User ID=<username>;Password=<password>;

Nota

File .env tidak memiliki nama file, hanya ekstensi.

Jalankan dab init untuk membuat file konfigurasi dasar

dab init --database-type "mssql" --connection-string ""
dab add Book --source "dbo.Books" --permissions "anonymous:*"

Langkah ini menghasilkan file dasar dab-config.json yang dibagikan di semua lingkungan.

Langkah 2: Menambahkan file konfigurasi khusus lingkungan

- dab-config.json
- dab-config.Development.json
- dab-config.Production.json

File konfigurasi pengembangan (dab-config.Development.json)

{
  "data-source": {
    "connection-string": "@env('DEV_CONNECTION_STRING')"
  }
}

File konfigurasi produksi (dab-config.Production.json)

{
  "data-source": {
    "connection-string": "@env('PROD_CONNECTION_STRING')"
  }
}

Nota

File khusus lingkungan mengambil alih konfigurasi dasar saat DAB_ENVIRONMENT diatur.

Langkah 3: Mulai DAB dengan lingkungan yang benar

Gunakan perintah ini untuk mengatur lingkungan ke Development:

DAB_ENVIRONMENT=Development dab start

Gunakan perintah ini untuk mengatur lingkungan ke Production:

DAB_ENVIRONMENT=Production dab start

Nota

Jika tidak ada lingkungan yang diatur, lingkungan defaultnya adalah Production.

Langkah 4: Verifikasi penyiapan

  • REST: http://localhost:5000/api/Book
  • GraphQL: http://localhost:5000/graphql
  • Swagger: http://localhost:5000/swagger
  • Kesehatan: http://localhost:5000/health

Tinjauan

  • Jauhkan .env file dari kontrol versi (.gitignore)
  • Menggunakan @env() atau @akv() untuk rahasia
  • Gunakan DAB_ENVIRONMENT untuk beralih antar lingkungan dengan mudah
  • Last updated on