Distribuire Azure Cosmos DB e app Web del servizio app di Azure tramite un modello di Azure Resource ManagerDeploy Azure Cosmos DB and Azure App Service Web Apps using an Azure Resource Manager Template

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.This tutorial shows you how to use an Azure Resource Manager template to deploy and integrate Microsoft Azure Cosmos DB, an Azure App Service web app, and a sample web application.

Con il modello di Azure Resource Manager è possibile automatizzare facilmente la distribuzione e la configurazione delle risorse di Azure.Using Azure Resource Manager templates, you can easily automate the deployment and configuration of your Azure resources. Questa esercitazione illustra come distribuire un'applicazione Web e configurare automaticamente le informazioni relative alla connessione dell'account Azure Cosmos DB.This tutorial shows how to deploy a web application and automatically configure Azure Cosmos DB account connection information.

Dopo aver completato questa esercitazione, si potrà rispondere alle domande seguenti:After completing this tutorial, you will be able to answer the following questions:

  • 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?How can I use an Azure Resource Manager template to deploy and integrate an Azure Cosmos DB account and a web app in Azure App Service?
  • 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?How can I use an Azure Resource Manager template to deploy and integrate an Azure Cosmos DB account, a web app in App Service Web Apps, and a Webdeploy application?

PrerequisitiPrerequisites

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.While this tutorial does not assume prior experience with Azure Resource Manager templates or JSON, should you wish to modify the referenced templates or deployment options, then knowledge of each of these areas will be required.

Prima di seguire le istruzioni di questa esercitazione, verificare che siano disponibili gli elementi seguenti:Before following the instructions in this tutorial, ensure that you have the following:

Passaggio 1: Scaricare i file del modelloStep 1: Download the template files

