다음을 통해 공유


Microsoft.Cache redis 2023-08-01

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 인증을 사용하지 않도록 설정할지 여부를 지정합니다. 이 속성을 설정하는 것은 보안 관점에서 매우 권장되지 않습니다. string
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) '기본'
'프리미엄'
'Standard'(필수)

RedisCommonPropertiesTenantSettings

Name Description
{사용자 지정 속성} 문자열

빠른 시작 템플릿

다음 빠른 시작 템플릿은 이 리소스 유형을 배포합니다.

템플릿 Description
확장 가능한 Umbraco CMS 웹앱

Azure에 배포
이 템플릿은 Azure App Service Web Apps umbraco CMS 웹앱을 쉽게 배포할 수 있는 방법을 제공합니다.
ILB ASE를 사용하여 eShop 웹 사이트

Azure에 배포
App Service Environment는 Azure App Service의 프리미엄 서비스 계획 옵션으로, Web Apps, Mobile Apps 및 API Apps을 포함하여 높은 확장성으로 Azure App Service 앱을 안전하게 실행하기 위해 완전히 격리된 전용 환경을 제공합니다.
외부 Azure Cache for Redis 사용하여 API Management 배포

Azure에 배포
이 템플릿은 외부 Azure Cache for Redis instance API Management 외부 캐시로 사용 계층에서 Azure API Management instance 만드는 방법을 보여 줍니다.
템플릿을 사용하여 Redis Cache 만들기

Azure에 배포
이 템플릿은 스토리지 계정에 보관된 진단 데이터를 사용하여 Azure Redis Cache를 만듭니다.
Microsoft Entra 인증을 사용하여 Redis Cache를 만듭니다.

Azure에 배포
이 템플릿은 Redis Cache를 만듭니다. 그런 다음, 기본 제공 액세스 정책을 redis 사용자에게 할당합니다. 그런 다음 사용자 지정 액세스 정책을 만듭니다. 그런 다음 다른 Redis 사용자에게 사용자 지정 액세스 정책을 할당합니다.
클러스터링을 사용하여 프리미엄 Redis 캐시 만들기

Azure에 배포
이 템플릿은 프리미엄 Azure Redis Cache instance 클러스터링 구성하는 방법을 보여 줍니다.
지속성 데이터를 사용하여 프리미엄 Redis 캐시 만들기

Azure에 배포
이 템플릿은 프리미엄 Azure Redis Cache instance 지속성을 구성하는 방법을 보여 줍니다.
Virtual Network에 배포된 프리미엄 Redis Cache 만들기

Azure에 배포
이 템플릿은 프리미엄 Azure Redis Cache instance 기존 Virtual Network 배포하는 방법을 보여 줍니다.
Virtual Network 두 개의 지역에서 복제된 캐시 만들기

Azure에 배포
이 템플릿은 두 개의 프리미엄 계층 Azure Cache for Redis 인스턴스를 별도의 Virtual Network에 배포하고 지역 복제와 연결하는 방법을 보여 줍니다.
템플릿을 사용하여 웹앱 + Redis Cache + SQL DB 만들기

Azure에 배포
이 템플릿은 Redis 캐시 및 SQL Database 사용하여 Azure Web App을 만듭니다.
템플릿을 사용하여 Redis Cache가 포함된 웹앱 만들기

Azure에 배포
이 템플릿은 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
{사용자 지정 속성} 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 분할당 조각화를 위해 예약된 MB의 값 문자열
maxmemory-delta 분할된 데이터베이스당 캐시가 아닌 사용량(예: 장애 조치(failover))을 위해 예약된 값(메가바이트)입니다. 문자열
maxmemory-policy 데이터가 메모리 제한에 맞지 않을 때 사용되는 제거 전략입니다. 문자열
maxmemory-reserved 분할된 데이터베이스당 캐시가 아닌 사용량(예: 장애 조치(failover))을 위해 예약된 값(메가바이트)입니다. 문자열
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입니다. 문자열
{사용자 지정 속성}

SKU

Name Description
용량 배포할 Redis 캐시의 크기입니다. 유효한 값: C(기본/표준) 제품군(0, 1, 2, 3, 4, 5, 6), P(프리미엄) 패밀리(1, 2, 3, 4). int(필수)
family 사용할 SKU 제품군입니다. 유효한 값: (C, P). (C = Basic/Standard, P = Premium). 'C'
'P'(필수)
name 배포할 Redis 캐시의 유형입니다. 유효한 값: (Basic, Standard, Premium) '기본'
'프리미엄'
'Standard'(필수)

