Condividi tramite

Distribuire Data API Builder su Azure Container Apps

Diagramma del percorso corrente ('Pubblica') nella sequenza della guida alla distribuzione.

Prerequisiti

Compilare il file di configurazione

Per iniziare, compilare un file di configurazione del generatore di API dati (DAB) per connettersi al database esistente. Questo file viene usato in un secondo momento con il contenitore finale.

  1. Creare una directory vuota nel computer locale per archiviare il file di configurazione.

  2. Inizializzare un nuovo file di configurazione di base usando dab init. Usare le impostazioni seguenti almeno all'inizializzazione.

    Impostazione Valore
    Tipo di database Selezionare un tipo di database supportato.
    Stringa di connessione Usare la @env() funzione per fare riferimento alla DATABASE_CONNECTION_STRING variabile di ambiente. 
    dab init --database-type "<database-type>" --connection-string "@env('DATABASE_CONNECTION_STRING')"

    Importante

    Alcuni tipi di database richiedono impostazioni di configurazione aggiuntive per l'inizializzazione.

  3. Aggiungere almeno un'entità di database alla configurazione. Usare il dab add comando per configurare un'entità. Configurare ogni entità per consentire tutte le autorizzazioni per gli utenti anonimi. Ripeti dab add quante volte vuoi per le entità.

    dab add "<entity-name>" --source "<schema>.<table>" --permissions "anonymous:*"

  4. Aprire ed esaminare il contenuto del file dab-config.json . Questo file verrà usato più avanti in questa guida.

Configurazione dell'host in Azure File

