Udostępnij przez


Korzystanie ze środowisk plików konfiguracji w narzędziu Data API Builder

Konstruktor interfejsu API danych obsługuje wiele środowisk konfiguracji, podobnie jak ASP.NET Core.appsettings.json Można zdefiniować podstawową konfigurację (dab-config.json) i warianty specyficzne dla środowiska (dab-config.Development.json, dab-config.Production.json). Ta funkcja umożliwia elastyczne zarządzanie parametrami połączenia, ustawieniami uwierzytelniania i innymi zmianami konfiguracji w środowiskach.

Krok 1. Tworzenie podstawowej konfiguracji

Tworzenie .env pliku

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

Uwaga / Notatka

Plik .env nie ma nazwy pliku, tylko rozszerzenie.

Uruchom polecenie dab init , aby utworzyć podstawowy plik konfiguracji

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

Ten krok tworzy podstawowy dab-config.json plik, który jest współużytkowany we wszystkich środowiskach.

Krok 2. Dodawanie plików konfiguracji specyficznych dla środowiska

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

Plik konfiguracji programowania (dab-config.Development.json)

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

Plik konfiguracji produkcyjnej (dab-config.Production.json)

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

Uwaga / Notatka

Pliki specyficzne dla środowiska zastępują podstawową konfigurację, gdy DAB_ENVIRONMENT jest ustawione.

Krok 3. Uruchamianie języka DAB przy użyciu poprawnego środowiska

Użyj tego polecenia, aby ustawić środowisko na :Development

DAB_ENVIRONMENT=Development dab start

Użyj tego polecenia, aby ustawić środowisko na :Production

DAB_ENVIRONMENT=Production dab start

Uwaga / Notatka

Jeśli środowisko nie jest ustawione, domyślne środowisko to Production.

Krok 4. Weryfikowanie konfiguracji

  • ODPOCZYNEK: http://localhost:5000/api/Book
  • GraphQL: http://localhost:5000/graphql
  • Swagger: http://localhost:5000/swagger
  • Zdrowie: http://localhost:5000/health

Wykonaj przegląd

  • Przechowywanie .env plików poza kontrolą wersji (.gitignore)
  • Użyj @env() lub @akv() dla tajemnic
  • Użyj DAB_ENVIRONMENT, aby łatwo przełączać się między środowiskami