共用方式為


在資料 API 產生器中使用組態檔環境

資料API產生器支援多個設定環境,類似於 ASP.NET Core的 appsettings.json。 您可以定義基本組態 (dab-config.json) 和環境特定的變體 (dab-config.Development.jsondab-config.Production.json)。 此功能可讓您跨環境靈活地管理連接字串、身份驗證設定和其他組態變更。

步驟 1:建立基本組態

建立 .env 檔案

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>;

備註

.env 檔案沒有檔案名稱,只有副檔名。

執行 dab init 來建立基本設定檔

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

此步驟會產生一個在所有環境中共用的基本檔案。

步驟 2:新增環境特定的組態檔

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

開發組態檔 (dab-config.Development.json

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

生產組態檔 (dab-config.Production.json

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

備註

當設定DAB_ENVIRONMENT時,環境特定檔案會覆蓋基本組態。

步驟 3:在正確的環境中啟動 DAB

使用此指令可將環境設定為 Development

DAB_ENVIRONMENT=Development dab start

使用此指令可將環境設定為 Production

DAB_ENVIRONMENT=Production dab start

備註

如果未設定任何環境,則預設環境為 Production

步驟 4:驗證設定

  • 休息: http://localhost:5000/api/Book
  • GraphQL:http://localhost:5000/graphql
  • Swagger: http://localhost:5000/swagger
  • 健康: http://localhost:5000/health

Review

  • 將檔案保留在 .env 版本控制之外 (.gitignore
  • 使用 @env()@akv() 用於秘密
  • 用於 DAB_ENVIRONMENT 輕鬆切換環境