テンプレートを使用して Redis Cache を作成するCreate a Redis Cache using a template

このトピックでは、Azure Redis Cache をデプロイする Azure Resource Manager のテンプレートを作成する方法について説明します。In this topic, you learn how to create an Azure Resource Manager template that deploys an Azure Redis Cache. キャッシュを既存のストレージ アカウントで使用することで、診断データを保持することができます。The cache can be used with an existing storage account to keep diagnostic data. さらに、デプロイ対象のリソースを定義する方法と、デプロイの実行時に指定されるパラメーターを定義する方法についても説明します。You also learn how to define which resources are deployed and how to define parameters that are specified when the deployment is executed. このテンプレートは、独自のデプロイに使用することも、要件に合わせてカスタマイズすることもできます。You can use this template for your own deployments, or customize it to meet your requirements.

現時点では、診断設定は、サブスクリプションの同じリージョン内のすべてのキャッシュで共有されます。Currently, diagnostic settings are shared for all caches in the same region for a subscription. 領域内の 1 つのキャッシュを更新すると、領域内の他のすべてのキャッシュに反映されます。Updating one cache in the region affects all other caches in the region.

テンプレートの作成の詳細については、「 Authoring Azure Resource Manager Templates (Azure リソース マネージャー テンプレートのオーサリング)」を参照してください。For more information about creating templates, see Authoring Azure Resource Manager Templates.

完全なテンプレートについては、「 Redis Cache のテンプレート」を参照してください。For the complete template, see Redis Cache template.

デプロイ対象What you will deploy

このテンプレートでは、診断データ用に既存のストレージ アカウントを使用する Azure Redis Cache をデプロイします。In this template, you will deploy an Azure Redis Cache that uses an existing storage account for diagnostic data.

デプロイメントを自動的に実行するには、次のボタンをクリックします。To run the deployment automatically, click the following button:

Azure へのデプロイDeploy to Azure

パラメーターParameters

Azure リソース マネージャーを使用して、テンプレートのデプロイ時に値を指定するパラメーターを定義します。With Azure Resource Manager, you define parameters for values you want to specify when the template is deployed. テンプレートには、すべてのパラメーター値を含む Parameters という名前のセクションがあります。The template includes a section called Parameters that contains all of the parameter values. これらの値のパラメーターを定義する必要があります。これらの値は、デプロイするプロジェクトやデプロイ先の環境に応じて異なります。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. 常に同じ値に対してはパラメーターを定義しないでください。Do not define parameters for values that always stay the same. テンプレート内のそれぞれのパラメーターの値は、デプロイされるリソースを定義するために使用されます。Each parameter value is used in the template to define the resources that are deployed.

cacheSKUNamecacheSKUName

新しい Azure Redis Cache の価格レベルです。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."
  }
},

テンプレートでは、このパラメーターに指定できる値 (Basic または Standard) を定義します。値が指定されない場合は既定値 (Basic) が割り当てられます。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 では、複数のサイズを最大 53 GB まで使用できる 1 つのノードが提供されます。Basic provides a single node with multiple sizes available up to 53 GB. Standard では、複数のサイズを最大 53 GB まで使用できる 2 つのノード (プライマリとレプリカ) が提供され、99.9% の SLA が実現されます。Standard provides two-node Primary/Replica with multiple sizes available up to 53 GB and 99.9% SLA.

cacheSKUFamilycacheSKUFamily

SKU のファミリです。The family for the sku.

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

cacheSKUCapacitycacheSKUCapacity

新しい Azure Redis Cache インスタンスのサイズです。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. "
  }
}

テンプレートには、このパラメーターに指定できる値 (0、1、2、3、4、5、または 6) を定義します。値が指定されない場合は既定値 (1) が割り当てられます。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. これらの数値はキャッシュ サイズに対応します (0 = 250 MB、1 = 1 GB、2 = 2.5 GB、3 = 6 GB、4 = 13 GB、5 = 26 GB、6 = 53 GB)。Those 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

Redis Cache の場所。The location of the Redis Cache. 最適なパフォーマンスのために、アプリケーションとキャッシュで同じ場所を使用することをお勧めします。For best performance, use the same location as the app to be used with the cache.

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

existingDiagnosticsStorageAccountNameexistingDiagnosticsStorageAccountName

診断用に使用する既存のストレージ アカウントの名前。The name of the existing storage account to use for diagnostics.

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

enableNonSslPortenableNonSslPort

非 SSL ポート経由のアクセスを許可するかどうかを示すブール値です。A boolean value that indicates whether to allow access via non-SSL ports.

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

diagnosticsStatusdiagnosticsStatus

診断が有効かどうかを示す値です。A value that indicates whether diagnostics is enabled. ON または OFF を使用します。Use ON or OFF.

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

デプロイ対象のリソースResources to deploy

Redis CacheRedis Cache

Azure Redis Cache を作成します。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')]"
      }
    }
  ]
}

デプロイメントを実行するコマンドCommands to run deployment

リソースを Azure にデプロイするには、Azure アカウントにログインし、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. Azure リソース マネージャーを Azure PowerShell または Azure CLI で使用する方法については、次のトピックを参照してください。To learn about using Azure Resource Manager with either Azure PowerShell or Azure CLI, see:

次の例では、指定した名前のアカウントにリソース グループが既にあるものと想定しています。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

Azure CLIAzure CLI

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