Host Data API Builder in App Web statiche di Azure (anteprima)

Diagramma della sequenza della guida alla distribuzione, inclusi questi percorsi, in ordine: Panoramica, Piano, Preparazione, Pubblicazione, Monitoraggio e Ottimizzazione. La posizione "Pubblica" è attualmente evidenziata.

Ospitare rapidamente il generatore di API dati in App Web statiche di Azure usando solo un file di configurazione. Questa guida include i passaggi per integrare Generatore API dati con un'app Web statica.

In questa guida vengono illustrati i passaggi per compilare un file di configurazione DAB, ospitare il file come parte dell'applicazione e quindi usare una connessione di database in App Web statiche di Azure.

Prerequisiti

Importante

Il supporto per Il generatore di API dati (DAB) in App Web statiche di Azure con connessioni di database è in anteprima. App Web statiche di Azure usa una versione fissa del motore DAB che può variare rispetto alla versione stabile più recente di DAB. Per accedere alle più recenti funzionalità di DAB, prendere in considerazione un host alternativo per DAB utilizzando la versione più recente del motore da GitHub, Microsoft Container Registry (Hub Docker) o NuGet.

• Un account Azure con una sottoscrizione attiva. Creare un account gratuito.
• CLI per applicazioni statiche di Azure. Installare la CLI (Command Line Interface) delle Static Web Apps (SWA).
• CLI generatore di API dati. Installare il CLI di Data API Builder (DAB).
• Database esistente indirizzabile da Azure.
• Applicazione Web esistente in un repository GitHub che può essere distribuito in App Web statiche di Azure.
  • Se non si ha un'applicazione Web, generare un repository con un'applicazione Web di base.

Creare un'app Web statica

Per iniziare, usare il portale di Azure per creare una nuova app Web statica di Azure usando l'applicazione Web in GitHub.

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.

   

   Suggerimento

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

3. Creare un'app Web statica di Azure. Usare queste impostazioni per configurare l'app Web statica.

   Impostazione	Valore
   Gruppo di risorse	Selezionare il gruppo di risorse creato in precedenza
   Nome	Immettere un nome univoco globale
   Tipo di piano	Selezionare l'opzione migliore per il carico di lavoro
   origine	Selezionare GitHub
   account GitHub	Configurare un account GitHub che abbia accesso al repository dell'applicazione Web
   Azienda	Selezionare l'organizzazione padre o l'utente per il repository
   Repository	Selezionare il nome del repository
   Ramo	Selezionare il ramo primario

   

4. Attendere il completamento della distribuzione dell'applicazione Web statica. Un flusso di lavoro di GitHub Actions viene aggiunto automaticamente al repository che distribuirà l'applicazione in App Web statiche di Azure ogni volta che si esegue il push nel ramo primario.

   Annotazioni

   Questa distribuzione iniziale può richiedere alcuni minuti. È sempre possibile controllare lo stato della distribuzione nel portale di Azure o nella scheda GitHub Actions nel repository.

5. Passare alla nuova app Web statica nel portale di Azure.

6. Nella sezione Informazioni di base usare il collegamento ipertestuale URL per passare all'applicazione Web in esecuzione. Verificare che l'applicazione sia in esecuzione come previsto.

Aggiungere il file di configurazione DAB

A questo punto, usare le interfacce della riga di comando DAB e SWA per creare un nuovo file di configurazione DAB e aggiungerlo al repository dell'applicazione Web.

1. Aprire il repository GitHub per l'applicazione Web nell'ambiente di sviluppo integrato (IDE) preferito.

   Suggerimento

   È possibile usare qualsiasi IDE desiderato. Se si vuole lavorare nell'applicazione in locale, è possibile clonare il repository nel computer locale. Se si preferisce lavorare nel browser, è possibile usare GitHub Codespaces. Assicurati che le interfacce CLI di SWA e DAB siano installate nell'ambiente di sviluppo.

2. Aprire un terminale nella radice del repository.

3. Usare il swa db comando dell'interfaccia della riga di comando di SWA per inizializzare un nuovo file di configurazione DAB usando il tipo di database specificato. Il comando creerà un nuovo file denominato staticwebapp.database.config.json nella cartella swa-db-connections .

   swa db init --database-type "<database-type>"
   

   Importante

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

4. Usare il dab add comando per aggiungere almeno un'entità di database alla configurazione. 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:*" --config "swa-db-connections/staticwebapp.database.config.json"
   

5. Aprire ed esaminare il contenuto del file swa-db-connections/staticwebapp.database.config.json.

6. Effettuare il commit delle modifiche nel repository e fare il push nel ramo primario. Verrà attivata automaticamente una nuova distribuzione dell'applicazione Web. Attendere il completamento dell'ultima distribuzione prima di procedere con la guida.

Configurare la connessione al database

Configurare quindi la connessione al database nel portale di Azure per consentire all'app Web statica di accedere al database.

1. Passare di nuovo all'app Web statica nel portale di Azure.

2. Selezionare l'opzione Connessione database nella sezione Impostazioni del menu delle risorse. Selezionare quindi Collega database esistente per l'ambiente di produzione.

   

3. Nella finestra di dialogo Collega database usare queste impostazioni per configurare la connessione al database.

   Impostazione	Valore
   Tipo di database	Selezionare lo stesso tipo di database usato durante la creazione del file di configurazione DAB
   Gruppo di risorse	Selezionare il gruppo di risorse creato in precedenza in questa guida
   Nome risorsa	Selezionare la risorsa di database da collegare all'app Web statica
   Nome del database	Immettere il nome del database
   Tipo di autenticazione	Selezionare il tipo di autenticazione che si intende usare

   

   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.

Testare l'endpoint dell'API dati

Verificare infine che l'endpoint dell'API dati sia disponibile nell'app Web statica.

1. Passare di nuovo all'app Web statica nel portale di Azure.

2. Usa il campo URL nella sezione Essenziali per accedere nuovamente al sito Web dell'app Web statica.

3. Passare al percorso /data-api dell'applicazione attualmente in esecuzione. Osserva che la risposta continua a indicare che il contenitore DAB è integro.

   { Healthy }
   

   Annotazioni

   Le App Web statiche impostano automaticamente la modalità host di runtime su Production, sovrascrivendo qualsiasi valore nel file di configurazione. Di conseguenza, le funzionalità per sviluppatori come Swagger e Banana Cake Pop non sono disponibili nelle app Web statiche.

4. Passare al percorso https://<your-static-web-app-url>/data-api/<your-rest-path>/<your-entity-name> dell'applicazione attualmente in esecuzione. In questo modo viene eseguita una richiesta HTTP GET per il set di entità. Osservare la risposta JSON.

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.