Per iniziare, scaricare i file del modello da usare in questa esercitazione.Let's start by downloading the template files we will use in this tutorial.

  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.Download the Create an Azure Cosmos DB account, Web Apps, and deploy a demo application sample template to a local folder (e.g. C:\Azure Cosmos DBTemplates). Questo modello distribuirà un account Azure Cosmos DB, un'app Web del servizio app e un'applicazione Web.This template will deploy an Azure Cosmos DB account, an App Service web app, and a web application. L'applicazione Web verrà anche configurata automaticamente per connettersi all'account Azure Cosmos DB.It will also automatically configure the web application to connect to the Azure Cosmos DB account.
  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.Download the Create an Azure Cosmos DB account and Web Apps sample template to a local folder (e.g. 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.This template will deploy an Azure Cosmos DB account, an App Service web app, and will modify the site's application settings to easily surface Azure Cosmos DB connection information, but does not include a web application.

Passaggio 2: Distribuire l'account Azure Cosmos DB, l'app Web del servizio app e l'applicazione demo di esempioStep 2: Deploy the Azure Cosmos DB account, App Service web app and demo application sample

Si procederà a questo punto alla distribuzione del primo modello.Now let's deploy our first template.

Suggerimento

Il modello non verifica che il nome dell'app Web e il nome dell'account Azure Cosmos DB siano validi e disponibili.The template does not validate that the web app name and Azure Cosmos DB account name entered below are a) valid and b) available. È consigliabile verificare la disponibilità dei nomi che si intende fornire prima della distribuzione.It is highly recommended that you verify the availability of the names you plan to supply prior to submitting the deployment.

  1. Accedere al portale di Azure, fare clic su Nuovo e ricercare "Distribuzione modello".Login to the Azure Portal, click New and search for "Template deployment". Screenshot dell'interfaccia utente della distribuzione del modelloScreenshot of the template deployment UI
  2. Selezionare la voce Distribuzione modello e fare clic su Crea Screenshot dell'interfaccia utente della distribuzione del modello.Select the Template deployment item and click Create Screenshot of the template deployment UI
  3. Fare clic su Modifica modello, incollare il contenuto del file del modello DocDBWebsiteTodo.json e fare clic su Salva.Click Edit template, paste the contents of the DocDBWebsiteTodo.json template file, and click Save. Screenshot dell'interfaccia utente della distribuzione del modelloScreenshot of the template deployment UI
  4. Fare clic su Modifica parametri, specificare i valori per ogni parametro obbligatorio e fare clic su OK.Click Edit parameters, provide values for each of the mandatory parameters, and click OK. I parametri sono i seguenti:The parameters are as follows:

    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.SITENAME: Specifies the App Service web app name and is used to construct the URL that you will use to access the web app (e.g. if you specify "mydemodocdbwebapp", then the URL by which you will access the web app will be mydemodocdbwebapp.azurewebsites.net).
    2. HOSTINGPLANNAME: specifica il nome del piano di hosting del servizio app da creare.HOSTINGPLANNAME: Specifies the name of App Service hosting plan to create.
    3. LOCATION: specifica la posizione di Azure in cui creare le risorse di Azure Cosmos DB e dell'app Web.LOCATION: Specifies the Azure location in which to create the Azure Cosmos DB and web app resources.
    4. DATABASEACCOUNTNAME: specifica il nome dell'account Azure Cosmos DB da creare.DATABASEACCOUNTNAME: Specifies the name of the Azure Cosmos DB account to create.

      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.Choose an existing Resource group or provide a name to make a new resource group, and choose a location for the resource group.

    Screenshot dell'interfaccia utente della distribuzione del modello

  6. Fare clic su Rivedere le note legali, Acquista, quindi su Crea per iniziare la distribuzione.Click Review legal terms, Purchase, and then click Create to begin the deployment. Selezionare Aggiungi al dashboard per rendere facilmente visibile la distribuzione ottenuta nella home page del portale di Azure.Select Pin to dashboard so the resulting deployment is easily visible on your Azure portal home page. Screenshot dell'interfaccia utente della distribuzione del modelloScreenshot of the template deployment UI
  7. Al termine della distribuzione, verrà aperto il pannello del gruppo di risorse.When the deployment finishes, the Resource group blade will open. Screenshot del pannello del gruppo di risorseScreenshot of the resource group blade
  8. Per usare l'applicazione, passare semplicemente all'URL dell'App Web, nell'esempio precedente l'URL sarà http://mydemodocdbwebapp.azurewebsites.net.To use the application, simply navigate to the web app URL (in the example above, the URL would be http://mydemodocdbwebapp.azurewebsites.net). Verrà visualizzata l'applicazione Web seguente:You'll see the following web application:

    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.Go ahead and create a couple of tasks in the web app and then return to the Resource group blade in the Azure portal. Fare clic sulla risorsa dell'account Azure Cosmos DB nell'elenco delle risorse, quindi su Esplora query.Click the Azure Cosmos DB account resource in the Resources list and then click Query Explorer. Screenshot della sezione di riepilogo in cui è evidenziata l'app WebScreenshot of the Summary lens with the web app highlighted
  10. Eseguire la query predefinita "SELECT * FROM c" ed esaminarne i risultati.Run the default query, "SELECT * FROM c" and inspect the results. Si noti che la query ha recuperato la rappresentazione JSON delle attività create nel passaggio 7 precedente.Notice that the query has retrieved the JSON representation of the todo items you created in step 7 above. È 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.Feel free to experiment with queries; for example, try running SELECT * FROM c WHERE c.isComplete = true to return all todo items which have been marked as complete.

    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.Feel free to explore the Azure Cosmos DB portal experience or modify the sample Todo application. A questo punto si è pronti per distribuire un altro modello.When you're ready, let's deploy another template.

Passaggio 3: Distribuire l'esempio relativo ad account DocumentDB e app WebStep 3: Deploy the Document account and web app sample

Si procederà ora alla distribuzione del secondo modello.Now let's deploy our second template. 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.This template is useful to show how you can inject Azure Cosmos DB connection information such as account endpoint and master key into a web app as application settings or as a custom connection string. 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.For example, perhaps you have your own web application that you would like to deploy with an Azure Cosmos DB account and have the connection information automatically populated during deployment.

Suggerimento

