Introduzione ai modelli privati nel portale di AzureGet started with private Templates on the Azure Portal

Un modello di Azure Resource Manager è un modello dichiarativo usato per definire la distribuzione.An Azure Resource Manager template is a declarative template used to define your deployment. Permette di definire le risorse da distribuire per una soluzione e di specificare i parametri e le variabili che consentono di immettere valori per diversi ambienti.You can define the resources to deploy for a solution, and specify parameters and variables that enable you to input values for different environments. Il modello è composto da JSON ed espressioni che è possibile usare per creare valori per la distribuzione.The template consists of JSON and expressions which you can use to construct values for your deployment.

È possibile usare la nuova funzionalità Modelli nel portale di Azure insieme al provider di risorse Microsoft.Gallery come estensione di Azure Marketplace, per consentire agli utenti di creare, gestire e distribuire modelli privati da una raccolta personale.You can use the new Templates capability in the Azure Portal along with the Microsoft.Gallery resource provider as an extension of the Azure Marketplace to enable users to create, manage and deploy private templates from a personal library.

Questo documento descrive come aggiungere, gestire e condividere un modello privato con il portale di Azure.This document walks you through adding, managing and sharing a private Template using the Azure Portal.

IndicazioniGuidance

I suggerimenti riportati di seguito permettono di sfruttare al meglio i modelli per l'uso delle soluzioni:The following suggestions will help you take full advantage of Templates when working with your solutions:

  • Un modello è una risorsa di incapsulamento contenente un modello di Resource Manager e metadati aggiuntivi.A Template is an encapsulating resource that contains an Resource Manager template and additional metadata. Si comporta in modo molto simile a un elemento di Marketplace.It behaves very similarly to an item in the Marketplace. La differenza principale è che si tratta di un elemento privato, mentre gli elementi di Marketplace sono pubblici.The key difference is that it is a private item as opposed to the public Marketplace items.
  • La raccolta Modelli è efficace per gli utenti che vogliono personalizzare le distribuzioni.The Templates library works well for users who need to customize their deployments.
  • modelli permettono di usare un repository semplice all'interno di Azure.Templates work well for users who need a simple repository within Azure.
  • Iniziare con un modello di Resource Manager esistente.Start with an existing Resource Manager template. In GitHub o nel post di blog relativo all'esportazione modelli è possibile trovare modelli a partire da un gruppo di risorse esistente.Find templates in github or Export template from an existing resource group.
  • modelli sono legati all'utente che li pubblica.Templates are tied to the user who publishes them. Il nome dell'autore è visibile a chiunque abbia accesso in lettura.The publisher name is visible to everyone who has read access to it.
  • modelli sono risorse di Resource Manager e non possono essere rinominati dopo la pubblicazione.Templates are Resource Manager resources and cannot be renamed once published.

Aggiungere una risorsa modelloAdd a Template resource

Per creare una risorsa modello nel portale di Azure è possibile procedere in due modi.There are two ways to create a Template resource in the Azure portal.

Metodo 1: creare una nuova risorsa modello da un gruppo di risorse in esecuzioneMethod 1 : Create a new Template resource from a running resource group

  1. Passare a un gruppo di risorse esistente nel portale di Azure.Navigate to an existing resource group on the Azure Portal. In Impostazioni selezionare Esporta modello.Select Export template in Settings.
  2. Dopo aver esportato il modello di Resource Manager, fare clic sul pulsante Salva modello per salvarlo nel repository Modelli.Once the Resource Manager template is exported, use the Save Template button to save it to the Templates repository. Per informazioni dettagliate sull'esportazione di modelli, vedere questa pagina.Find complete details for Export template here.

    Esportazione di un gruppo di risorse Resource group export
  3. Fare clic sul pulsante di comando Salva modello .Select the Save to Template command button.

  4. Immettere le seguenti informazioni:Enter the following information:

    • Nome: nome dell'oggetto modello. Nota: il nome è basato su Azure Resource Manager.Name – Name of the template object (NOTE: This is an Azure Resource Manager based name. È soggetto a tutte le limitazioni relative all'assegnazione dei nomi non può essere modificato dopo la creazione.All naming restrictions apply and it cannot be changed once created).
    • Descrizione: breve descrizione del modello.Description – Quick summary about the template.

      Salva modello

  5. Fare clic su Save.Click Save.

    Nota

    In caso di errori del modello di Resource Manager esportato, le notifiche vengono visualizzate nel pannello Esporta modello. Sarà comunque possibile salvare il modello di Resource Manager nei modelli.The Export template blade shows notifications when the exported Resource Manager template has errors, but you will still be able to save this Resource Manager template to the Templates. Assicurarsi di controllare e correggere eventuali problemi del modello di Resource Manager prima di ridistribuire il modello di Resource Manager esportato.Ensure that you check and fix any Resource Manager template issues before redeploying the exported Resource Manager template.

Metodo 2: aggiungere una nuova risorsa modello dall'esplorazioneMethod 2 : Add a new Template resource from browse

È anche possibile aggiungere un nuovo modello da zero usando il pulsante di comando +Aggiungi in Esplora > Modelli.You can also add a new Template from scratch using the +Add command button in Browse > Templates. È necessario specificare un nome, una descrizione e il file JSON del modello di Resource Manager.You will need to provide a Name, Description and the Resource Manager template JSON.

Aggiungi modello

Nota

