Microsoft.Cache redis
Bicep 리소스 정의
redis 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.
- 리소스 그룹 - 리소스 그룹 배포 명령 참조
각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.
리소스 형식
Microsoft.Cache/redis 리소스를 만들려면 템플릿에 다음 Bicep을 추가합니다.
resource symbolicname 'Microsoft.Cache/redis@2023-08-01' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
{customized property}: 'string'
identity: {
type: 'string'
userAssignedIdentities: {
{customized property}: {}
}
}
properties: {
enableNonSslPort: bool
minimumTlsVersion: 'string'
publicNetworkAccess: 'string'
redisConfiguration: {
'aad-enabled': 'string'
'aof-backup-enabled': 'string'
'aof-storage-connection-string-0': 'string'
'aof-storage-connection-string-1': 'string'
authnotrequired: 'string'
'maxfragmentationmemory-reserved': 'string'
'maxmemory-delta': 'string'
'maxmemory-policy': 'string'
'maxmemory-reserved': 'string'
'preferred-data-persistence-auth-method': 'string'
'rdb-backup-enabled': 'string'
'rdb-backup-frequency': 'string'
'rdb-backup-max-snapshot-count': 'string'
'rdb-storage-connection-string': 'string'
'storage-subscription-id': 'string'
{customized property}: any()
}
redisVersion: 'string'
replicasPerMaster: int
replicasPerPrimary: int
shardCount: int
sku: {
capacity: int
family: 'string'
name: 'string'
}
staticIP: 'string'
subnetId: 'string'
tenantSettings: {
{customized property}: 'string'
}
updateChannel: 'string'
}
zones: [
'string'
]
}
속성 값
redis
| Name | Description | 값 |
|---|---|---|
| name | 리소스 이름 | string(필수) 문자 제한: 1-63 유효한 문자: 영숫자 및 하이픈 영숫자로 시작하고 끝납니다. 연속 하이픈은 허용되지 않습니다. 리소스 이름은 Azure에서 고유해야 합니다. |
| 위치 | 리소스가 있는 지리적 위치 | string(필수) |
| tags | 리소스 태그. | 태그 이름 및 값의 사전입니다. 템플릿의 태그를 참조하세요. |
| identity | 리소스의 ID입니다. | ManagedServiceIdentity |
| properties | Redis 캐시 속성입니다. | RedisCreatePropertiesOrRedisProperties (필수) |
| 영역 | 리소스의 원본을 나타내는 가용성 영역 목록입니다. | string[] |
ManagedServiceIdentity
| Name | Description | 값 |
|---|---|---|
| 형식 | 관리 서비스 ID 유형(SystemAssigned 및 UserAssigned 형식이 모두 허용됨). | 'None' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned'(필수) |
| userAssignedIdentities | 리소스와 연결된 사용자 할당 ID 집합입니다. userAssignedIdentities 사전 키는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} 형식의 ARM 리소스 ID입니다. 사전 값은 요청에서 빈 개체({})일 수 있습니다. | UserAssignedIdentities |
UserAssignedIdentities
| Name | Description | 값 |
|---|---|---|
| {사용자 지정 속성} | UserAssignedIdentity |
UserAssignedIdentity
이 개체에는 배포 중에 설정할 속성이 포함되어 있지 않습니다. 모든 속성은 ReadOnly입니다.
RedisCreatePropertiesOrRedisProperties
| Name | Description | 값 |
|---|---|---|
| enableNonSslPort | ssl이 아닌 Redis 서버 포트(6379)를 사용할 수 있는지 여부를 지정합니다. | bool |
| minimumTlsVersion | 선택 사항: 클라이언트가 지정된 TLS 버전(또는 그 이상)을 사용하여 연결해야 합니다(예: '1.0', '1.1', '1.2'). | '1.0' '1.1' '1.2' |
| publicNetworkAccess | 이 캐시에 대해 퍼블릭 엔드포인트 액세스가 허용되는지 여부입니다. 값은 선택 사항이지만 전달된 경우 '사용' 또는 '사용 안 함'이어야 합니다. 'Disabled'인 경우 프라이빗 엔드포인트는 전용 액세스 방법입니다. 기본값은 'Enabled'입니다. | '사용 안 함' '사용' |
| redisConfiguration | 모든 Redis 설정. 몇 가지 가능한 키: rdb-backup-enabled,rdb-storage-connection-string,rdb-backup-frequency,maxmemory-delta,maxmemory-policy,notify-keyspace-events,maxmemory-samples,slowlog-log-slow-than,slowlog-max-len,list-max-ziplist-entries,list-max-ziplist-value,hash-max-ziplist-entries,hash-max-ziplist-value,set-max-intset-entries,zset-max-ziplist-entries,zset-max-ziplist-value 등 | RedisCommonPropertiesRedisConfiguration |
| redisVersion | Redis 버전입니다. 이는 'major[.minor]' 형식('major'만 필요) 또는 사용 가능한 안정적인 최신 Redis 버전을 참조하는 'latest' 값이어야 합니다. 지원되는 버전: 4.0, 6.0(최신). 기본값은 'latest'입니다. | 문자열 |
| replicasPerMaster | 주 복제본당 만들 복제본 수입니다. | int |
| replicasPerPrimary | 주 복제본당 만들 복제본 수입니다. | int |
| shardCount | 프리미엄 클러스터 캐시에 만들 분할된 데이터베이스 수입니다. | int |
| sku | 배포할 Redis 캐시의 SKU입니다. | Sku (필수) |
| staticIP | 고정 IP 주소입니다. 필요에 따라 기존 Azure Virtual Network 내에 Redis 캐시를 배포할 때 지정할 수 있습니다. 기본적으로 자동으로 할당됩니다. | 문자열 제약 조건: 패턴 = ^\d+\.\d+\.\d+\.\d+$ |
| subnetId | Redis 캐시를 배포할 가상 네트워크에 있는 서브넷의 전체 리소스 ID입니다. 예제 형식: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/Microsoft. {Network,ClassicNetwork}/VirtualNetworks/vnet1/subnets/subnet1 | string 제약 조건: 패턴 = ^/subscriptions/[^/]*/resourceGroups/[^/]*/providers/Microsoft.(ClassicNetwork|Network)/virtualNetworks/[^/]*/subnets/[^/]*$ |
| tenantSettings | 테넌트 설정의 사전 | RedisCommonPropertiesTenantSettings |
| updateChannel | 선택 사항: Redis Cache에서 받을 월별 Redis 업데이트에 대한 업데이트 채널을 지정합니다. '미리 보기' 업데이트 채널을 사용하는 캐시는 '안정적인' 채널 캐시보다 최소 4주 전에 최신 Redis 업데이트를 받습니다. 기본값은 '안정'입니다. | '미리 보기' '안정' |
RedisCommonPropertiesRedisConfiguration
| Name | Description | 값 |
|---|---|---|
| aad-enabled | 캐시에 대해 AAD 기반 인증을 사용하도록 설정했는지 여부를 지정합니다. | 문자열 |
| aof-backup-enabled | aof 백업을 사용할 수 있는지 여부를 지정합니다. | 문자열 |
| aof-storage-connection-string-0 | 첫 번째 스토리지 계정 연결 문자열 | 문자열 |
| aof-storage-connection-string-1 | 두 번째 스토리지 계정 연결 문자열 | 문자열 |
| authnotrequired | 인증을 사용하지 않도록 설정할지 여부를 지정합니다. 이 속성을 설정하는 것은 보안 관점에서 매우 권장되지 않습니다. | 문자열 |
| maxfragmentationmemory-reserved | 분할당 조각화를 위해 예약된 값(메가바이트) | 문자열 |
| maxmemory-delta | 분할된 데이터베이스당 비 캐시 사용량(예: 장애 조치)을 위해 예약된 값(메가바이트)입니다. | string |
| maxmemory-policy | 데이터가 메모리 제한에 맞지 않을 때 사용되는 제거 전략입니다. | 문자열 |
| maxmemory-reserved | 분할된 데이터베이스당 비 캐시 사용량(예: 장애 조치)을 위해 예약된 값(메가바이트)입니다. | 문자열 |
| preferred-data-persistence-auth-method | 데이터 지속성에 사용되는 스토리지 계정과 통신하고, SAS 또는 ManagedIdentity를 지정하는 기본 인증 방법, 기본값은 SAS입니다. | 문자열 |
| rdb-backup-enabled | rdb 백업을 사용할 수 있는지 여부를 지정합니다. | string |
| rdb-backup-frequency | 몇 분 안에 rdb 백업을 만드는 빈도를 지정합니다. 유효한 값: (15, 30, 60, 360, 720, 1440) | 문자열 |
| rdb-backup-max-스냅샷-count | rdb 백업에 대한 최대 스냅샷 수를 지정합니다. | 문자열 |
| rdb-storage-connection-string | rdb 파일을 저장하기 위한 스토리지 계정 연결 문자열 | 문자열 |
| storage-subscription-id | ManagedIdentity를 사용하는 지속성(aof/rdb)에 대한 스토리지 계정의 SubscriptionId입니다. | 문자열 |
| {customized property} | Bicep의 경우 any() 함수를 사용할 수 있습니다. |
SKU
| Name | Description | 값 |
|---|---|---|
| 용량 | 배포할 Redis 캐시의 크기입니다. 유효한 값: C(기본/표준) 제품군(0, 1, 2, 3, 4, 5, 6), P(프리미엄) 패밀리(1, 2, 3, 4). | int(필수) |
| family | 사용할 SKU 제품군입니다. 유효한 값: (C, P). (C = 기본/표준, P = 프리미엄). | 'C' 'P'(필수) |
| name | 배포할 Redis 캐시의 유형입니다. 유효한 값: (Basic, Standard, Premium) | 'Basic' '프리미엄' 'Standard'(필수) |
RedisCommonPropertiesTenantSettings
| Name | Description | 값 |
|---|---|---|
| {customized property} | 문자열 |
빠른 시작 템플릿
다음 빠른 시작 템플릿은 이 리소스 종류를 배포합니다.
| 템플릿 | Description |
|---|---|
확장 가능한 Umbraco CMS 웹앱
|
이 템플릿은 Azure App Service Web Apps umbraco CMS 웹앱을 배포하는 쉬운 방법을 제공합니다. |
|
ILB ASE를 사용하여 eShop 웹 사이트
|
App Service Environment는 Azure App Service의 프리미엄 서비스 계획 옵션으로, Web Apps, Mobile Apps 및 API Apps을 포함하여 높은 확장성으로 Azure App Service 앱을 안전하게 실행하기 위해 완전히 격리된 전용 환경을 제공합니다. |
|
외부 Azure Cache for Redis 사용하여 API Management 배포
|
이 템플릿은 외부 Azure Cache for Redis instance API Management 외부 캐시로 사용하여 소비 계층에서 Azure API Management instance 만드는 방법을 보여 줍니다. |
|
템플릿을 사용하여 Redis Cache 만들기
|
이 템플릿은 스토리지 계정에 보관된 진단 데이터를 사용하여 Azure Redis Cache를 만듭니다. |
|
Microsoft Entra 인증을 사용하여 Redis Cache를 만듭니다.
|
이 템플릿은 Redis Cache를 만듭니다. 그런 다음, 기본 제공 액세스 정책을 redis 사용자에게 할당합니다. 그런 다음 사용자 지정 액세스 정책을 만듭니다. 그런 다음 다른 Redis 사용자에게 사용자 지정 액세스 정책을 할당합니다. |
|
클러스터링을 사용하여 프리미엄 Redis 캐시 만들기
|
이 템플릿은 프리미엄 Azure Redis Cache instance 클러스터링 구성하는 방법을 보여 줍니다. |
|
지속성 데이터를 사용하여 프리미엄 Redis 캐시 만들기
|
이 템플릿은 프리미엄 Azure Redis Cache instance 지속성을 구성하는 방법을 보여 줍니다. |
|
Virtual Network에 배포된 프리미엄 Redis Cache 만들기
|
이 템플릿은 프리미엄 Azure Redis Cache instance 기존 Virtual Network 배포하는 방법을 보여 줍니다. |
|
Virtual Network 두 개의 지역에서 복제된 캐시 만들기
|
이 템플릿은 두 개의 프리미엄 계층 Azure Cache for Redis 인스턴스를 별도의 Virtual Network에 배포하고 지역 복제와 연결하는 방법을 보여 줍니다. |
|
템플릿을 사용하여 웹앱 + Redis Cache + SQL DB 만들기
|
이 템플릿은 Redis 캐시 및 SQL Database 사용하여 Azure Web App을 만듭니다. |
|
템플릿을 사용하여 Redis Cache가 포함된 웹앱 만들기
|
이 템플릿은 Redis 캐시를 사용하여 Azure Web App을 만듭니다. |
ARM 템플릿 리소스 정의
redis 리소스 종류는 다음을 대상으로 하는 작업을 사용하여 배포할 수 있습니다.
- 리소스 그룹 - 리소스 그룹 배포 명령을 참조하세요.
각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.
리소스 형식
Microsoft.Cache/redis 리소스를 만들려면 템플릿에 다음 JSON을 추가합니다.
{
"type": "Microsoft.Cache/redis",
"apiVersion": "2023-08-01",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"{customized property}": "string"
"identity": {
"type": "string",
"userAssignedIdentities": {
"{customized property}": {}
}
},
"properties": {
"enableNonSslPort": "bool",
"minimumTlsVersion": "string",
"publicNetworkAccess": "string",
"redisConfiguration": {
"aad-enabled": "string",
"aof-backup-enabled": "string",
"aof-storage-connection-string-0": "string",
"aof-storage-connection-string-1": "string",
"authnotrequired": "string",
"maxfragmentationmemory-reserved": "string",
"maxmemory-delta": "string",
"maxmemory-policy": "string",
"maxmemory-reserved": "string",
"preferred-data-persistence-auth-method": "string",
"rdb-backup-enabled": "string",
"rdb-backup-frequency": "string",
"rdb-backup-max-snapshot-count": "string",
"rdb-storage-connection-string": "string",
"storage-subscription-id": "string",
"{customized property}": {}
},
"redisVersion": "string",
"replicasPerMaster": "int",
"replicasPerPrimary": "int",
"shardCount": "int",
"sku": {
"capacity": "int",
"family": "string",
"name": "string"
},
"staticIP": "string",
"subnetId": "string",
"tenantSettings": {
"{customized property}": "string"
},
"updateChannel": "string"
},
"zones": [ "string" ]
}
속성 값
redis
| Name | Description | 값 |
|---|---|---|
| 형식 | 리소스 종류 | 'Microsoft.Cache/redis' |
| apiVersion | 리소스 api 버전 | '2023-08-01' |
| name | 리소스 이름 | string(필수) 문자 제한: 1-63 유효한 문자: 영숫자 및 하이픈 영숫자로 시작하고 끝납니다. 연속 하이픈은 허용되지 않습니다. 리소스 이름은 Azure에서 고유해야 합니다. |
| 위치 | 리소스가 있는 지리적 위치 | string(필수) |
| tags | 리소스 태그. | 태그 이름 및 값의 사전입니다. 템플릿의 태그를 참조하세요. |
| identity | 리소스의 ID입니다. | ManagedServiceIdentity |
| properties | Redis 캐시 속성입니다. | RedisCreatePropertiesOrRedisProperties (필수) |
| 영역 | 리소스의 원본 위치를 나타내는 가용성 영역 목록입니다. | string[] |
ManagedServiceIdentity
| Name | Description | 값 |
|---|---|---|
| 형식 | 관리 서비스 ID 유형(SystemAssigned 및 UserAssigned 형식이 모두 허용됨). | 'None' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned'(필수) |
| userAssignedIdentities | 리소스와 연결된 사용자 할당 ID 집합입니다. userAssignedIdentities 사전 키는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} 형식의 ARM 리소스 ID입니다. 사전 값은 요청에서 빈 개체({})일 수 있습니다. | UserAssignedIdentities |
UserAssignedIdentities
| Name | Description | 값 |
|---|---|---|
| {customized property} | UserAssignedIdentity |
UserAssignedIdentity
이 개체에는 배포 중에 설정할 속성이 포함되어 있지 않습니다. 모든 속성은 ReadOnly입니다.
RedisCreatePropertiesOrRedisProperties
| Name | Description | 값 |
|---|---|---|
| enableNonSslPort | ssl이 아닌 Redis 서버 포트(6379)를 사용할지 여부를 지정합니다. | bool |
| minimumTlsVersion | 선택 사항: 클라이언트가 지정된 TLS 버전(또는 그 이상)을 사용하여 연결해야 합니다(예: '1.0', '1.1', '1.2'). | '1.0' '1.1' '1.2' |
| publicNetworkAccess | 이 캐시에 대한 퍼블릭 엔드포인트 액세스가 허용되는지 여부입니다. 값은 선택 사항이지만 전달되는 경우 '사용' 또는 '사용 안 함'이어야 합니다. 'Disabled'인 경우 프라이빗 엔드포인트는 전용 액세스 방법입니다. 기본값은 'Enabled'입니다. | 'Disabled' 'Enabled' |
| redisConfiguration | 모든 Redis 설정. 몇 가지 가능한 키: rdb-backup-enabled,rdb-storage-connection-string,rdb-backup-frequency,maxmemory-delta,maxmemory-policy,notify-keyspace-events,maxmemory-samples,slowlog-log-slow-than,slowlog-max-len, list-max-ziplist-entries,list-max-ziplist-value,hash-max-ziplist-entries,hash-max-ziplist-value,set-max-intset-entries,zset-max-ziplist-entries,zset-max-ziplist-value 등 | RedisCommonPropertiesRedisConfiguration |
| redisVersion | Redis 버전입니다. 이 형식은 'major[.minor]'('major'만 필요) 또는 사용할 수 있는 안정적인 최신 Redis 버전을 참조하는 'latest' 값이어야 합니다. 지원되는 버전: 4.0, 6.0(최신). 기본값은 'latest'입니다. | 문자열 |
| replicasPerMaster | 주 복제본당 만들 복제본 수입니다. | int |
| replicasPerPrimary | 주 복제본당 만들 복제본 수입니다. | int |
| shardCount | 프리미엄 클러스터 캐시에 만들 분할된 데이터베이스 수입니다. | int |
| sku | 배포할 Redis 캐시의 SKU입니다. | Sku (필수) |
| staticIP | 고정 IP 주소입니다. 필요에 따라 기존 Azure Virtual Network 내에 Redis 캐시를 배포할 때 지정할 수 있습니다. 기본적으로 자동으로 할당됩니다. | 문자열 제약 조건: 패턴 = ^\d+\.\d+\.\d+\.\d+$ |
| subnetId | Redis 캐시를 배포할 가상 네트워크에 있는 서브넷의 전체 리소스 ID입니다. 예제 형식: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/Microsoft. {Network,ClassicNetwork}/VirtualNetworks/vnet1/subnets/subnet1 | string 제약 조건: 패턴 = ^/subscriptions/[^/]*/resourceGroups/[^/]*/providers/Microsoft.(ClassicNetwork|Network)/virtualNetworks/[^/]*/subnets/[^/]*$ |
| tenantSettings | 테넌트 설정의 사전 | RedisCommonPropertiesTenantSettings |
| updateChannel | 선택 사항: Redis Cache에서 받을 월별 Redis 업데이트에 대한 업데이트 채널을 지정합니다. '미리 보기' 업데이트 채널을 사용하는 캐시는 '안정적인' 채널 캐시보다 최소 4주 전에 최신 Redis 업데이트를 받습니다. 기본값은 '안정'입니다. | '미리 보기' '안정' |
RedisCommonPropertiesRedisConfiguration
| Name | Description | 값 |
|---|---|---|
| aad-enabled | 캐시에 대해 AAD 기반 인증을 사용하도록 설정했는지 여부를 지정합니다. | 문자열 |
| aof-backup-enabled | aof 백업을 사용할 수 있는지 여부를 지정합니다. | 문자열 |
| aof-storage-connection-string-0 | 첫 번째 스토리지 계정 연결 문자열 | 문자열 |
| aof-storage-connection-string-1 | 두 번째 스토리지 계정 연결 문자열 | 문자열 |
| authnotrequired | 인증을 사용하지 않도록 설정할지 여부를 지정합니다. 이 속성을 설정하는 것은 보안 관점에서 매우 권장되지 않습니다. | 문자열 |
| maxfragmentationmemory-reserved | 분할당 조각화를 위해 예약된 값(메가바이트) | 문자열 |
| maxmemory-delta | 분할된 데이터베이스당 비 캐시 사용량(예: 장애 조치)을 위해 예약된 값(메가바이트)입니다. | 문자열 |
| maxmemory-policy | 데이터가 메모리 제한에 맞지 않을 때 사용되는 제거 전략입니다. | 문자열 |
| maxmemory-reserved | 분할된 데이터베이스당 비 캐시 사용량(예: 장애 조치)을 위해 예약된 값(메가바이트)입니다. | 문자열 |
| preferred-data-persistence-auth-method | 데이터 지속성에 사용되는 스토리지 계정과 통신하고, SAS 또는 ManagedIdentity를 지정하는 기본 인증 방법, 기본값은 SAS입니다. | 문자열 |
| rdb-backup-enabled | rdb 백업을 사용할 수 있는지 여부를 지정합니다. | 문자열 |
| rdb-backup-frequency | 몇 분 안에 rdb 백업을 만드는 빈도를 지정합니다. 유효한 값: (15, 30, 60, 360, 720, 1440) | 문자열 |
| rdb-backup-max-스냅샷-count | rdb 백업에 대한 최대 스냅샷 수를 지정합니다. | 문자열 |
| rdb-storage-connection-string | rdb 파일을 저장하기 위한 스토리지 계정 연결 문자열 | 문자열 |
| storage-subscription-id | ManagedIdentity를 사용하는 지속성(aof/rdb)에 대한 스토리지 계정의 SubscriptionId입니다. | 문자열 |
| {customized property} |
SKU
| Name | Description | 값 |
|---|---|---|
| 용량 | 배포할 Redis 캐시의 크기입니다. 유효한 값: C(기본/표준) 제품군(0, 1, 2, 3, 4, 5, 6), P(프리미엄) 패밀리(1, 2, 3, 4). | int(필수) |
| family | 사용할 SKU 제품군입니다. 유효한 값: (C, P). (C = 기본/표준, P = 프리미엄). | 'C' 'P'(필수) |
| name | 배포할 Redis 캐시의 유형입니다. 유효한 값: (Basic, Standard, Premium) | 'Basic' '프리미엄' 'Standard'(필수) |
RedisCommonPropertiesTenantSettings
| Name | Description | 값 |
|---|---|---|
| {customized property} | 문자열 |
빠른 시작 템플릿
다음 빠른 시작 템플릿은 이 리소스 종류를 배포합니다.
| 템플릿 | Description |
|---|---|
|
확장 가능한 Umbraco CMS 웹앱
|
이 템플릿은 Azure App Service Web Apps umbraco CMS 웹앱을 배포하는 쉬운 방법을 제공합니다. |
|
ILB ASE를 사용하여 eShop 웹 사이트
|
App Service Environment는 Azure App Service의 프리미엄 서비스 계획 옵션으로, Web Apps, Mobile Apps 및 API Apps을 포함하여 높은 확장성으로 Azure App Service 앱을 안전하게 실행하기 위해 완전히 격리된 전용 환경을 제공합니다. |
|
외부 Azure Cache for Redis 사용하여 API Management 배포
|
이 템플릿은 외부 Azure Cache for Redis instance API Management 외부 캐시로 사용하여 소비 계층에서 Azure API Management instance 만드는 방법을 보여 줍니다. |
|
템플릿을 사용하여 Redis Cache 만들기
|
이 템플릿은 스토리지 계정에 보관된 진단 데이터를 사용하여 Azure Redis Cache를 만듭니다. |
|
Microsoft Entra 인증을 사용하여 Redis Cache를 만듭니다.
|
이 템플릿은 Redis Cache를 만듭니다. 그런 다음, 기본 제공 액세스 정책을 redis 사용자에게 할당합니다. 그런 다음 사용자 지정 액세스 정책을 만듭니다. 그런 다음 다른 Redis 사용자에게 사용자 지정 액세스 정책을 할당합니다. |
|
클러스터링을 사용하여 프리미엄 Redis 캐시 만들기
|
이 템플릿은 프리미엄 Azure Redis Cache instance 클러스터링 구성하는 방법을 보여 줍니다. |
|
지속성 데이터를 사용하여 프리미엄 Redis 캐시 만들기
|
이 템플릿은 프리미엄 Azure Redis Cache instance 지속성을 구성하는 방법을 보여 줍니다. |
|
Virtual Network에 배포된 프리미엄 Redis Cache 만들기
|
이 템플릿은 프리미엄 Azure Redis Cache instance 기존 Virtual Network 배포하는 방법을 보여 줍니다. |
|
Virtual Network 두 개의 지역에서 복제된 캐시 만들기
|
이 템플릿은 두 개의 프리미엄 계층 Azure Cache for Redis 인스턴스를 별도의 Virtual Network에 배포하고 지역 복제와 연결하는 방법을 보여 줍니다. |
|
템플릿을 사용하여 웹앱 + Redis Cache + SQL DB 만들기
|
이 템플릿은 Redis 캐시 및 SQL Database 사용하여 Azure Web App을 만듭니다. |
|
템플릿을 사용하여 Redis Cache가 포함된 웹앱 만들기
|
이 템플릿은 Redis 캐시를 사용하여 Azure Web App을 만듭니다. |
Terraform(AzAPI 공급자) 리소스 정의
redis 리소스 종류는 다음을 대상으로 하는 작업을 사용하여 배포할 수 있습니다.
- 리소스 그룹
각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.
리소스 형식
Microsoft.Cache/redis 리소스를 만들려면 템플릿에 다음 Terraform을 추가합니다.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Cache/redis@2023-08-01"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
{customized property} = "string"
identity {
type = "string"
identity_ids = []
}
body = jsonencode({
properties = {
enableNonSslPort = bool
minimumTlsVersion = "string"
publicNetworkAccess = "string"
redisConfiguration = {
aad-enabled = "string"
aof-backup-enabled = "string"
aof-storage-connection-string-0 = "string"
aof-storage-connection-string-1 = "string"
authnotrequired = "string"
maxfragmentationmemory-reserved = "string"
maxmemory-delta = "string"
maxmemory-policy = "string"
maxmemory-reserved = "string"
preferred-data-persistence-auth-method = "string"
rdb-backup-enabled = "string"
rdb-backup-frequency = "string"
rdb-backup-max-snapshot-count = "string"
rdb-storage-connection-string = "string"
storage-subscription-id = "string"
}
redisVersion = "string"
replicasPerMaster = int
replicasPerPrimary = int
shardCount = int
sku = {
capacity = int
family = "string"
name = "string"
}
staticIP = "string"
subnetId = "string"
tenantSettings = {
{customized property} = "string"
}
updateChannel = "string"
}
zones = [
"string"
]
})
}
속성 값
redis
| Name | Description | 값 |
|---|---|---|
| 형식 | 리소스 종류 | "Microsoft.Cache/redis@2023-08-01" |
| name | 리소스 이름 | string(필수) 문자 제한: 1-63 유효한 문자: 영숫자 및 하이픈 영숫자로 시작하고 끝납니다. 연속 하이픈은 허용되지 않습니다. 리소스 이름은 Azure에서 고유해야 합니다. |
| 위치 | 리소스가 있는 지리적 위치 | string(필수) |
| parent_id | 리소스 그룹에 배포하려면 해당 리소스 그룹의 ID를 사용합니다. | string(필수) |
| tags | 리소스 태그. | 태그 이름 및 값의 사전입니다. |
| identity | 리소스의 ID입니다. | ManagedServiceIdentity |
| properties | Redis 캐시 속성입니다. | RedisCreatePropertiesOrRedisProperties (필수) |
| 영역 | 리소스의 원본 위치를 나타내는 가용성 영역 목록입니다. | string[] |
ManagedServiceIdentity
| Name | Description | 값 |
|---|---|---|
| 형식 | 관리 서비스 ID 유형(SystemAssigned 및 UserAssigned 형식이 모두 허용됨). | "SystemAssigned" "SystemAssigned, UserAssigned" "UserAssigned"(필수) |
| identity_ids | 리소스와 연결된 사용자 할당 ID 집합입니다. userAssignedIdentities 사전 키는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} 형식의 ARM 리소스 ID입니다. 사전 값은 요청에서 빈 개체({})일 수 있습니다. | 사용자 ID ID의 배열입니다. |
UserAssignedIdentities
| Name | Description | 값 |
|---|---|---|
| {customized property} | UserAssignedIdentity |
UserAssignedIdentity
이 개체에는 배포 중에 설정할 속성이 포함되어 있지 않습니다. 모든 속성은 ReadOnly입니다.
RedisCreatePropertiesOrRedisProperties
| Name | Description | 값 |
|---|---|---|
| enableNonSslPort | ssl이 아닌 Redis 서버 포트(6379)를 사용할지 여부를 지정합니다. | bool |
| minimumTlsVersion | 선택 사항: 클라이언트가 지정된 TLS 버전(또는 그 이상)을 사용하여 연결해야 합니다(예: '1.0', '1.1', '1.2'). | "1.0" "1.1" "1.2" |
| publicNetworkAccess | 이 캐시에 대한 퍼블릭 엔드포인트 액세스가 허용되는지 여부입니다. 값은 선택 사항이지만 전달되는 경우 '사용' 또는 '사용 안 함'이어야 합니다. 'Disabled'인 경우 프라이빗 엔드포인트는 전용 액세스 방법입니다. 기본값은 'Enabled'입니다. | "사용 안 함" "사용" |
| redisConfiguration | 모든 Redis 설정. 몇 가지 가능한 키: rdb-backup-enabled,rdb-storage-connection-string,rdb-backup-frequency,maxmemory-delta,maxmemory-policy,notify-keyspace-events,maxmemory-samples,slowlog-log-slow-than,slowlog-max-len, list-max-ziplist-entries,list-max-ziplist-value,hash-max-ziplist-entries,hash-max-ziplist-value,set-max-intset-entries,zset-max-ziplist-entries,zset-max-ziplist-value 등 | RedisCommonPropertiesRedisConfiguration |
| redisVersion | Redis 버전입니다. 이 형식은 'major[.minor]'('major'만 필요) 또는 사용할 수 있는 안정적인 최신 Redis 버전을 참조하는 'latest' 값이어야 합니다. 지원되는 버전: 4.0, 6.0(최신). 기본값은 'latest'입니다. | 문자열 |
| replicasPerMaster | 주 복제본당 만들 복제본 수입니다. | int |
| replicasPerPrimary | 주 복제본당 만들 복제본 수입니다. | int |
| shardCount | 프리미엄 클러스터 캐시에 만들 분할된 데이터베이스 수입니다. | int |
| sku | 배포할 Redis 캐시의 SKU입니다. | Sku (필수) |
| staticIP | 고정 IP 주소입니다. 필요에 따라 기존 Azure Virtual Network 내에 Redis 캐시를 배포할 때 지정할 수 있습니다. 기본적으로 자동으로 할당됩니다. | string 제약 조건: 패턴 = ^\d+\.\d+\.\d+\.\d+$ |
| subnetId | Redis 캐시를 배포할 가상 네트워크에 있는 서브넷의 전체 리소스 ID입니다. 예제 형식: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/Microsoft. {Network,ClassicNetwork}/VirtualNetworks/vnet1/subnets/subnet1 | string 제약 조건: 패턴 = ^/subscriptions/[^/]*/resourceGroups/[^/]*/providers/Microsoft.(ClassicNetwork|Network)/virtualNetworks/[^/]*/subnets/[^/]*$ |
| tenantSettings | 테넌트 설정의 사전 | RedisCommonPropertiesTenantSettings |
| updateChannel | 선택 사항: Redis Cache에서 받을 월별 Redis 업데이트에 대한 업데이트 채널을 지정합니다. '미리 보기' 업데이트 채널을 사용하는 캐시는 '안정적인' 채널 캐시보다 최소 4주 전에 최신 Redis 업데이트를 받습니다. 기본값은 '안정'입니다. | "미리 보기" "안정" |
RedisCommonPropertiesRedisConfiguration
| Name | Description | 값 |
|---|---|---|
| aad-enabled | 캐시에 대해 AAD 기반 인증을 사용하도록 설정했는지 여부를 지정합니다. | string |
| aof-backup-enabled | aof 백업을 사용할 수 있는지 여부를 지정합니다. | string |
| aof-storage-connection-string-0 | 첫 번째 스토리지 계정 연결 문자열 | 문자열 |
| aof-storage-connection-string-1 | 두 번째 스토리지 계정 연결 문자열 | 문자열 |
| authnotrequired | 인증을 사용하지 않도록 설정할지 여부를 지정합니다. 이 속성을 설정하는 것은 보안 관점에서 매우 권장되지 않습니다. | string |
| maxfragmentationmemory-reserved | 분할당 조각화를 위해 예약된 값(메가바이트) | 문자열 |
| maxmemory-delta | 분할된 데이터베이스당 비 캐시 사용량(예: 장애 조치)을 위해 예약된 값(메가바이트)입니다. | 문자열 |
| maxmemory-policy | 데이터가 메모리 제한에 맞지 않을 때 사용되는 제거 전략입니다. | 문자열 |
| maxmemory-reserved | 분할된 데이터베이스당 비 캐시 사용량(예: 장애 조치)을 위해 예약된 값(메가바이트)입니다. | 문자열 |
| preferred-data-persistence-auth-method | 데이터 지속성에 사용되는 스토리지 계정과 통신하고, SAS 또는 ManagedIdentity를 지정하는 기본 인증 방법, 기본값은 SAS입니다. | string |
| rdb-backup-enabled | rdb 백업을 사용할 수 있는지 여부를 지정합니다. | 문자열 |
| rdb-backup-frequency | 몇 분 안에 rdb 백업을 만드는 빈도를 지정합니다. 유효한 값: (15, 30, 60, 360, 720, 1440) | string |
| rdb-backup-max-스냅샷-count | rdb 백업에 대한 최대 스냅샷 수를 지정합니다. | 문자열 |
| rdb-storage-connection-string | rdb 파일을 저장하기 위한 스토리지 계정 연결 문자열 | 문자열 |
| storage-subscription-id | ManagedIdentity를 사용하는 지속성(aof/rdb)에 대한 스토리지 계정의 SubscriptionId입니다. | 문자열 |
| {customized property} |
SKU
| Name | Description | 값 |
|---|---|---|
| 용량 | 배포할 Redis 캐시의 크기입니다. 유효한 값: C(기본/표준) 제품군(0, 1, 2, 3, 4, 5, 6), P(프리미엄) 패밀리(1, 2, 3, 4). | int(필수) |
| family | 사용할 SKU 제품군입니다. 유효한 값: (C, P). (C = 기본/표준, P = 프리미엄). | "C" "P"(필수) |
| name | 배포할 Redis 캐시의 유형입니다. 유효한 값: (Basic, Standard, Premium) | "Basic" "프리미엄" "표준"(필수) |
RedisCommonPropertiesTenantSettings
| Name | Description | 값 |
|---|---|---|
| {사용자 지정 속성} | string |