Il modello non verifica che il nome dell'app Web e il nome dell'account Azure Cosmos DB siano validi e disponibili.The template does not validate that the web app name and Azure Cosmos DB account name entered below are a) valid and b) available. È consigliabile verificare la disponibilità dei nomi che si intende fornire prima della distribuzione.It is highly recommended that you verify the availability of the names you plan to supply prior to submitting the deployment.

  1. Nel portale di Azure, fare clic su Nuovo e ricercare "Distribuzione modello".In the Azure Portal, click New and search for "Template deployment". Screenshot dell'interfaccia utente della distribuzione del modelloScreenshot of the template deployment UI
  2. Selezionare la voce Distribuzione modello e fare clic su Crea Screenshot dell'interfaccia utente della distribuzione del modello.Select the Template deployment item and click Create Screenshot of the template deployment UI
  3. Fare clic su Modifica modello, incollare il contenuto del file del modello DocDBWebSite.json e fare clic su Salva.Click Edit template, paste the contents of the DocDBWebSite.json template file, and click Save. Screenshot dell'interfaccia utente della distribuzione del modelloScreenshot of the template deployment UI
  4. Fare clic su Modifica parametri, specificare i valori per ogni parametro obbligatorio e fare clic su OK.Click Edit parameters, provide values for each of the mandatory parameters, and click OK. I parametri sono i seguenti:The parameters are as follows:

    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.SITENAME: Specifies the App Service web app name and is used to construct the URL that you will use to access the web app (e.g. if you specify "mydemodocdbwebapp", then the URL by which you will access the web app will be mydemodocdbwebapp.azurewebsites.net).
    2. HOSTINGPLANNAME: specifica il nome del piano di hosting del servizio app da creare.HOSTINGPLANNAME: Specifies the name of App Service hosting plan to create.
    3. LOCATION: specifica la posizione di Azure in cui creare le risorse di Azure Cosmos DB e dell'app Web.LOCATION: Specifies the Azure location in which to create the Azure Cosmos DB and web app resources.
    4. DATABASEACCOUNTNAME: specifica il nome dell'account Azure Cosmos DB da creare.DATABASEACCOUNTNAME: Specifies the name of the Azure Cosmos DB account to create.

      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.Choose an existing Resource group or provide a name to make a new resource group, and choose a location for the resource group.

    Screenshot dell'interfaccia utente della distribuzione del modello

  6. Fare clic su Rivedere le note legali, Acquista, quindi su Crea per iniziare la distribuzione.Click Review legal terms, Purchase, and then click Create to begin the deployment. Selezionare Aggiungi al dashboard per rendere facilmente visibile la distribuzione ottenuta nella home page del portale di Azure.Select Pin to dashboard so the resulting deployment is easily visible on your Azure portal home page. Screenshot dell'interfaccia utente della distribuzione del modelloScreenshot of the template deployment UI
  7. Al termine della distribuzione, verrà aperto il pannello del gruppo di risorse.When the deployment finishes, the Resource group blade will open. Screenshot del pannello del gruppo di risorseScreenshot of the resource group blade
  8. Fare clic sulla risorsa dell'App Web nell'elenco delle risorse, quindi fare clic su Impostazioni applicazione Screenshot del gruppo di risorse.Click the Web App resource in the Resources list and then click Application settings Screenshot of the resource group
  9. Si noti la presenza di impostazioni dell'applicazione per l'endpoint di Azure Cosmos DB e per ognuna delle relative chiavi master.Note how there are application settings present for the Azure Cosmos DB endpoint and each of the Azure Cosmos DB master keys.

    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.Feel free to continue exploring the Azure Portal, or follow one of our Azure Cosmos DB samples to create your own Azure Cosmos DB application.

Passaggi successiviNext steps

Congratulazioni.Congratulations! È 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.You've deployed Azure Cosmos DB, App Service web app and a sample web application using Azure Resource Manager templates.

  • Per altre informazioni su Azure Cosmos DB, fare clic qui.To learn more about Azure Cosmos DB, click here.
  • Per altre informazioni sulle app Web del servizio app di Azure, vedere qui.To learn more about Azure App Service Web apps, click here.
  • Per altre informazioni sui modelli di Gestione risorse di Azure, vedere qui.To learn more about Azure Resource Manager templates, click here.

Modifiche apportateWhat's changed

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.If you want to get started with Azure App Service before signing up for an Azure account, go to Try App Service, where you can immediately create a short-lived starter web app in App Service. Non è necessario fornire una carta di credito né impegnarsi in alcun modo.No credit cards required; no commitments.