RedisCommonPropertiesTenantSettings

Name Description
{사용자 지정 속성} 문자열

빠른 시작 템플릿

다음 빠른 시작 템플릿은 이 리소스 유형을 배포합니다.

템플릿 Description
확장 가능한 Umbraco CMS 웹앱

Azure에 배포
이 템플릿은 Azure App Service Web Apps umbraco CMS 웹앱을 쉽게 배포할 수 있는 방법을 제공합니다.
ILB ASE를 사용하여 eShop 웹 사이트

Azure에 배포
App Service Environment는 Azure App Service의 프리미엄 서비스 계획 옵션으로, Web Apps, Mobile Apps 및 API Apps을 포함하여 높은 확장성으로 Azure App Service 앱을 안전하게 실행하기 위해 완전히 격리된 전용 환경을 제공합니다.
외부 Azure Cache for Redis 사용하여 API Management 배포

Azure에 배포
이 템플릿은 외부 Azure Cache for Redis instance API Management 외부 캐시로 사용 계층에서 Azure API Management instance 만드는 방법을 보여 줍니다.
템플릿을 사용하여 Redis Cache 만들기

Azure에 배포
이 템플릿은 스토리지 계정에 보관된 진단 데이터를 사용하여 Azure Redis Cache를 만듭니다.
Microsoft Entra 인증을 사용하여 Redis Cache를 만듭니다.

Azure에 배포
이 템플릿은 Redis Cache를 만듭니다. 그런 다음, 기본 제공 액세스 정책을 redis 사용자에게 할당합니다. 그런 다음 사용자 지정 액세스 정책을 만듭니다. 그런 다음 다른 Redis 사용자에게 사용자 지정 액세스 정책을 할당합니다.
클러스터링을 사용하여 프리미엄 Redis 캐시 만들기

Azure에 배포
이 템플릿은 프리미엄 Azure Redis Cache instance 클러스터링 구성하는 방법을 보여 줍니다.
지속성 데이터를 사용하여 프리미엄 Redis 캐시 만들기

Azure에 배포
이 템플릿은 프리미엄 Azure Redis Cache instance 지속성을 구성하는 방법을 보여 줍니다.
Virtual Network에 배포된 프리미엄 Redis Cache 만들기

Azure에 배포
이 템플릿은 프리미엄 Azure Redis Cache instance 기존 Virtual Network 배포하는 방법을 보여 줍니다.
Virtual Network 두 개의 지역에서 복제된 캐시 만들기

Azure에 배포
이 템플릿은 두 개의 프리미엄 계층 Azure Cache for Redis 인스턴스를 별도의 Virtual Network에 배포하고 지역 복제와 연결하는 방법을 보여 줍니다.
템플릿을 사용하여 웹앱 + Redis Cache + SQL DB 만들기

Azure에 배포
이 템플릿은 Redis 캐시 및 SQL Database 사용하여 Azure Web App을 만듭니다.
템플릿을 사용하여 Redis Cache가 포함된 웹앱 만들기

Azure에 배포
이 템플릿은 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 분할당 조각화를 위해 예약된 MB의 값 문자열
maxmemory-delta 분할된 데이터베이스당 캐시가 아닌 사용량(예: 장애 조치(failover))을 위해 예약된 값(메가바이트)입니다. 문자열
maxmemory-policy 데이터가 메모리 제한에 맞지 않을 때 사용되는 제거 전략입니다. 문자열
maxmemory-reserved 분할된 데이터베이스당 캐시가 아닌 사용량(예: 장애 조치(failover))을 위해 예약된 값(메가바이트)입니다. 문자열
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입니다. 문자열
{사용자 지정 속성}

SKU

Name Description
용량 배포할 Redis 캐시의 크기입니다. 유효한 값: C(기본/표준) 제품군(0, 1, 2, 3, 4, 5, 6), P(프리미엄) 패밀리(1, 2, 3, 4). int(필수)
family 사용할 SKU 제품군입니다. 유효한 값: (C, P). (C = Basic/Standard, P = Premium). "C"
"P"(필수)
name 배포할 Redis 캐시의 유형입니다. 유효한 값: (Basic, Standard, Premium) "Basic"
"프리미엄"
"표준"(필수)

RedisCommonPropertiesTenantSettings

Name Description
{사용자 지정 속성} string