Microsoft.Gallery è un provider di risorse di Azure basato su tenant.Microsoft.Gallery is a Tenant based Azure resource provider. La risorsa modello è associata all'utente che l'ha creata.The Template resource is tied to the user who created it. Non è associata a una sottoscrizione specifica.It is not tied to any specific subscription. È necessario scegliere una sottoscrizione solo quando si distribuisce un modello.A subscription needs to be chosen only when deploying a Template.

Visualizzare le risorse modelloView Template resources

È possibile visualizzare tutti i modelli disponibili in Esplora > Modelli.All Templates available to you can be seen at Browse > Templates. Sono inclusi i modelli creati dall'utente e quelli condivisi con l'utente a vari livelli di autorizzazione.This includes Templates you have created as well as ones that have been shared with you with varying levels of permissions. Per altre informazioni sul controllo di accesso , vedere la relativa sezione più avanti in questo articolo.More details in the access control section below.

Visualizza modello

Per visualizzare i dettagli di un modello è possibile fare clic su un elemento nell'elenco.You can view the details of a Template by clicking into an item in the list.

Visualizza modello

Modificare una risorsa modelloEdit a Template resource

Per avviare il flusso di modifica per un modello , fare clic con il pulsante destro del mouse sull'elemento nell'elenco di ricerca o scegliere il pulsante di comando Modifica.You can initiate the edit flow for a Template by right clicking the item on the Browse list or by choosing the Edit command button.

Modifica modello

È possibile modificare la descrizione o il testo del modello di Resource Manager.You can edit the description or Resource Manager template text. Dato che si tratta di un nome di risorsa di Resource Manager, non è possibile modificare il nome.You cannot edit the name since it is an Resource Manager resource name. Quando si modifica il file JSON del modello di Resource Manager, viene eseguita la convalida per verificare che si tratti di un file JSON valido.When you edit the Resource Manager template JSON we will validate to ensure that it is valid JSON. Scegliere OK e quindi Salva per salvare il modello aggiornato.Choose OK and then Save to save your updated template.

Modifica modello

Verrà visualizzata una notifica che conferma il salvataggio del modello .Once the Template is saved you will see a confirmation notification.

Modifica modello

Distribuire una risorsa modelloDeploy a Template resource

È possibile distribuire qualsiasi modello per cui si hanno autorizzazioni di lettura.You can deploy any Template that you have Read permissions on. Il flusso di distribuzione consente di avviare il pannello di distribuzione del modello di Azure standard.The deployment flow launches the standard Azure Template deployment blade. Compilare i valori per i parametri del modello di Resource Manager per procedere con la distribuzione.Fill out the values for the Resource Manager template parameters to proceed with the deployment.

Modello di distribuzione

Condividere una risorsa modelloShare a Template resource

È possibile condividere le risorse modello con altri utenti.A Template resource can be shared with your peers. La condivisione funziona in modo simile all' assegnazione di ruoli per qualsiasi risorsa di Azure.Sharing behaves similarly to role assignment for any resource on Azure. Il proprietario del modello fornisce le autorizzazioni ad altri utenti, che possono interagire con la risorsa modello.The Template owner provides permissions to other users who can interact with a Template resource. L'utente o il gruppo di utenti con cui viene condiviso il modello può visualizzare il modello di Resource Manager e le relative proprietà della raccolta.The person or group of people you share the Template with will be able to see the Resource Manager template and its gallery properties.

Controllo di accesso per le risorse Microsoft.GalleryAccess control for the Microsoft.Gallery resources

RuoloRole AutorizzazioniPermissions
ProprietarioOwner Consente il controllo completo sulla risorsa modello, inclusa la condivisione.Allows full control on the Template resource including Share
LettoreReader Consente l'autorizzazione di lettura ed esecuzione o distribuzione sulla risorsa modello.Allows Read and Execute(Deploy) on the Template resource
CollaboratoreContributor Consente l'autorizzazione di modifica ed eliminazione sulla risorsa modello.Allows Edit and Delete permission on the Template resource. L'utente non può condividere il modello con altri.User cannot Share the Template with others

Fare clic con il pulsante destro del mouse sul pannello di visualizzazione di un elemento specifico e selezionare Condividi .Select Share on the browse item by right clicking or on the view blade of a specific item. Verrà avviata la condivisione.This launches a Share experience.

Condividi modello

È possibile scegliere un ruolo e un utente o un gruppo a cui fornire l'accesso a un modellospecifico.You can now choose a role and a user or group to provide access to a particular Template. I ruoli disponibili sono Proprietario, Lettore e Collaboratore.The available roles are Owner, Reader and Contributor. Per altre informazioni sul controllo di accesso , vedere la relativa sezione precedente.More details in the access control section above.

Condividi modello

Condividi modello

Fare clic su Seleziona e quindi su OK.Click Select and Ok. Ora è possibile visualizzare gli utenti o i gruppi aggiunti alla risorsa.You can now see the users or groups you added to the resource.

Condividi modello

Nota

Un modello può essere condiviso solo con utenti e gruppi nello stesso tenant di Azure Active Directory.A Template can only be shared with users and groups in the same Azure Active Directory tenant. Se si condivide un modello con un indirizzo di posta elettronica che non è incluso nel tenant, viene inviato un invito a entrare nel tenant come guest.If you share a Template with an email address that is not in your tenant, an invitation will be sent asking the user to join the tenant as a guest.

Passaggi successiviNext steps