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

• Un account Azure con una sottoscrizione attiva. Creare un account gratuitamente.

• Interfaccia della riga di comando di App Web statiche di Azure. Installare l'interfaccia della riga di comando di App Web statiche (SWA).

• Interfaccia della riga di comando del generatore di API dati. Installare l'interfaccia della riga di comando di Generatore API dati (DAB).

• Database supportato esistente indirizzabile da Azure.

• Applicazione Web esistente in un repository GitHub che può essere distribuito in App Web statiche di Azure. - Se non si dispone di un'applicazione Web, generare un repository con un'applicazione Web di base.

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.

   

   Mancia

   È 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
   organizzazione	Selezionare l'organizzazione padre o l'utente per il repository
   repository	Selezionare il nome del repository
   Branch	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.

   Nota

   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 Essentials usare il collegamento ipertestuale URL per passare all'applicazione Web in esecuzione. Verificare che l'applicazione sia in esecuzione come previsto.

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.

   Mancia

   È 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. Assicurarsi 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 comando swa db dall'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 comando dab add per aggiungere almeno un'entità di database alla configurazione. Configurare ogni entità per consentire tutte le autorizzazioni per gli utenti anonimi. Ripetere dab add quante volte si desidera 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. Eseguire il commit delle modifiche nel repository ed eseguirne il push nel ramo primario. Verrà attivata automaticamente una nuova distribuzione dell'applicazione Web. Attendere il completamento di questa distribuzione più recente prima di continuare con questa guida.

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 di database esistenti per l'ambiente di di produzione .

   

3. Nella finestra di dialogo collegamento al 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 database	Immettere il nome del database
   tipo di autenticazione	Selezionare il tipo di autenticazione che si intende usare

   

   Mancia

   È 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.

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. Usare il campo URL nella sezione Essentials per passare di nuovo al sito Web dell'app Web statica.

3. Passare al percorso /data-api per l'applicazione in esecuzione corrente. Osservare che la risposta indica ancora che il contenitore DAB è integro.

   { Healthy }
   

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

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.