Creare una Cache Redis utilizzando un modelloCreate a Redis Cache using a template

Questo argomento illustra come creare un modello di Azure Resource Manager che consente di distribuire un'istanza di Cache Redis di Azure.In this topic, you learn how to create an Azure Resource Manager template that deploys an Azure Redis Cache. La cache è utilizzabile con un account di archiviazione esistente per mantenere i dati di diagnostica.The cache can be used with an existing storage account to keep diagnostic data. Verrà anche illustrato come definire le risorse da distribuire e i parametri specificati quando viene eseguita la distribuzione.You also learn how to define which resources are deployed and how to define parameters that are specified when the deployment is executed. È possibile usare questo modello per le proprie distribuzioni o personalizzarlo in base alle esigenze.You can use this template for your own deployments, or customize it to meet your requirements.

Le impostazioni di diagnostica sono attualmente condivise da tutte le cache nella stessa area di una sottoscrizione.Currently, diagnostic settings are shared for all caches in the same region for a subscription. L'aggiornamento di una cache nell'area ha effetto su tutte le altre cache presenti nell'area.Updating one cache in the region affects all other caches in the region.

Per altre informazioni sulla creazione dei modelli, vedere Creazione di modelli di Gestione risorse di Azure.For more information about creating templates, see Authoring Azure Resource Manager Templates.

Per il modello completo, vedere il modello di Cache Redis.For the complete template, see Redis Cache template.

Elementi distribuitiWhat you will deploy

In questo modello, verrà distribuita una Cache Redis di Azure che utilizza un account di archiviazione esistente per dati di diagnostica.In this template, you will deploy an Azure Redis Cache that uses an existing storage account for diagnostic data.

Per eseguire automaticamente la distribuzione, fare clic sul pulsante seguente:To run the deployment automatically, click the following button:

Distribuzione in AzureDeploy to Azure

ParametriParameters

Gestione risorse di Azure permette di definire i parametri per i valori da specificare durante la distribuzione del modello.With Azure Resource Manager, you define parameters for values you want to specify when the template is deployed. Il modello include una sezione denominata Parametri che contiene tutti i valori dei parametri.The template includes a section called Parameters that contains all of the parameter values. È necessario definire un parametro per i valori che variano in base al progetto distribuito o all'ambiente in cui viene distribuito il progetto.You should define a parameter for those values that vary based on the project you are deploying or based on the environment you are deploying to. Non definire i parametri per i valori che rimangono invariati.Do not define parameters for values that always stay the same. Ogni valore di parametro nel modello viene usato per definire le risorse distribuite.Each parameter value is used in the template to define the resources that are deployed.

cacheSKUNamecacheSKUName

Piano tariffario della nuova Cache Redis di Azure.The pricing tier of the new Azure Redis Cache.

"cacheSKUName": {
  "type": "string",
  "allowedValues": [
    "Basic",
    "Standard"
  ],
  "defaultValue": "Basic",
  "metadata": {
    "description": "The pricing tier of the new Azure Redis Cache."
  }
},

Il modello definisce i valori consentiti per questo parametro (Basic o Standard) e assegna un valore predefinito (Basic) se non viene specificato alcun valore.The template defines the values that are permitted for this parameter (Basic or Standard), and assigns a default value (Basic) if no value is specified. Basic fornisce un singolo nodo con più dimensioni disponibili fino a 53 GB.Basic provides a single node with multiple sizes available up to 53 GB. Standard fornisce due nodi di replica/primario con più dimensioni disponibili fino a 53 GB e contratto di servizio con disponibilità del 99,9%.Standard provides two-node Primary/Replica with multiple sizes available up to 53 GB and 99.9% SLA.

cacheSKUFamilycacheSKUFamily

Famiglia dello SKU.The family for the sku.

"cacheSKUFamily": {
  "type": "string",
  "allowedValues": [
    "C"
  ],
  "defaultValue": "C",
  "metadata": {
    "description": "The family for the sku."
  }
},

cacheSKUCapacitycacheSKUCapacity

Dimensioni dell'istanza della nuova Cache Redis di Azure.The size of the new Azure Redis Cache instance.

"cacheSKUCapacity": {
  "type": "int",
  "allowedValues": [
    0,
    1,
    2,
    3,
    4,
    5,
    6
  ],
  "defaultValue": 0,
  "metadata": {
    "description": "The size of the new Azure Redis Cache instance. "
  }
}

