Distribuire Azure Cosmos DB e app Web del servizio app di Azure tramite un modello di Azure Resource Manager

Questa esercitazione illustra come usare un modello di Azure Resource Manager per distribuire e integrare Microsoft Azure Cosmos DB, un'app Web del servizio app di Azure e un'applicazione Web di esempio.

Con il modello di Azure Resource Manager è possibile automatizzare facilmente la distribuzione e la configurazione delle risorse di Azure. Questa esercitazione illustra come distribuire un'applicazione Web e configurare automaticamente le informazioni relative alla connessione dell'account Azure Cosmos DB.

Dopo aver completato questa esercitazione, si potrà rispondere alle domande seguenti:

  • Come è possibile usare un modello di Azure Resource Manager per distribuire e integrare un account Azure Cosmos DB e un'app Web nel servizio app di Azure?
  • Come si usa un modello di Azure Resource Manager per distribuire e integrare un account Azure Cosmos DB, un'app Web del servizio app e un'applicazione WebDeploy?

Prerequisiti

Suggerimento

Sebbene questa esercitazione non presupponga alcuna esperienza nell'uso dei modelli o JSON di Azure Resource Manager, se si desidera modificare i modelli o le opzioni di distribuzione cui viene fatto riferimento, è necessario conoscere ciascuna di tali aree.

Prima di seguire le istruzioni di questa esercitazione, verificare che siano disponibili gli elementi seguenti:

Passaggio 1: Scaricare i file del modello

Per iniziare, scaricare i file del modello da usare in questa esercitazione.

  1. Scaricare il modello di esempio per creare un account Azure Cosmos DB, app Web e per distribuire un'applicazione demo in una cartella locale, ad esempio C:\Azure Cosmos DBTemplates. Questo modello distribuirà un account Azure Cosmos DB, un'app Web del servizio app e un'applicazione Web. L'applicazione Web verrà anche configurata automaticamente per connettersi all'account Azure Cosmos DB.
  2. Scaricare il modello di esempio per creare un account Azure Cosmos DB e app Web in una cartella locale, ad esempio C:\Azure Cosmos DBTemplates. Questo modello distribuirà un account Azure Cosmos DB, un'app Web del servizio app e modificherà le impostazioni dell'applicazione del sito per rilevare in modo semplice le informazioni relative alla connessione di Azure Cosmos DB. Non è tuttavia inclusa alcuna applicazione Web.

Passaggio 2: Distribuire l'account Azure Cosmos DB, l'app Web del servizio app e l'applicazione demo di esempio

Si procederà a questo punto alla distribuzione del primo modello.

Suggerimento

Il modello non verifica che il nome dell'app Web e il nome dell'account Azure Cosmos DB siano validi e disponibili. È consigliabile verificare la disponibilità dei nomi che si intende fornire prima della distribuzione.

  1. Accedere al portale di Azure, fare clic su Nuovo e ricercare "Distribuzione modello". Screenshot dell'interfaccia utente della distribuzione del modello
  2. Selezionare la voce Distribuzione modello e fare clic su Crea Screenshot dell'interfaccia utente della distribuzione del modello.
  3. Fare clic su Modifica modello, incollare il contenuto del file del modello DocDBWebsiteTodo.json e fare clic su Salva. Screenshot dell'interfaccia utente della distribuzione del modello
  4. Fare clic su Modifica parametri, specificare i valori per ogni parametro obbligatorio e fare clic su OK. I parametri sono i seguenti:

    1. SITENAME: specifica il nome dell'app Web del servizio app e viene usato per creare l'URL che consentirà di accedere all'app Web. Ad esempio, se si specifica "mydemodocdbwebapp", l'URL usato per accedere all'app Web sarà mydemodocdbwebapp.azurewebsites.net.
    2. HOSTINGPLANNAME: specifica il nome del piano di hosting del servizio app da creare.
    3. LOCATION: specifica la posizione di Azure in cui creare le risorse di Azure Cosmos DB e dell'app Web.
    4. DATABASEACCOUNTNAME: specifica il nome dell'account Azure Cosmos DB da creare.

      Screenshot dell'interfaccia utente della distribuzione del modello

  5. Scegliere un gruppo di risorse esistente o fornire un nome per creare un nuovo gruppo di risorse, quindi selezionare la relativa posizione.

    Screenshot dell'interfaccia utente della distribuzione del modello

  6. Fare clic su Rivedere le note legali, Acquista, quindi su Crea per iniziare la distribuzione. Selezionare Aggiungi al dashboard per rendere facilmente visibile la distribuzione ottenuta nella home page del portale di Azure. Screenshot dell'interfaccia utente della distribuzione del modello
  7. Al termine della distribuzione, verrà aperto il pannello del gruppo di risorse. Screenshot del pannello del gruppo di risorse
  8. Per usare l'applicazione, passare semplicemente all'URL dell'App Web, nell'esempio precedente l'URL sarà http://mydemodocdbwebapp.azurewebsites.net. Verrà visualizzata l'applicazione Web seguente:

    Applicazione di esempio

  9. Proseguire e creare un paio di attività nell'app Web, quindi tornare al pannello del gruppo di risorse nel portale di Azure. Fare clic sulla risorsa dell'account Azure Cosmos DB nell'elenco delle risorse, quindi su Esplora query. Screenshot della sezione di riepilogo in cui è evidenziata l'app Web
  10. Eseguire la query predefinita "SELECT * FROM c" ed esaminarne i risultati. Si noti che la query ha recuperato la rappresentazione JSON delle attività create nel passaggio 7 precedente. È possibile sperimentare con le query. Provare ad esempio a eseguire SELECT * FROM c WHERE c.isComplete = true per restituire tutti gli elementi todo che sono stati contrassegnati come completati.

    Schermata dei pannelli Esplora query e Risultati con i risultati delle query

  11. È possibile verificare la funzionalità del portale di Azure Cosmos DB o modificare l'applicazione Todo di esempio. A questo punto si è pronti per distribuire un altro modello.