Caricare quindi il file di configurazione in una condivisione file creata in File di Azure. Questa condivisione file viene infine montata nel contenitore finale come volume.

  1. Accedere al portale di Azure (https://portal.azure.com).

  2. Creare un nuovo gruppo di risorse. Questo gruppo di risorse verrà usato per tutte le nuove risorse in questa guida.

    Screenshot della scheda

    Suggerimento

    È consigliabile denominare il gruppo di risorse msdocs-dab-aca. Tutti gli screenshot in questa guida usano questo nome.

  3. Creare un account di archiviazione di Azure. Usare queste impostazioni per configurare l'account.

    Impostazione Valore
    Gruppo di risorse Selezionare il gruppo di risorse creato in precedenza
    Nome dell'account di archiviazione Immettere un nome univoco globale
    Regione Selezionare un'area di Azure
    Prestazioni selezionare Standard
    Ridondanza Selezionare Archiviazione con ridondanza locale.
    Abilitare l'accesso alla chiave dell'account di archiviazione Seleziona Abilitato

    Screenshot della scheda 'Avanzate' della pagina 'Crea un account di archiviazione' nel portale di Azure.

  4. Passare al nuovo account di archiviazione nel portale di Azure.

  5. Selezionare Condivisioni file nella sezione Archiviazione dati del menu delle risorse. Selezionare quindi Condivisione file dalla barra dei comandi per creare una nuova condivisione nell'account di archiviazione. Usare le impostazioni seguenti per configurare la nuova condivisione file.

    Impostazione Valore
    Nome Immetti config
    Livello di accesso Selezionare In evidenza
    Abilitare il backup Non selezionare

    Screenshot delle opzioni del menu della risorsa **Condivisione file** e della barra dei comandi nel portale di Azure.

  6. Caricare il dab-config.json e tutti gli altri file necessari nella cartella condivisa. Usare l'opzione Carica nella barra dei comandi per aprire la finestra di dialogo Carica file . Selezionare entrambi i file e quindi carica.

    Screenshot della finestra di dialogo **Carica file** nel portale di Azure.

  7. Selezionare Chiavi di accesso nella sezione Sicurezza e rete del menu delle risorse. Registrare quindi il nome dell'account di archiviazione e i valori chiave di questa pagina. Questi valori verranno usati più avanti in questa guida.

    Screenshot della pagina

Creare l'app contenitore di base

Creare ora il contenitore in Azure usando App Azure Container. Questo contenitore ospita l'immagine del generatore di API dati senza una configurazione.

  1. Creare una risorsa di App Contenitore di Azure. Come parte del processo di creazione della risorsa dell'app, sarà necessario creare un ambiente. Usare queste impostazioni per configurare entrambe le risorse.

    Risorsa Impostazione Valore
    Ambiente nome dell'ambiente Immettere un nome univoco globale
    Ambiente Tipo di ambiente Selezionare Solo consumo
    Ambiente Destinazione dei log Selezionare Non salvare i log
    App Gruppo di risorse Selezionare il gruppo di risorse creato in precedenza
    App Nome dell'account di archiviazione Immettere un nome univoco globale
    App Regione Selezionare la stessa regione dell'account di archiviazione
    App Usare l'immagine di avvio rapido Non selezionare
    App Fonte dell'immagine Selezionare l'hub Docker o altri registri
    App Tipo di immagine Selezionare Pubblico
    App Server di accesso del registro Immetti mcr.microsoft.com
    App Immagine e tag Immetti azure-databases/data-api-builder:latest
    App Variabili di ambiente - Nome Immetti DATABASE_CONNECTION_STRING
    App Variabili di ambiente - Valore Immettere la stringa di connessione per il database.
    App Ingress Verificare che l'opzione Abilitato sia selezionata
    App Traffico in ingresso Selezionare Accettazione del traffico da qualsiasi posizione
    App Modalità certificato client Selezionare Ignora
    App Tipo di ingresso Selezionare HTTP
    App Porta di destinazione Immetti 5000

    Screenshot della scheda

    Screenshot della scheda

    Suggerimento

    È consigliabile usare una stringa di connessione che non include chiavi di autorizzazione. Usare invece identità gestite e controllo degli accessi in base al ruolo per gestire l'accesso tra il database e l'host. Per altre informazioni, vedere Servizi di Azure che usano identità gestite.

  2. Accedere alla nuova applicazione container nel portale di Azure.

  3. Usare il campo URL applicazione nella sezione Elementi essenziali per visitare il sito Web dell'app contenitore. Osservare la risposta che indica che il contenitore DAB è in esecuzione e che lo stato è integro.

    {
    "status": "healthy",
    "version": "1.1.7",
    "app-name": "dab_oss_1.1.7"
}

    Annotazioni

    Il numero di versione e il nome variano in base alla versione corrente di Generatore API dati. A questo punto, non è possibile passare ad alcun endpoint API. Questi endpoint saranno disponibili dopo il montaggio di un file di configurazione DAB.

Montare i file di configurazione

Infine, montare i file di configurazione dalla condivisione Azure Files nell'applicazione container. Questo passaggio consente al generatore di API dati di usare il file di configurazione per connettersi al database.

  1. Passare all'ambiente contenitore creato in precedenza in questa guida usando il portale di Azure.

  2. Selezionare File di Azure nella sezione Impostazioni del menu delle risorse. Selezionare quindi Aggiungi dalla barra dei comandi per aggiungere una condivisione file esistente all'ambiente contenitore. Usare le impostazioni seguenti per configurare la nuova condivisione file. Salvare quindi la nuova configurazione della condivisione file.

    Impostazione Valore
    Nome Immetti config-share
    Nome dell'account di archiviazione Nome dell'account di archiviazione registrato in precedenza in questa guida.
    Chiave dell'account di archiviazione Chiave dell'account di archiviazione registrato in precedenza in questa guida.
    Condivisione file Immetti config
    Modalità di accesso Selezionare Sola lettura

    Screenshot dell'opzione

  3. Accedere nuovamente all'app per contenitori nel portale di Azure.

  4. Selezionare Revisioni e repliche nella sezione Applicazione del menu delle risorse. Selezionare quindi Crea nuova revisione dalla barra dei comandi per avviare il processo di configurazione di una nuova revisione per l'app contenitore.

  5. Passare alla sezione Volumi e selezionare l'opzione Aggiungi. Usare le impostazioni seguenti per configurare il nuovo volume. Dopo aver configurato il volume, aggiungi il volume alla revisione del contenitore.

    Impostazione Valore
    Tipo di volume Selezionare il volume di file di Azure
    Nome Immetti config-volume
    Condivisione file Immetti config

    Screenshot della sezione

  6. Passare alla sezione Contenitore , selezionare il singolo contenitore corrente e quindi selezionare l'opzione Modifica . Usare le impostazioni seguenti per configurare due montaggi per il contenitore. Selezionare Salva per salvare le modifiche.

    Impostazione Valore
    Nome del volume Immetti config-volume
    Percorso di montaggio Immetti /App/dab-config.json
    Percorso secondario Immetti dab-config.json
    Impostazione Valore
    Nome del volume Immetti config-volume
    Percorso di montaggio Immetti /App/schema.graphql
    Percorso secondario Immetti schema.graphql

    Screenshot della sezione

  7. Selezionare Crea per creare una nuova revisione con i volumi di montaggio specificati. In attesa di completare la distribuzione della revisione.

  8. Usare il campo URL applicazione nella sezione Essentials per accedere nuovamente al sito Web dell'app contenitore. Osserva che la risposta continua a indicare che il contenitore DAB è integro.

  9. Passare al percorso /api/swagger dell'applicazione attualmente in esecuzione. Usare l'interfaccia utente di Swagger per inviare una richiesta HTTP GET per una delle entità.

Pulire le risorse

Quando l'applicazione o le risorse di esempio non sono più necessarie, rimuovere la distribuzione corrispondente e tutte le risorse.

  1. Passare al gruppo di risorse usando il portale di Azure.

  2. Nella barra dei comandi selezionare Elimina.

Passaggio successivo

Integrazione con Application Insights

  • Last updated on