Konfigurációs fájlkörnyezetek használata a Data API Builderben

A Data API Builder több konfigurációs környezetet is támogat, hasonlóan ASP.NET Core-hoz appsettings.json. Definiálhat alapkonfigurációt (dab-config.json) és környezetspecifikus változatokat (dab-config.Development.json, dab-config.Production.json). Ez a funkció lehetővé teszi a kapcsolati sztringek, a hitelesítési beállítások és más konfigurációs módosítások rugalmas kezelését a különböző környezetekben.

1. lépés: Alapkonfiguráció létrehozása

.env Fájl létrehozása

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

Megjegyzés:

A .env fájlnak nincs fájlneve, csak bővítménye.

Futtatás dab init az alapkonfigurációs fájl létrehozásához

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

Ez a lépés létrehoz egy alapszintű dab-config.json fájlt, amely minden környezetben meg van osztva.

2. lépés: Környezetspecifikus konfigurációs fájlok hozzáadása

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

Fejlesztési konfigurációs fájl (dab-config.Development.json)

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

Gyártási konfigurációs fájl (dab-config.Production.json)

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

Megjegyzés:

A környezetspecifikus fájlok felülbírálják az alapkonfigurációt, ha a DAB_ENVIRONMENT be van állítva.

3. lépés: A DAB indítása a megfelelő környezettel

Ezzel a paranccsal állítsa a környezetet a következőre Development:

DAB_ENVIRONMENT=Development dab start

Ezzel a paranccsal állítsa a környezetet a következőre Production:

DAB_ENVIRONMENT=Production dab start

Megjegyzés:

Ha nincs beállítva környezet, az alapértelmezett környezet a .Production

4. lépés: A beállítás ellenőrzése

  • REST: http://localhost:5000/api/Book
  • GraphQL: http://localhost:5000/graphql
  • Swagger: http://localhost:5000/swagger
  • Egészség: http://localhost:5000/health

Felülvizsgálat

  • Fájlok verziókövetésének megtartása .env (.gitignore)
  • @env() vagy @akv() használata titkokhoz
  • A környezetek közötti egyszerű váltáshoz használható DAB_ENVIRONMENT