Condividi tramite


Utilizzare gli ambienti dei file di configurazione nel Data API Builder

Generatore API dati supporta più ambienti di configurazione, simili a ASP.NET Core.appsettings.json È possibile definire una configurazione di base (dab-config.json) e varianti specifiche dell'ambiente (dab-config.Development.json, dab-config.Production.json). Questa funzionalità consente la gestione flessibile delle stringhe di connessione, delle impostazioni di autenticazione e di altre modifiche di configurazione negli ambienti.

Passaggio 1: Creare una configurazione di base

Creare un file .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>;

Annotazioni

Il .env file non ha un nome file, ma solo un'estensione.

Eseguire dab init per creare il file di configurazione di base

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

Questo passaggio genera un file di base dab-config.json condiviso in tutti gli ambienti.

Passaggio 2: Aggiungere file di configurazione specifici dell'ambiente

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

File di configurazione dello sviluppo (dab-config.Development.json)

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

File di configurazione di produzione (dab-config.Production.json)

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

Annotazioni

I file specifici dell'ambiente sovrascrivono la configurazione di base quando DAB_ENVIRONMENT è configurato.

Passaggio 3: Avviare DAB con l'ambiente corretto

Usare questo comando per impostare l'ambiente su Development:

DAB_ENVIRONMENT=Development dab start

Usare questo comando per impostare l'ambiente su Production:

DAB_ENVIRONMENT=Production dab start

Annotazioni

Se non è impostato alcun ambiente, l'ambiente predefinito è Production.

Passaggio 4: Verificare la configurazione

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

Review

  • Mantenere i .env file fuori dal controllo della versione (.gitignore)
  • Usare @env() o @akv() per i segreti
  • Usare DAB_ENVIRONMENT per passare facilmente da un ambiente all'altro