Il modello definisce i valori consentiti per questo parametro (0, 1, 2, 3, 4, 5 o 6) e assegna un valore predefinito (1) se non viene specificato alcun valore.The template defines the values that are permitted for this parameter (0, 1, 2, 3, 4, 5 or 6), and assigns a default value (1) if no value is specified. Questi numeri corrispondono alle dimensioni della cache seguenti: 0 = 250 MB, 1 = 1 GB, 2 = 2,5 GB, 3 = 6 GB, 4 = 13 GB, 5 = 26 GB, 6 = 53 GBThose numbers correspond to following cache sizes: 0 = 250 MB, 1 = 1 GB, 2 = 2.5 GB, 3 = 6 GB, 4 = 13 GB, 5 = 26 GB, 6 = 53 GB

redisCacheLocationredisCacheLocation

Percorso dell'istanza di Cache Redis.The location of the Redis Cache. Per prestazioni ottimali, usare lo stesso percorso dell'app da usare con la cache.For best performance, use the same location as the app to be used with the cache.

"redisCacheLocation": {
  "type": "string"
}

existingDiagnosticsStorageAccountNameexistingDiagnosticsStorageAccountName

Nome dell'account di archiviazione esistente da utilizzare per le diagnostiche.The name of the existing storage account to use for diagnostics.

"existingDiagnosticsStorageAccountName": {
  "type": "string"
}

enableNonSslPortenableNonSslPort

Valore booleano che indica se è consentito l'accesso tramite le porte non SSL.A boolean value that indicates whether to allow access via non-SSL ports.

"enableNonSslPort": {
  "type": "bool"
}

diagnosticsStatusdiagnosticsStatus

Valore che indica se la diagnostica è abilitata.A value that indicates whether diagnostics is enabled. Utilizzare ON o OFF.Use ON or OFF.

"diagnosticsStatus": {
  "type": "string",
  "defaultValue": "ON",
  "allowedValues": [
        "ON",
        "OFF"
    ]
}

Risorse da distribuireResources to deploy

Cache RedisRedis Cache

Crea la Cache Redis di Azure.Creates the Azure Redis Cache.

{
  "apiVersion": "2015-08-01",
  "name": "[parameters('redisCacheName')]",
  "type": "Microsoft.Cache/Redis",
  "location": "[parameters('redisCacheLocation')]",
  "properties": {
    "enableNonSslPort": "[parameters('enableNonSslPort')]",
    "sku": {
      "capacity": "[parameters('redisCacheCapacity')]",
      "family": "[parameters('redisCacheFamily')]",
      "name": "[parameters('redisCacheSKU')]"
    }
  },
  "resources": [
    {
      "apiVersion": "2015-07-01",
      "type": "Microsoft.Cache/redis/providers/diagnosticsettings",
      "name": "[concat(parameters('redisCacheName'), '/Microsoft.Insights/service')]",
      "location": "[parameters('redisCacheLocation')]",
      "dependsOn": [
        "[concat('Microsoft.Cache/Redis/', parameters('redisCacheName'))]"
      ],
      "properties": {
        "status": "[parameters('diagnosticsStatus')]",
        "storageAccountName": "[parameters('existingDiagnosticsStorageAccountName')]"
      }
    }
  ]
}

Comandi per eseguire la distribuzioneCommands to run deployment

Per distribuire le risorse in Azure, è necessario aver eseguito l'accesso all'account Azure e usare il modulo Gestione risorse di Azure.To deploy the resources to Azure, you must be logged in to your Azure account and you must use the Azure Resource Manager module. Per altre informazioni su come usare Gestione risorse di Azure con Azure PowerShell o l'interfaccia della riga di comando di Azure, vedere:To learn about using Azure Resource Manager with either Azure PowerShell or Azure CLI, see:

Gli esempi seguenti presuppongono che nell'account sia già stato creato un gruppo di risorse con il nome specificato.The following examples assume you already have a resource group in your account with the specified name.

PowerShellPowerShell

New-AzureRmResourceGroupDeployment -TemplateUri https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/101-redis-cache/azuredeploy.json -ResourceGroupName ExampleDeployGroup -redisCacheName ExampleCache

Interfaccia della riga di comando di AzureAzure CLI

azure group deployment create --template-uri https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/101-redis-cache/azuredeploy.json -g ExampleDeployGroup