Passaggio 3: Distribuire l'esempio relativo ad account DocumentDB e app Web

Si procederà ora alla distribuzione del secondo modello. Questo modello è utile per mostrare come inserire le informazioni relative alla connessione di Azure Cosmos DB, ad esempio l'endpoint dell'account e la chiave master in un'app Web come impostazioni dell'applicazione o come stringa di connessione personalizzata. Si supponga ad esempio di avere un'applicazione Web che si intende distribuire con un account Azure Cosmos DB e con informazioni relative alla connessione popolate automaticamente durante la distribuzione.

Suggerimento

Il modello non verifica che il nome dell'app Web e il nome dell'account Azure Cosmos DB siano validi e disponibili. È consigliabile verificare la disponibilità dei nomi che si intende fornire prima della distribuzione.

  1. Nel portale di Azure, fare clic su Nuovo e ricercare "Distribuzione modello". Screenshot dell'interfaccia utente della distribuzione del modello
  2. Selezionare la voce Distribuzione modello e fare clic su Crea Screenshot dell'interfaccia utente della distribuzione del modello.
  3. Fare clic su Modifica modello, incollare il contenuto del file del modello DocDBWebSite.json e fare clic su Salva. Screenshot dell'interfaccia utente della distribuzione del modello
  4. Fare clic su Modifica parametri, specificare i valori per ogni parametro obbligatorio e fare clic su OK. I parametri sono i seguenti:

    1. SITENAME: specifica il nome dell'app Web del servizio app e viene usato per creare l'URL che consentirà di accedere all'app Web. Ad esempio, se si specifica "mydemodocdbwebapp", l'URL usato per accedere all'app Web sarà mydemodocdbwebapp.azurewebsites.net.
    2. HOSTINGPLANNAME: specifica il nome del piano di hosting del servizio app da creare.
    3. LOCATION: specifica la posizione di Azure in cui creare le risorse di Azure Cosmos DB e dell'app Web.
    4. DATABASEACCOUNTNAME: specifica il nome dell'account Azure Cosmos DB da creare.

      Screenshot dell'interfaccia utente della distribuzione del modello

  5. Scegliere un gruppo di risorse esistente o fornire un nome per creare un nuovo gruppo di risorse, quindi selezionare la relativa posizione.

    Screenshot dell'interfaccia utente della distribuzione del modello

  6. Fare clic su Rivedere le note legali, Acquista, quindi su Crea per iniziare la distribuzione. Selezionare Aggiungi al dashboard per rendere facilmente visibile la distribuzione ottenuta nella home page del portale di Azure. Screenshot dell'interfaccia utente della distribuzione del modello
  7. Al termine della distribuzione, verrà aperto il pannello del gruppo di risorse. Screenshot del pannello del gruppo di risorse
  8. Fare clic sulla risorsa dell'App Web nell'elenco delle risorse, quindi fare clic su Impostazioni applicazione Screenshot del gruppo di risorse.
  9. Si noti la presenza di impostazioni dell'applicazione per l'endpoint di Azure Cosmos DB e per ognuna delle relative chiavi master.

    Screenshot delle impostazioni dell'applicazione

  10. È possibile continuare a esplorare il portale di Azure o seguire uno degli esempi di Azure Cosmos DB per creare la propria applicazione Azure Cosmos DB.

Passaggi successivi

Congratulazioni. È stata completata la distribuzione di Azure Cosmos DB, di un'app Web del servizio app e di un'applicazione Web di esempio usando i modelli di Azure Resource Manager.

  • Per altre informazioni su Azure Cosmos DB, fare clic qui.
  • Per altre informazioni sulle app Web del servizio app di Azure, vedere qui.
  • Per altre informazioni sui modelli di Gestione risorse di Azure, vedere qui.

Modifiche apportate

Nota

Per iniziare a usare Servizio app di Azure prima di registrarsi per ottenere un account Azure, andare a Prova il servizio app, dove è possibile creare un'app Web iniziale temporanea nel servizio app. Non è necessario fornire una carta di credito né impegnarsi in alcun modo.