Microsoft.ContainerService managedClusters 2022-09-01

  • 아티클

Bicep 리소스 정의

managedClusters 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.

설명

사용 가능한 추가 기능에 대한 자세한 내용은 Azure Kubernetes Service 추가 기능, 확장 및 기타 통합을 참조하세요.

리소스 형식

Microsoft.ContainerService/managedClusters 리소스를 만들려면 템플릿에 다음 Bicep을 추가합니다.

resource symbolicname 'Microsoft.ContainerService/managedClusters@2022-09-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  sku: {
    name: 'Basic'
    tier: 'string'
  }
  extendedLocation: {
    name: 'string'
    type: 'EdgeZone'
  }
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  properties: {
    aadProfile: {
      adminGroupObjectIDs: [
        'string'
      ]
      clientAppID: 'string'
      enableAzureRBAC: bool
      managed: bool
      serverAppID: 'string'
      serverAppSecret: 'string'
      tenantID: 'string'
    }
    addonProfiles: {
      {customized property}: {
        config: {
          {customized property}: 'string'
        }
        enabled: bool
      }
    }
    agentPoolProfiles: [
      {
        availabilityZones: [
          'string'
        ]
        count: int
        creationData: {
          sourceResourceId: 'string'
        }
        enableAutoScaling: bool
        enableEncryptionAtHost: bool
        enableFIPS: bool
        enableNodePublicIP: bool
        enableUltraSSD: bool
        gpuInstanceProfile: 'string'
        hostGroupID: 'string'
        kubeletConfig: {
          allowedUnsafeSysctls: [
            'string'
          ]
          containerLogMaxFiles: int
          containerLogMaxSizeMB: int
          cpuCfsQuota: bool
          cpuCfsQuotaPeriod: 'string'
          cpuManagerPolicy: 'string'
          failSwapOn: bool
          imageGcHighThreshold: int
          imageGcLowThreshold: int
          podMaxPids: int
          topologyManagerPolicy: 'string'
        }
        kubeletDiskType: 'string'
        linuxOSConfig: {
          swapFileSizeMB: int
          sysctls: {
            fsAioMaxNr: int
            fsFileMax: int
            fsInotifyMaxUserWatches: int
            fsNrOpen: int
            kernelThreadsMax: int
            netCoreNetdevMaxBacklog: int
            netCoreOptmemMax: int
            netCoreRmemDefault: int
            netCoreRmemMax: int
            netCoreSomaxconn: int
            netCoreWmemDefault: int
            netCoreWmemMax: int
            netIpv4IpLocalPortRange: 'string'
            netIpv4NeighDefaultGcThresh1: int
            netIpv4NeighDefaultGcThresh2: int
            netIpv4NeighDefaultGcThresh3: int
            netIpv4TcpFinTimeout: int
            netIpv4TcpkeepaliveIntvl: int
            netIpv4TcpKeepaliveProbes: int
            netIpv4TcpKeepaliveTime: int
            netIpv4TcpMaxSynBacklog: int
            netIpv4TcpMaxTwBuckets: int
            netIpv4TcpTwReuse: bool
            netNetfilterNfConntrackBuckets: int
            netNetfilterNfConntrackMax: int
            vmMaxMapCount: int
            vmSwappiness: int
            vmVfsCachePressure: int
          }
          transparentHugePageDefrag: 'string'
          transparentHugePageEnabled: 'string'
        }
        maxCount: int
        maxPods: int
        minCount: int
        mode: 'string'
        name: 'string'
        nodeLabels: {
          {customized property}: 'string'
        }
        nodePublicIPPrefixID: 'string'
        nodeTaints: [
          'string'
        ]
        orchestratorVersion: 'string'
        osDiskSizeGB: int
        osDiskType: 'string'
        osSKU: 'string'
        osType: 'string'
        podSubnetID: 'string'
        powerState: {
          code: 'string'
        }
        proximityPlacementGroupID: 'string'
        scaleDownMode: 'string'
        scaleSetEvictionPolicy: 'string'
        scaleSetPriority: 'string'
        spotMaxPrice: json('decimal-as-string')
        tags: {}
        type: 'string'
        upgradeSettings: {
          maxSurge: 'string'
        }
        vmSize: 'string'
        vnetSubnetID: 'string'
        workloadRuntime: 'string'
      }
    ]
    apiServerAccessProfile: {
      authorizedIPRanges: [
        'string'
      ]
      disableRunCommand: bool
      enablePrivateCluster: bool
      enablePrivateClusterPublicFQDN: bool
      privateDNSZone: 'string'
    }
    autoScalerProfile: {
      'balance-similar-node-groups': 'string'
      expander: 'string'
      'max-empty-bulk-delete': 'string'
      'max-graceful-termination-sec': 'string'
      'max-node-provision-time': 'string'
      'max-total-unready-percentage': 'string'
      'new-pod-scale-up-delay': 'string'
      'ok-total-unready-count': 'string'
      'scale-down-delay-after-add': 'string'
      'scale-down-delay-after-delete': 'string'
      'scale-down-delay-after-failure': 'string'
      'scale-down-unneeded-time': 'string'
      'scale-down-unready-time': 'string'
      'scale-down-utilization-threshold': 'string'
      'scan-interval': 'string'
      'skip-nodes-with-local-storage': 'string'
      'skip-nodes-with-system-pods': 'string'
    }
    autoUpgradeProfile: {
      upgradeChannel: 'string'
    }
    disableLocalAccounts: bool
    diskEncryptionSetID: 'string'
    dnsPrefix: 'string'
    enablePodSecurityPolicy: bool
    enableRBAC: bool
    fqdnSubdomain: 'string'
    httpProxyConfig: {
      httpProxy: 'string'
      httpsProxy: 'string'
      noProxy: [
        'string'
      ]
      trustedCa: 'string'
    }
    identityProfile: {
      {customized property}: {
        clientId: 'string'
        objectId: 'string'
        resourceId: 'string'
      }
    }
    kubernetesVersion: 'string'
    linuxProfile: {
      adminUsername: 'string'
      ssh: {
        publicKeys: [
          {
            keyData: 'string'
          }
        ]
      }
    }
    networkProfile: {
      dnsServiceIP: 'string'
      dockerBridgeCidr: 'string'
      ipFamilies: [
        'string'
      ]
      loadBalancerProfile: {
        allocatedOutboundPorts: int
        effectiveOutboundIPs: [
          {
            id: 'string'
          }
        ]
        enableMultipleStandardLoadBalancers: bool
        idleTimeoutInMinutes: int
        managedOutboundIPs: {
          count: int
          countIPv6: int
        }
        outboundIPPrefixes: {
          publicIPPrefixes: [
            {
              id: 'string'
            }
          ]
        }
        outboundIPs: {
          publicIPs: [
            {
              id: 'string'
            }
          ]
        }
      }
      loadBalancerSku: 'string'
      natGatewayProfile: {
        effectiveOutboundIPs: [
          {
            id: 'string'
          }
        ]
        idleTimeoutInMinutes: int
        managedOutboundIPProfile: {
          count: int
        }
      }
      networkMode: 'string'
      networkPlugin: 'string'
      networkPolicy: 'string'
      outboundType: 'string'
      podCidr: 'string'
      podCidrs: [
        'string'
      ]
      serviceCidr: 'string'
      serviceCidrs: [
        'string'
      ]
    }
    nodeResourceGroup: 'string'
    oidcIssuerProfile: {
      enabled: bool
    }
    podIdentityProfile: {
      allowNetworkPluginKubenet: bool
      enabled: bool
      userAssignedIdentities: [
        {
          bindingSelector: 'string'
          identity: {
            clientId: 'string'
            objectId: 'string'
            resourceId: 'string'
          }
          name: 'string'
          namespace: 'string'
        }
      ]
      userAssignedIdentityExceptions: [
        {
          name: 'string'
          namespace: 'string'
          podLabels: {
            {customized property}: 'string'
          }
        }
      ]
    }
    privateLinkResources: [
      {
        groupId: 'string'
        id: 'string'
        name: 'string'
        requiredMembers: [
          'string'
        ]
        type: 'string'
      }
    ]
    publicNetworkAccess: 'string'
    securityProfile: {
      azureKeyVaultKms: {
        enabled: bool
        keyId: 'string'
        keyVaultNetworkAccess: 'string'
        keyVaultResourceId: 'string'
      }
      defender: {
        logAnalyticsWorkspaceResourceId: 'string'
        securityMonitoring: {
          enabled: bool
        }
      }
    }
    servicePrincipalProfile: {
      clientId: 'string'
      secret: 'string'
    }
    storageProfile: {
      blobCSIDriver: {
        enabled: bool
      }
      diskCSIDriver: {
        enabled: bool
      }
      fileCSIDriver: {
        enabled: bool
      }
      snapshotController: {
        enabled: bool
      }
    }
    windowsProfile: {
      adminPassword: 'string'
      adminUsername: 'string'
      enableCSIProxy: bool
      gmsaProfile: {
        dnsServer: 'string'
        enabled: bool
        rootDomainName: 'string'
      }
      licenseType: 'string'
    }
  }
}

속성 값

managedClusters

Name Description 값
name 리소스 이름 string(필수)

문자 제한: 1-63

유효한 문자:
영숫자, 밑줄 및 하이픈

영숫자로 시작하고 끝납니다.
위치 리소스가 있는 지리적 위치 string(필수)
tags 리소스 태그. 태그 이름 및 값의 사전입니다. 템플릿의 태그를 참조하세요.
sku 관리형 클러스터 SKU입니다. ManagedClusterSKU
extendedLocation Virtual Machine의 확장된 위치입니다. ExtendedLocation
identity 구성된 경우 관리형 클러스터의 ID입니다. ManagedClusterIdentity
properties 관리형 클러스터의 속성입니다. ManagedClusterProperties

ExtendedLocation

Name Description 값
name 확장된 위치의 이름입니다. 문자열
type 확장된 위치의 형식입니다. 'EdgeZone'

ManagedClusterIdentity

Name Description 값
형식 자세한 내용은 AKS에서 관리 ID 사용을 참조하세요. 'None'
'SystemAssigned'
'UserAssigned'
userAssignedIdentities 키는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}' 형식의 ARM 리소스 ID여야 합니다. ManagedClusterIdentityUserAssignedIdentities

ManagedClusterIdentityUserAssignedIdentities

Name Description 값
{사용자 지정 속성} ManagedServiceIdentityUserAssignedIdentitiesValue

ManagedServiceIdentityUserAssignedIdentitiesValue

이 개체에는 배포 중에 설정할 속성이 포함되어 있지 않습니다. 모든 속성은 ReadOnly입니다.

ManagedClusterProperties

Name Description 값
aadProfile Azure Active Directory 구성입니다. ManagedClusterAADProfile
addonProfiles 관리형 클러스터 추가 기능의 프로필입니다. ManagedClusterPropertiesAddonProfiles
agentPoolProfiles 에이전트 풀 속성입니다. ManagedClusterAgentPoolProfile[]
apiServerAccessProfile 관리형 클러스터 API 서버에 대한 액세스 프로필입니다. ManagedClusterAPIServerAccessProfile
autoScalerProfile 사용하도록 설정된 경우 클러스터 자동 크기 조정기에 적용할 매개 변수 ManagedClusterPropertiesAutoScalerProfile
autoUpgradeProfile 자동 업그레이드 구성입니다. ManagedClusterAutoUpgradeProfile
disableLocalAccounts true로 설정하면 이 클러스터에 대해 정적 자격 증명 가져오기가 비활성화됩니다. AAD를 사용하도록 설정된 관리형 클러스터에서만 사용해야 합니다. 자세한 내용은 로컬 계정 사용 안 함을 참조하세요. bool
diskEncryptionSetID '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/diskEncryptionSets/{encryptionSetName}' 형식입니다. string
dnsPrefix 관리형 클러스터를 만든 후에는 업데이트할 수 없습니다. string
enablePodSecurityPolicy (사용되지 않음) Kubernetes Pod 보안 정책(미리 보기)을 사용하도록 설정할지 여부입니다. 이 기능은 2020년 10월 15일에 제거하도록 설정됩니다. aka.ms/aks/azpodpolicy 자세히 알아보세요. bool
enableRBAC Kubernetes Role-Based Access Control 사용하도록 설정할지 여부입니다. bool
fqdnSubdomain 관리형 클러스터를 만든 후에는 업데이트할 수 없습니다. string
httpProxyConfig HTTP 프록시 서버를 사용하여 클러스터를 프로비전하기 위한 구성입니다. ManagedClusterHttpProxyConfig
identityProfile 클러스터와 연결된 ID입니다. ManagedClusterPropertiesIdentityProfile
kubernetesVersion 패치 버전 {major.minor.patch}(예: 1.20.13) 및 {major.minor}(예: 1.20)가 모두 지원됩니다. {major.minor}를 지정하면 지원되는 최신 GA 패치 버전이 자동으로 선택됩니다. 클러스터를 만든 후 동일한 {major.minor}(예: 1.14.x -} 1.14)로 업데이트해도 최신 패치 버전을 사용할 수 있더라도 업그레이드가 트리거되지 않습니다. 지원되는 AKS 클러스터를 업그레이드하는 경우 Kubernetes 부 버전은 건너뛸 수 없습니다. 모든 업그레이드는 주 버전 번호로 순차적으로 수행되어야 합니다. 예를 들어 1.14.x -} 1.15.x 또는 1.15.x -} 1.16.x 간의 업그레이드는 허용되지만 1.14.x -} 1.16.x는 허용되지 않습니다. 자세한 내용은 AKS 클러스터 업그레이드 를 참조하세요. string
linuxProfile 관리형 클러스터의 Linux VM에 대한 프로필입니다. ContainerServiceLinuxProfile
networkProfile 네트워크 구성 프로필입니다. ContainerServiceNetworkProfile
nodeResourceGroup 에이전트 풀 노드를 포함하는 리소스 그룹의 이름입니다. 문자열
oidcIssuerProfile 관리형 클러스터의 OIDC 발급자 프로필입니다. ManagedClusterOidcIssuerProfile
podIdentityProfile AAD Pod ID 통합에 대한 자세한 내용은 AAD Pod ID 사용을 참조하세요. ManagedClusterPodIdentityProfile
privateLinkResources 클러스터와 연결된 프라이빗 링크 리소스입니다. PrivateLinkResource[]
publicNetworkAccess AKS에 대한 공용 네트워크 액세스 허용 또는 거부 'Disabled'
'Enabled'
securityProfile 관리형 클러스터에 대한 보안 프로필입니다. ManagedClusterSecurityProfile
servicePrincipalProfile Azure API 조작에 사용할 클러스터의 서비스 주체 ID에 대한 정보입니다. ManagedClusterServicePrincipalProfile
storageProfile 관리형 클러스터에 대한 스토리지 프로필입니다. ManagedClusterStorageProfile
windowsProfile 관리형 클러스터의 Windows VM에 대한 프로필입니다. ManagedClusterWindowsProfile

ManagedClusterAADProfile

Name Description 값
adminGroupObjectIDs 클러스터의 관리자 역할이 있는 AAD 그룹 개체 ID 목록입니다. string[]
clientAppID 클라이언트 AAD 애플리케이션 ID입니다. 문자열
enableAzureRBAC Kubernetes 권한 부여에 Azure RBAC를 사용하도록 설정할지 여부입니다. bool
관리 관리되는 AAD를 사용하도록 설정할지 여부입니다. bool
serverAppID 서버 AAD 애플리케이션 ID입니다. string
serverAppSecret 서버 AAD 애플리케이션 암호입니다. 문자열
tenantID 인증에 사용할 AAD 테넌트 ID입니다. 지정하지 않으면 는 배포 구독의 테넌트 를 사용합니다. 문자열

ManagedClusterPropertiesAddonProfiles

Name Description 값
{customized property} ManagedClusterAddonProfile

ManagedClusterAddonProfile

Name Description 값
config 추가 기능을 구성하기 위한 키-값 쌍입니다. ManagedClusterAddonProfileConfig
사용 추가 기능을 사용할 수 있는지 여부입니다. bool(필수)

ManagedClusterAddonProfileConfig

Name Description 값
{customized property} 문자열

ManagedClusterAgentPoolProfile

Name Description 값
availabilityZones 노드에 사용할 가용성 영역 목록입니다. AgentPoolType 속성이 'VirtualMachineScaleSets'인 경우에만 지정할 수 있습니다. string[]
count Docker 컨테이너를 호스트할 에이전트(VM)의 수입니다. 허용되는 값은 사용자 풀의 경우 0에서 1000(포함) 범위여야 하고 시스템 풀의 경우 1~1000(포함) 범위여야 합니다. 기본값은 1입니다. int
creationData 스냅샷 사용하여 노드 풀을 만들/업그레이드할 경우 원본 스냅샷 ID를 지정하는 데 사용할 CreationData입니다. CreationData
enableAutoScaling 자동 크기 조정기를 사용하도록 설정할지 여부 bool
enableEncryptionAtHost 이는 특정 VM 크기 및 특정 Azure 지역에서만 지원됩니다. 자세한 내용은 /azure/aks/enable-host-encryption을 참조하세요. bool
enableFIPS 자세한 내용은 FIPS 사용 노드 풀 추가 를 참조하세요. bool
enableNodePublicIP 일부 시나리오에서는 노드 풀의 노드가 자체 전용 공용 IP 주소를 수신해야 할 수 있습니다. 홉을 최소화하기 위해 콘솔에서 클라우드 가상 머신에 직접 연결해야 하는 게임 워크로드가 대표적인 시나리오입니다. 자세한 내용은 노드당 공용 IP 할당을 참조하세요. 기본값은 false입니다. bool
enableUltraSSD UltraSSD를 사용하도록 설정할지 여부 bool
gpuInstanceProfile GPUInstanceProfile은 지원되는 GPU VM SKU에 대한 GPU MIG instance 프로필을 지정하는 데 사용됩니다. 'MIG1g'
'MIG2g'
'MIG3g'
'MIG4g'
'MIG7g'
hostGroupID /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}의 형식입니다. 자세한 내용은 Azure 전용 호스트를 참조하세요. 문자열
kubeletConfig 에이전트 풀 노드의 Kubelet 구성입니다. KubeletConfig
kubeletDiskType emptyDir 볼륨, 컨테이너 런타임 데이터 루트 및 Kubelet 임시 스토리지의 배치를 결정합니다. 'OS'
'임시'
linuxOSConfig Linux 에이전트 노드의 OS 구성입니다. LinuxOSConfig
maxCount 자동 크기 조정을 위한 최대 노드 수 int
maxPods 노드에서 실행할 수 있는 최대 Pod 수입니다. int
minCount 자동 크기 조정을 위한 최소 노드 수 int
mode 클러스터에는 항상 하나 이상의 '시스템' 에이전트 풀이 있어야 합니다. 에이전트 풀 제한 및 모범 사례에 대한 자세한 내용은 /azure/aks/use-system-pools를 참조하세요. '시스템'
'User'
name Windows 에이전트 풀 이름은 6자 이하여야 합니다. string(필수)

제약 조건:
패턴 = ^[a-z][a-z0-9]{0,11}$
nodeLabels 에이전트 풀의 모든 노드에서 유지할 노드 레이블입니다. ManagedClusterAgentPoolProfilePropertiesNodeLabels
nodePublicIPPrefixID /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName} 형식입니다. 문자열
nodeTaints 노드 풀 만들기 및 크기 조정 중에 새 노드에 추가된 taint입니다. 예를 들어 key=value:NoSchedule입니다. string[]
orchestratorVersion 패치 버전 {major.minor.patch}(예: 1.20.13) 및 {major.minor}(예: 1.20)가 모두 지원됩니다. {major.minor}를 지정하면 지원되는 최신 GA 패치 버전이 자동으로 선택됩니다. 클러스터를 만든 후 동일한 {major.minor}(예: 1.14.x -} 1.14)로 업데이트해도 최신 패치 버전을 사용할 수 있더라도 업그레이드가 트리거되지 않습니다. AKS 클러스터의 모든 노드 풀을 동일한 Kubernetes 버전으로 업그레이드하는 것이 가장 좋습니다. 노드 풀 버전은 컨트롤 플레인과 동일한 주 버전이어야 합니다. 노드 풀 부 버전은 컨트롤 플레인 버전의 두 가지 부 버전 내에 있어야 합니다. 노드 풀 버전은 컨트롤 플레인 버전보다 클 수 없습니다. 자세한 내용은 노드 풀 업그레이드를 참조하세요. 문자열
osDiskSizeGB OS 디스크 크기(GB)는 master/에이전트 풀의 모든 컴퓨터에 대한 디스크 크기를 지정하는 데 사용됩니다. 0을 지정하면 지정된 vmSize에 따라 기본 osDisk 크기가 적용됩니다. int

제약 조건:
최소값 = 0
최대값 = 2048
osDiskType VM이 지원되고 요청된 OSDiskSizeGB보다 큰 캐시 디스크가 있는 경우 기본값은 '임시'입니다. 그렇지 않으면 기본값은 'Managed'입니다. 만든 후에는 변경되지 않을 수 있습니다. 자세한 내용은 임시 OS를 참조하세요. '임시'
'관리'
osSKU 에이전트 풀에서 사용하는 OS SKU를 지정합니다. OSType이 Linux인 경우 기본값은 Ubuntu입니다. OSType이 Windows인 경우 Kubernetes <= 1.24 또는 Windows2022인 경우 Kubernetes >= 1.25인 경우 기본값은 Windows2019입니다. 'CBLMariner'
'Ubuntu'
'Windows2019'
'Windows2022'
osType 운영 체제 유형입니다. 기본값은 Linux입니다. 'Linux'
'Windows'
podSubnetID 생략하면 노드 서브넷에 Pod IP가 정적으로 할당됩니다(자세한 내용은 vnetSubnetID 참조). /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} 형식입니다. 문자열
powerState 에이전트 풀이 처음 만들어지면 처음에는 실행 중입니다. 이 필드를 중지됨으로 설정하여 에이전트 풀을 중지할 수 있습니다. 중지된 에이전트 풀은 모든 VM을 중지하고 청구 요금이 발생하지 않습니다. 에이전트 풀이 실행 중이고 프로비저닝 상태가 성공인 경우에만 중지할 수 있습니다. PowerState
proximityPlacementGroupID 근접 배치 그룹의 ID입니다. 문자열
scaleDownMode 클러스터 자동 크기 조정기 동작에도 영향을 줍니다. 지정하지 않으면 기본적으로 삭제로 설정됩니다. '할당 취소'
'Delete'
scaleSetEvictionPolicy scaleSetPriority가 'Spot'이 아니면 지정할 수 없습니다. 지정하지 않으면 기본값은 'Delete'입니다. '할당 취소'
'Delete'
scaleSetPriority Virtual Machine Scale Set 우선 순위입니다. 지정하지 않으면 기본값은 'Regular'입니다. 'Regular'
'Spot'
spotMaxPrice 가능한 값은 주문형 가격을 지불하려는 의지를 나타내는 0 또는 -1보다 큰 10진수 값입니다. 스폿 가격 책정에 대한 자세한 내용은 스폿 VM 가격 책정 10진수 값을 지정하려면 json() 함수 사용을 참조하세요. int 또는 json decimal
tags 에이전트 풀 가상 머신 확장 집합에 유지할 태그입니다. object
형식 에이전트 풀의 유형입니다. 'AvailabilitySet'
'VirtualMachineScaleSets'
upgradeSettings 에이전트 풀 업그레이드 설정 AgentPoolUpgradeSettings
vmSize VM 크기 가용성은 지역에 따라 다릅니다. 노드에 컴퓨팅 리소스(메모리, cpu 등)가 부족한 경우 Pod가 올바르게 실행되지 않을 수 있습니다. 제한된 VM 크기에 대한 자세한 내용은 /azure/aks/quotas-skus-regions를 참조하세요. string
vnetSubnetID 지정하지 않으면 VNET 및 서브넷이 생성되고 사용됩니다. podSubnetID를 지정하지 않으면 노드 및 Pod에 적용되고, 그렇지 않으면 노드에만 적용됩니다. /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} 형식입니다. string
workloadRuntime 노드에서 실행할 수 있는 워크로드 유형을 결정합니다. 'OCIContainer'
'WasmWasi'

CreationData

Name Description 값
sourceResourceId 대상 개체를 만드는 데 사용할 원본 개체의 ARM ID입니다. 문자열

KubeletConfig

Name Description 값
allowedUnsafeSysctls 안전하지 않은 sysctls 또는 안전하지 않은 sysctl 패턴의 허용된 목록입니다(로 끝) *. string[]
containerLogMaxFiles 컨테이너에 제공할 수 있는 컨테이너 로그 파일의 최대 수입니다. 숫자는 ≥ 2여야 합니다. int

제약 조건:
최소값 = 2
containerLogMaxSizeMB 컨테이너 로그 파일이 회전되기 전의 최대 크기(예: 10Mi)입니다. int
cpuCfsQuota 기본값은 true입니다. bool
cpuCfsQuotaPeriod 기본값은 '100ms'입니다. 유효한 값은 선택적 분수와 단위 접미사가 있는 소수 자릿수 시퀀스입니다. 예: '300ms', '2h45m'. 지원되는 단위는 'ns', 'us', 'ms', 's', 'm' 및 'h'입니다. string
cpuManagerPolicy 기본값은 'none'입니다. 자세한 내용은 Kubernetes CPU 관리 정책을 참조하세요. 허용되는 값은 'none' 및 'static'입니다. string
failSwapOn true로 설정하면 노드에서 교환을 사용하도록 설정하면 Kubelet이 시작되지 않습니다. bool
imageGcHighThreshold 이미지 가비지 수집을 사용하지 않으려면 100으로 설정합니다. 기본값은 85%입니다. int
imageGcLowThreshold imageGcHighThreshold보다 높게 설정할 수 없습니다. 기본값은 80%입니다. int
podMaxPids Pod당 최대 프로세스 수입니다. int
topologyManagerPolicy 자세한 내용은 Kubernetes 토폴로지 관리자를 참조하세요. 기본값은 'none'입니다. 허용되는 값은 'none', 'best-effort', 'restricted' 및 'single-numa-node'입니다. 문자열

LinuxOSConfig

Name Description 값
swapFileSizeMB 각 노드에서 만들 스왑 파일의 크기(MB)입니다. int
sysctls Linux 에이전트 노드에 대한 Sysctl 설정입니다. SysctlConfig
transparentHugePageDefrag 유효한 값은 'always', 'defer', 'defer+madvise', 'madvise' 및 'never'입니다. 기본값은 'madvise'입니다. 자세한 내용은 투명한 거대한 페이지를 참조하세요. string
transparentHugePageEnabled 유효한 값은 'always', 'madvise' 및 'never'입니다. 기본값은 'always'입니다. 자세한 내용은 투명한 거대한 페이지를 참조하세요. 문자열

SysctlConfig

Name Description 값
fsAioMaxNr Sysctl 설정 fs.aio-max-nr. int
fsFileMax Sysctl 설정 fs.file-max. int
fsInotifyMaxUserWatches Sysctl 설정 fs.inotify.max_user_watches. int
fsNrOpen Sysctl 설정 fs.nr_open. int
kernelThreadsMax Sysctl 설정 kernel.threads-max. int
netCoreNetdevMaxBacklog Sysctl 설정 net.core.netdev_max_backlog. int
netCoreOptmemMax Sysctl 설정 net.core.optmem_max. int
netCoreRmemDefault Sysctl 설정 net.core.rmem_default. int
netCoreRmemMax Sysctl 설정 net.core.rmem_max. int
netCoreSomaxconn sysctl 설정 net.core.somaxconn. int
netCoreWmemDefault Sysctl 설정 net.core.wmem_default. int
netCoreWmemMax Sysctl 설정 net.core.wmem_max. int
netIpv4IpLocalPortRange Sysctl 설정 net.ipv4.ip_local_port_range. 문자열
netIpv4NeighDefaultGcThresh1 Sysctl 설정 net.ipv4.neigh.default.gc_thresh1. int
netIpv4NeighDefaultGcThresh2 Sysctl 설정 net.ipv4.neigh.default.gc_thresh2. int
netIpv4NeighDefaultGcThresh3 Sysctl 설정 net.ipv4.neigh.default.gc_thresh3. int
netIpv4TcpFinTimeout Sysctl 설정 net.ipv4.tcp_fin_timeout. int
netIpv4TcpkeepaliveIntvl Sysctl 설정 net.ipv4.tcp_keepalive_intvl. int
netIpv4TcpKeepaliveProbes Sysctl 설정 net.ipv4.tcp_keepalive_probes. int
netIpv4TcpKeepaliveTime Sysctl 설정 net.ipv4.tcp_keepalive_time. int
netIpv4TcpMaxSynBacklog Sysctl 설정 net.ipv4.tcp_max_syn_backlog. int
netIpv4TcpMaxTwBuckets Sysctl 설정 net.ipv4.tcp_max_tw_buckets. int
netIpv4TcpTwReuse Sysctl 설정 net.ipv4.tcp_tw_reuse. bool
netNetfilterNfConntrackBuckets Sysctl 설정 net.netfilter.nf_conntrack_buckets. int
netNetfilterNfConntrackMax Sysctl 설정 net.netfilter.nf_conntrack_max. int
vmMaxMapCount Sysctl 설정 vm.max_map_count. int
vmSwappiness Sysctl 설정 vm.swappiness. int
vmVfsCachePressure Sysctl 설정 vm.vfs_cache_pressure. int

ManagedClusterAgentPoolProfilePropertiesNodeLabels

Name Description 값
{customized property} 문자열

PowerState

Name Description 값
코드 클러스터가 실행 중인지 또는 중지되었는지를 알려줍니다. 'Running'
'중지됨'

AgentPoolUpgradeSettings

Name Description 값
maxSurge 이 값은 정수(예: '5') 또는 백분율(예: '50%')으로 설정할 수 있습니다. 백분율을 지정하면 업그레이드 시 총 에이전트 풀 크기의 백분율입니다. 백분율의 경우 소수 노드가 반올림됩니다. 이 인수를 지정하지 않으면 기본값은 1입니다. 모범 사례를 포함한 자세한 내용은 /azure/aks/upgrade-cluster#customize-node-surge-upgrade를 참조하세요. 문자열

ManagedClusterAPIServerAccessProfile

Name Description 값
authorizedIPRanges IP 범위는 CIDR 형식(예: 137.117.106.88/29)으로 지정됩니다. 이 기능은 노드당 공용 IP를 사용하는 클러스터 또는 기본 Load Balancer 사용하는 클러스터와 호환되지 않습니다. 자세한 내용은 API 서버 권한 있는 IP 범위를 참조하세요. string[]
disableRunCommand 클러스터에 대한 실행 명령을 사용하지 않도록 설정할지 여부입니다. bool
enablePrivateCluster 자세한 내용은 프라이빗 AKS 클러스터 만들기를 참조하세요. bool
enablePrivateClusterPublicFQDN 프라이빗 클러스터에 대한 추가 공용 FQDN을 만들지 여부입니다. bool
privateDNSZone 기본값은 시스템입니다. 자세한 내용은 프라이빗 DNS 영역 구성을 참조하세요. 허용되는 값은 'system' 및 'none'입니다. 문자열

ManagedClusterPropertiesAutoScalerProfile

Name Description 값
balance-similar-node-groups 유효한 값은 'true' 및 'false'입니다. string
확장기 지정하지 않으면 기본값은 'random'입니다. 자세한 내용은 확장기를 참조하세요. '최소 폐기물'
'가장 많은 포드'
'priority'
'random'
max-empty-bulk-delete 기본값은 10입니다. 문자열
max-graceful-termination-sec 기본값은 600입니다. 문자열
max-node-provision-time 기본값은 '15m'입니다. 값은 정수이고 그 뒤에 'm'이어야 합니다. 분(m) 이외의 시간 단위는 지원되지 않습니다. 문자열
max-total-unready-percentage 기본값은 45입니다. 최대값은 100이고 최소값은 0입니다. 문자열
new-pod-scale-up-delay Kubernetes 스케줄러가 모든 Pod를 예약하기 전에 CA가 작동하지 않도록 하려는 버스트/일괄 처리 규모와 같은 시나리오의 경우, 어느 정도 시간이 지나기 전에 예약되지 않은 Pod를 CA가 무시하도록 지시할 수 있습니다. 기본값은 '0s'입니다. 값은 정수 뒤에 단위(초, 분 'm', 시간별 'h' 등)여야 합니다. 문자열
ok-total-unready-count 정수여야 합니다. 기본값은 3입니다. 문자열
scale-down-delay-after-add 기본값은 '10m'입니다. 값은 정수이고 그 뒤에 'm'이어야 합니다. 분(m) 이외의 시간 단위는 지원되지 않습니다. 문자열
scale-down-delay-after-delete 기본값은 스캔 간격입니다. 값은 정수 뒤에 'm'이어야 합니다. 분(m) 이외의 시간 단위는 지원되지 않습니다. 문자열
scale-down-delay-after-failure 기본값은 '3m'입니다. 값은 정수 뒤에 'm'이어야 합니다. 분(m) 이외의 시간 단위는 지원되지 않습니다. 문자열
scale-down-unneeded-time 기본값은 '10m'입니다. 값은 정수 뒤에 'm'이어야 합니다. 분(m) 이외의 시간 단위는 지원되지 않습니다. 문자열
scale-down-unready-time 기본값은 '20m'입니다. 값은 정수 뒤에 'm'이어야 합니다. 분(m) 이외의 시간 단위는 지원되지 않습니다. 문자열
scale-down-utilization-threshold 기본값은 '0.5'입니다. 문자열
scan-interval 기본값은 '10'입니다. 값은 정수 초여야 합니다. 문자열
skip-nodes-with-local-storage 기본값은 true입니다. string
skip-nodes-with-system-pods 기본값은 true입니다. 문자열

ManagedClusterAutoUpgradeProfile

Name Description 값
upgradeChannel 자세한 내용은 AKS 클러스터 자동 업그레이드 채널 설정을 참조하세요. 'node-image'
'none'
'patch'
'rapid'
'안정'

ManagedClusterHttpProxyConfig

Name Description 값
httpProxy 사용할 HTTP 프록시 서버 엔드포인트입니다. 문자열
httpsProxy 사용할 HTTPS 프록시 서버 엔드포인트입니다. 문자열
noProxy 프록시를 통과해서는 안 되는 엔드포인트입니다. string[]
trustedCa 프록시 서버에 연결하는 데 사용할 대체 CA 인증서입니다. 문자열

ManagedClusterPropertiesIdentityProfile

Name Description 값
{사용자 지정 속성} UserAssignedIdentity

UserAssignedIdentity

Name Description 값
clientId 사용자 할당 ID의 클라이언트 ID입니다. 문자열
objectId 사용자 할당 ID의 개체 ID입니다. 문자열
resourceId 사용자 할당 ID의 리소스 ID입니다. string

ContainerServiceLinuxProfile

Name Description 값
adminUsername Linux VM에 사용할 관리자 사용자 이름입니다. string(필수)

제약 조건:
패턴 = ^[A-Za-z][-A-Za-z0-9_]*$
ssh Azure에서 실행되는 Linux 기반 VM에 대한 SSH 구성입니다. ContainerServiceSshConfiguration (필수)

ContainerServiceSshConfiguration

Name Description 값
publicKeys Linux 기반 VM으로 인증하는 데 사용되는 SSH 공개 키 목록입니다. 최대 1키를 지정할 수 있습니다. ContainerServiceSshPublicKey[] (필수)

ContainerServiceSshPublicKey

Name Description 값
keyData SSH를 통해 VM으로 인증하는 데 사용되는 인증서 공개 키입니다. 인증서는 헤더를 사용하거나 사용하지 않는 PEM 형식이어야 합니다. string(필수)

ContainerServiceNetworkProfile

Name Description 값
dnsServiceIP Kubernetes DNS 서비스에 할당된 IP 주소입니다. serviceCidr에 지정된 Kubernetes 서비스 주소 범위 내에 있어야 합니다. 문자열

제약 조건:
패턴 = ^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$
dockerBridgeCidr Docker 브리지 네트워크에 할당된 CIDR 표기법 IP 범위입니다. 서브넷 IP 범위 또는 Kubernetes 서비스 주소 범위와 겹치지 않아야 합니다. string

제약 조건:
패턴 = ^([0-9]{1,3}\.){3}[0-9]{1,3}(\/([0-9]|[1-2][0-9]|3[0-2]))?$
ipFamilies IP 패밀리는 단일 스택 또는 이중 스택 클러스터를 결정하는 데 사용됩니다. 단일 스택의 경우 예상 값은 IPv4입니다. 이중 스택의 경우 예상 값은 IPv4 및 IPv6입니다. 다음 중 어느 것을 포함하는 문자열 배열:
'IPv4'
'IPv6'
loadBalancerProfile 클러스터 부하 분산 장치의 프로필입니다. ManagedClusterLoadBalancerProfile
loadBalancerSku 기본값은 '표준'입니다. 부하 분산 장치 SKU 간의 차이점에 대한 자세한 내용은 Azure Load Balancer SKU를 참조하세요. 'basic'
'standard'
natGatewayProfile 클러스터 NAT 게이트웨이의 프로필입니다. ManagedClusterNATGatewayProfile
networkMode networkPlugin이 'azure' 이외의 항목인 경우 지정할 수 없습니다. '브리지'
'투명'
networkPlugin Kubernetes 네트워크를 빌드하는 데 사용되는 네트워크 플러그 인입니다. 'azure'
'kubenet'
'none'
networkPolicy Kubernetes 네트워크를 빌드하는 데 사용되는 네트워크 정책입니다. 'azure'
'calico'
outboundType 클러스터를 만들 때만 설정할 수 있으며 나중에 변경할 수 없습니다. 자세한 내용은 송신 아웃바운드 형식을 참조하세요. 'loadBalancer'
'managedNATGateway'
'userAssignedNATGateway'
'userDefinedRouting'
podCidr kubenet이 사용되는 경우 Pod IP를 할당하는 CIDR 표기법 IP 범위입니다. 문자열

제약 조건:
패턴 = ^([0-9]{1,3}\.){3}[0-9]{1,3}(\/([0-9]|[1-2][0-9]|3[0-2]))?$
podCidrs 단일 스택 네트워킹에는 하나의 IPv4 CIDR이 필요합니다. 이중 스택 네트워킹에는 각 IP 패밀리(IPv4/IPv6)에 대해 하나씩 두 개의 CIDR이 필요합니다. string[]
serviceCidr 서비스 클러스터 IP를 할당하는 CIDR 표기법 IP 범위입니다. 서브넷 IP 범위와 겹치지 않아야 합니다. 문자열

제약 조건:
패턴 = ^([0-9]{1,3}\.){3}[0-9]{1,3}(\/([0-9]|[1-2][0-9]|3[0-2]))?$
serviceCidrs 단일 스택 네트워킹에는 하나의 IPv4 CIDR이 필요합니다. 이중 스택 네트워킹에는 각 IP 패밀리(IPv4/IPv6)에 대해 하나씩 두 개의 CIDR이 필요합니다. 서브넷 IP 범위와 겹쳐서는 안 됩니다. string[]

ManagedClusterLoadBalancerProfile

Name Description 값
allocatedOutboundPorts VM당 할당된 SNAT 포트의 원하는 수입니다. 허용되는 값은 0에서 64000(포함) 범위입니다. 기본값은 0으로, Azure에서 포트를 동적으로 할당합니다. int

제약 조건:
최소값 = 0
최대값 = 64000
effectiveOutboundIPs 클러스터 부하 분산 장치의 효과적인 아웃바운드 IP 리소스입니다. ResourceReference[]
enableMultipleStandardLoadBalancers AKS 클러스터당 여러 표준 부하 분산 장치를 사용하도록 설정합니다. bool
idleTimeoutInMinutes 원하는 아웃바운드 흐름 유휴 시간 제한(분)입니다. 허용되는 값은 4~120(포함) 범위에 있습니다. 기본값은 30분입니다. int

제약 조건:
최소값 = 4
최대값 = 120
managedOutboundIPs 클러스터 부하 분산 장치에 대해 원하는 관리형 아웃바운드 IP입니다. ManagedClusterLoadBalancerProfileManagedOutboundIPs
outboundIPPrefixes 클러스터 부하 분산 장치에 대한 원하는 아웃바운드 IP 접두사 리소스입니다. ManagedClusterLoadBalancerProfileOutboundIPPrefixes
outboundIPs 클러스터 부하 분산 장치에 필요한 아웃바운드 IP 리소스입니다. ManagedClusterLoadBalancerProfileOutboundIPs

ResourceReference

Name Description 값
id 정규화된 Azure 리소스 ID입니다. string

ManagedClusterLoadBalancerProfileManagedOutboundIPs

Name Description 값
count 클러스터 부하 분산 장치에 대해 Azure에서 생성/관리하는 원하는 IPv4 아웃바운드 IP 수입니다. 허용되는 값은 1에서 100(포함) 범위여야 합니다. 기본값은 1입니다. int

제약 조건:
최소값 = 1
최대값 = 100
countIPv6 클러스터 부하 분산 장치에 대해 Azure에서 생성/관리하는 원하는 IPv6 아웃바운드 IP 수입니다. 허용되는 값은 1에서 100(포함) 범위여야 합니다. 기본값은 단일 스택의 경우 0이고 이중 스택의 경우 1입니다. int

제약 조건:
최소값 = 0
최대값 = 100

ManagedClusterLoadBalancerProfileOutboundIPPrefixes

Name Description 값
publicIPPrefixes 공용 IP 접두사 리소스 목록입니다. ResourceReference[]

ManagedClusterLoadBalancerProfileOutboundIPs

Name Description 값
publicIPs 공용 IP 리소스 목록입니다. ResourceReference[]

ManagedClusterNATGatewayProfile

Name Description 값
effectiveOutboundIPs 클러스터 NAT 게이트웨이의 효과적인 아웃바운드 IP 리소스입니다. ResourceReference[]
idleTimeoutInMinutes 원하는 아웃바운드 흐름 유휴 시간 제한(분)입니다. 허용되는 값은 4~120(포함) 범위에 있습니다. 기본값은 4분입니다. int

제약 조건:
최소값 = 4
최대값 = 120
managedOutboundIPProfile 클러스터 NAT 게이트웨이의 관리되는 아웃바운드 IP 리소스 프로필입니다. ManagedClusterManagedOutboundIPProfile

ManagedClusterManagedOutboundIPProfile

Name Description 값
count Azure에서 생성/관리하는 원하는 아웃바운드 IP 수입니다. 허용되는 값은 1에서 16(포함) 범위여야 합니다. 기본값은 1입니다. int

제약 조건:
최소값 = 1
최대값 = 16

ManagedClusterOidcIssuerProfile

Name Description 값
사용 OIDC 발급자를 사용할 수 있는지 여부입니다. bool

ManagedClusterPodIdentityProfile

Name Description 값
allowNetworkPluginKubenet Kubenet에서 실행은 기본적으로 AAD Pod ID의 보안 관련 특성 및 IP 스푸핑의 위험으로 인해 사용하지 않도록 설정됩니다. 자세한 내용은 AAD Pod ID와 함께 Kubenet 네트워크 플러그 인 사용을 참조하세요 . bool
사용 Pod ID 추가 기능을 사용할 수 있는지 여부입니다. bool
userAssignedIdentities 클러스터에서 사용할 Pod ID입니다. ManagedClusterPodIdentity[]
userAssignedIdentityExceptions 허용할 Pod ID 예외입니다. ManagedClusterPodIdentityException[]

ManagedClusterPodIdentity

Name Description 값
bindingSelector AzureIdentityBinding 리소스에 사용할 바인딩 선택기입니다. string
identity 사용자가 할당한 ID 세부 정보입니다. UserAssignedIdentity (필수)
name Pod ID의 이름입니다. string(필수)
namespace Pod ID의 네임스페이스입니다. string(필수)

ManagedClusterPodIdentityException

Name Description 값
name Pod ID 예외의 이름입니다. string(필수)
namespace Pod ID 예외의 네임스페이스입니다. string(필수)
podLabels 일치시킬 Pod 레이블입니다. ManagedClusterPodIdentityExceptionPodLabels (필수)

ManagedClusterPodIdentityExceptionPodLabels

Name Description 값
{customized property} string

PrivateLinkResource

Name Description 값
groupId 리소스의 그룹 ID입니다. 문자열
id 프라이빗 링크 리소스의 ID입니다. 문자열
name 프라이빗 링크 리소스의 이름입니다. string
requiredMembers 리소스의 RequiredMembers string[]
형식 리소스 종류입니다. string

ManagedClusterSecurityProfile

Name Description 값
azureKeyVaultKms 보안 프로필에 대한 Azure Key Vault 키 관리 서비스 설정입니다. AzureKeyVaultKms
defender 보안 프로필에 대한 설정을 Microsoft Defender. ManagedClusterSecurityProfileDefender

AzureKeyVaultKms

Name Description 값
사용 Azure Key Vault 키 관리 서비스를 사용하도록 설정할지 여부입니다. 기본값은 false입니다. bool
keyId Azure Key Vault 키의 식별자입니다. 자세한 내용은 키 식별자 형식 을 참조하세요. Azure Key Vault 키 관리 서비스를 사용하도록 설정하면 이 필드가 필요하며 유효한 키 식별자여야 합니다. Azure Key Vault 키 관리 서비스를 사용하지 않도록 설정하면 필드를 비워 둡니다. string
keyVaultNetworkAccess 키 자격 증명 모음의 네트워크 액세스. 가능한 값은 Public 및 Private입니다. Public 는 키 자격 증명 모음이 모든 네트워크에서 공용 액세스를 허용한다는 것을 의미합니다. Private 는 키 자격 증명 모음이 공용 액세스를 사용하지 않도록 설정하고 프라이빗 링크를 사용하도록 설정함을 의미합니다. 기본값은 Public입니다. 'Private'
'Public'
keyVaultResourceId 키 자격 증명 모음의 리소스 ID입니다. keyVaultNetworkAccess가 인 경우 Private이 필드는 필수이며 유효한 리소스 ID여야 합니다. keyVaultNetworkAccess가 이면 Public필드를 비워 둡니다. string

ManagedClusterSecurityProfileDefender

Name Description 값
logAnalyticsWorkspaceResourceId Microsoft Defender 연결할 Log Analytics 작업 영역의 리소스 ID입니다. Microsoft Defender 사용하도록 설정되면 이 필드가 필요하며 유효한 작업 영역 리소스 ID여야 합니다. Microsoft Defender 사용하지 않도록 설정되면 필드를 비워 둡니다. 문자열
securityMonitoring 보안 프로필에 대한 클라우드 설정에 대한 위협 탐지를 Microsoft Defender. ManagedClusterSecurityProfileDefenderSecurityMonitor...

ManagedClusterSecurityProfileDefenderSecurityMonitor...

Name Description 값
사용 Defender 위협 탐지를 사용하도록 설정할지 여부 bool

ManagedClusterServicePrincipalProfile

Name Description 값
clientId 서비스 주체의 ID입니다. string(필수)
secret 일반 텍스트로 서비스 주체와 연결된 비밀 암호입니다. 문자열

ManagedClusterStorageProfile

Name Description 값
blobCSIDriver 스토리지 프로필에 대한 AzureBlob CSI 드라이버 설정입니다. ManagedClusterStorageProfileBlobCSIDriver
diskCSIDriver 스토리지 프로필에 대한 AzureDisk CSI 드라이버 설정입니다. ManagedClusterStorageProfileDiskCSIDriver
fileCSIDriver 스토리지 프로필에 대한 AzureFile CSI 드라이버 설정입니다. ManagedClusterStorageProfileFileCSIDriver
snapshotController 스토리지 프로필에 대한 스냅샷 컨트롤러 설정입니다. ManagedClusterStorageProfileSnapshotController

ManagedClusterStorageProfileBlobCSIDriver

Name Description 값
사용 AzureBlob CSI 드라이버를 사용하도록 설정할지 여부입니다. 기본값은 false입니다. bool

ManagedClusterStorageProfileDiskCSIDriver

Name Description 값
사용 AzureDisk CSI 드라이버를 사용하도록 설정할지 여부입니다. 기본값은 true입니다. bool

ManagedClusterStorageProfileFileCSIDriver

Name Description 값
사용 AzureFile CSI 드라이버를 사용하도록 설정할지 여부입니다. 기본값은 true입니다. bool

ManagedClusterStorageProfileSnapshotController

Name Description 값
사용 스냅샷 컨트롤러를 사용하도록 설정할지 여부입니다. 기본값은 true입니다. bool

ManagedClusterWindowsProfile

Name Description 값
adminPassword 관리자 계정의 암호를 지정합니다.

최소 길이: 8자

최대 길이: 123자

복잡성 요구 사항: 아래의 4개 조건 중 3개는 충족해야 합니다.
문자가 낮습니다.
대문자 포함
숫자 가 있습니다.
특수 문자가 있습니다(Regex 일치 [\W_])

허용되지 않는 값: "abc@123", "P@$$w 0rd", "P@ssw0rd", "P@ssword123", "Pa$$word", "pass@word1", "Password!", "Password1", "Password22", "iloveyou!"		 string
adminUsername 관리자 계정의 이름을 지정합니다.

제한: ""로 끝날 수 없습니다.

허용되지 않는 값: "administrator", "admin", "user", "user1", "test", "user2", "test1", "user3", "admin1", "1", "123", "a", "actuser", "adm", "admin2", "aspnet", "backup", "console", "david", "guest", "john", "owner", "root", "server", "sql", "support", "support_388945a0", "sys", "test2", "test3", "user4", "user5".

최소 길이: 1자

최대 길이: 20자		 string(필수)
enableCSIProxy CSI 프록시에 대한 자세한 내용은 CSI 프록시 GitHub 리포지토리를 참조하세요. bool
gmsaProfile 관리형 클러스터의 Windows gMSA 프로필입니다. WindowsGmsaProfile
licenseType Windows VM에 사용할 라이선스 유형입니다. 자세한 내용은 Azure 하이브리드 사용자 혜택을 참조하세요. 'None'
'Windows_Server'

WindowsGmsaProfile

Name Description 값
dnsServer Windows gMSA에 대한 DNS 서버를 지정합니다.

관리형 클러스터를 만드는 데 사용되는 VNet에서 DNS 서버를 구성한 경우 이 서버를 빈 상태로 설정합니다.		 string
사용 관리형 클러스터에서 Windows gMSA를 사용하도록 설정할지 여부를 지정합니다. bool
rootDomainName Windows gMSA의 루트 도메인 이름을 지정합니다.

관리형 클러스터를 만드는 데 사용되는 VNet에서 DNS 서버를 구성한 경우 이 서버를 빈 상태로 설정합니다.		 string

ManagedClusterSKU

Name Description 값
name 관리형 클러스터 SKU의 이름입니다. 'Basic'
계층 지정하지 않으면 기본값은 'Free'입니다. 자세한 내용은 작동 시간 SLA 를 참조하세요. '무료'
'유료'

빠른 시작 템플릿

다음 빠른 시작 템플릿은 이 리소스 종류를 배포합니다.

템플릿 Description
AKS(Azure Container Service)에서 Jenkins를 사용하는 CI/CD

Azure에 배포		 컨테이너를 사용하면 애플리케이션을 지속적으로 빌드하고 배포할 수 있습니다. Azure Container Service에서 Kubernetes를 사용하여 해당 컨테이너의 배포를 오케스트레이션하면 복제 가능하고 관리 가능한 컨테이너 클러스터를 달성할 수 있습니다. 컨테이너 이미지 및 오케스트레이션을 생성하도록 연속 빌드를 설정하면 배포의 속도와 안정성을 높일 수 있습니다.
Azure Gateway min.io

Azure에 배포		 Blob Storage에서 지원되는 S3 규격 스토리지 API를 제공하기 위한 완전 프라이빗 min.io Azure Gateway 배포
NAT 게이트웨이 및 Application Gateway 사용하는 AKS 클러스터

Azure에 배포		 이 샘플에서는 아웃바운드 연결을 위한 NAT Gateway 및 인바운드 연결에 대한 Application Gateway 사용하여 AKS 클러스터를 배포하는 방법을 보여 줍니다.
프라이빗 AKS 클러스터 만들기

Azure에 배포		 이 샘플에서는 jumpbox 가상 머신과 함께 가상 네트워크에 프라이빗 AKS 클러스터를 만드는 방법을 보여 줍니다.
공용 DNS 영역을 사용하여 프라이빗 AKS 클러스터 만들기

Azure에 배포		 이 샘플에서는 공용 DNS 영역을 사용하여 프라이빗 AKS 클러스터를 배포하는 방법을 보여 줍니다.
AKS(관리되는 Kubernetes 클러스터) 배포

Azure에 배포		 이 ARM 템플릿은 고급 네트워킹 기능이 있는 AKS instance 기존 가상 네트워크에 배포하는 방법을 보여 줍니다. 또한 선택한 서비스 주체에는 AKS 클러스터가 포함된 서브넷에 대해 네트워크 기여자 역할이 할당됩니다.
AAD(AKS)를 사용하여 관리되는 Kubernetes 클러스터 배포

Azure에 배포		 이 ARM 템플릿은 고급 네트워킹 기능이 있는 AKS instance 기존 가상 네트워크 및 Azure AD 정수로 배포하는 방법을 보여 줍니다. 또한 선택한 서비스 주체에는 AKS 클러스터가 포함된 서브넷에 대해 네트워크 기여자 역할이 할당됩니다.
Azure ML용 AKS 클러스터 배포

Azure에 배포		 이 템플릿을 사용하면 Azure ML에 연결할 수 있는 엔트레프라이즈 규격 AKS 클러스터를 배포할 수 있습니다.
Azure Container Service(AKS)

Azure에 배포		 AKS(Azure Container Service)를 사용하여 관리형 클러스터 배포
Azure Container Service(AKS)

Azure에 배포		 Azure Linux 컨테이너 호스트를 사용하여 AKS(Azure Container Service)를 사용하여 관리형 클러스터 배포
Helm을 사용하는 AKS(Azure Container Service)

Azure에 배포		 Helm을 사용하여 AKS(Azure Container Service)를 사용하여 관리형 클러스터 배포
AKS(Azure Kubernetes Service)

Azure에 배포		 AKS(Azure Kubernetes Service)를 통해 관리되는 Kubernetes 클러스터 배포
Application Gateway 수신 컨트롤러를 사용하는 AKS 클러스터

Azure에 배포		 이 샘플에서는 Application Gateway, Application Gateway 수신 컨트롤러, Azure Container Registry, Log Analytics 및 Key Vault 사용하여 AKS 클러스터를 배포하는 방법을 보여 줍니다.

ARM 템플릿 리소스 정의

managedClusters 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.

설명

사용 가능한 추가 기능에 대한 자세한 내용은 Azure Kubernetes Service 추가 기능, 확장 및 기타 통합을 참조하세요.

리소스 형식

Microsoft.ContainerService/managedClusters 리소스를 만들려면 템플릿에 다음 JSON을 추가합니다.

{
  "type": "Microsoft.ContainerService/managedClusters",
  "apiVersion": "2022-09-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "sku": {
    "name": "Basic",
    "tier": "string"
  },
  "extendedLocation": {
    "name": "string",
    "type": "EdgeZone"
  },
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {}
    }
  },
  "properties": {
    "aadProfile": {
      "adminGroupObjectIDs": [ "string" ],
      "clientAppID": "string",
      "enableAzureRBAC": "bool",
      "managed": "bool",
      "serverAppID": "string",
      "serverAppSecret": "string",
      "tenantID": "string"
    },
    "addonProfiles": {
      "{customized property}": {
        "config": {
          "{customized property}": "string"
        },
        "enabled": "bool"
      }
    },
    "agentPoolProfiles": [
      {
        "availabilityZones": [ "string" ],
        "count": "int",
        "creationData": {
          "sourceResourceId": "string"
        },
        "enableAutoScaling": "bool",
        "enableEncryptionAtHost": "bool",
        "enableFIPS": "bool",
        "enableNodePublicIP": "bool",
        "enableUltraSSD": "bool",
        "gpuInstanceProfile": "string",
        "hostGroupID": "string",
        "kubeletConfig": {
          "allowedUnsafeSysctls": [ "string" ],
          "containerLogMaxFiles": "int",
          "containerLogMaxSizeMB": "int",
          "cpuCfsQuota": "bool",
          "cpuCfsQuotaPeriod": "string",
          "cpuManagerPolicy": "string",
          "failSwapOn": "bool",
          "imageGcHighThreshold": "int",
          "imageGcLowThreshold": "int",
          "podMaxPids": "int",
          "topologyManagerPolicy": "string"
        },
        "kubeletDiskType": "string",
        "linuxOSConfig": {
          "swapFileSizeMB": "int",
          "sysctls": {
            "fsAioMaxNr": "int",
            "fsFileMax": "int",
            "fsInotifyMaxUserWatches": "int",
            "fsNrOpen": "int",
            "kernelThreadsMax": "int",
            "netCoreNetdevMaxBacklog": "int",
            "netCoreOptmemMax": "int",
            "netCoreRmemDefault": "int",
            "netCoreRmemMax": "int",
            "netCoreSomaxconn": "int",
            "netCoreWmemDefault": "int",
            "netCoreWmemMax": "int",
            "netIpv4IpLocalPortRange": "string",
            "netIpv4NeighDefaultGcThresh1": "int",
            "netIpv4NeighDefaultGcThresh2": "int",
            "netIpv4NeighDefaultGcThresh3": "int",
            "netIpv4TcpFinTimeout": "int",
            "netIpv4TcpkeepaliveIntvl": "int",
            "netIpv4TcpKeepaliveProbes": "int",
            "netIpv4TcpKeepaliveTime": "int",
            "netIpv4TcpMaxSynBacklog": "int",
            "netIpv4TcpMaxTwBuckets": "int",
            "netIpv4TcpTwReuse": "bool",
            "netNetfilterNfConntrackBuckets": "int",
            "netNetfilterNfConntrackMax": "int",
            "vmMaxMapCount": "int",
            "vmSwappiness": "int",
            "vmVfsCachePressure": "int"
          },
          "transparentHugePageDefrag": "string",
          "transparentHugePageEnabled": "string"
        },
        "maxCount": "int",
        "maxPods": "int",
        "minCount": "int",
        "mode": "string",
        "name": "string",
        "nodeLabels": {
          "{customized property}": "string"
        },
        "nodePublicIPPrefixID": "string",
        "nodeTaints": [ "string" ],
        "orchestratorVersion": "string",
        "osDiskSizeGB": "int",
        "osDiskType": "string",
        "osSKU": "string",
        "osType": "string",
        "podSubnetID": "string",
        "powerState": {
          "code": "string"
        },
        "proximityPlacementGroupID": "string",
        "scaleDownMode": "string",
        "scaleSetEvictionPolicy": "string",
        "scaleSetPriority": "string",
        "spotMaxPrice": "[json('decimal-as-string')]",
        "tags": {},
        "type": "string",
        "upgradeSettings": {
          "maxSurge": "string"
        },
        "vmSize": "string",
        "vnetSubnetID": "string",
        "workloadRuntime": "string"
      }
    ],
    "apiServerAccessProfile": {
      "authorizedIPRanges": [ "string" ],
      "disableRunCommand": "bool",
      "enablePrivateCluster": "bool",
      "enablePrivateClusterPublicFQDN": "bool",
      "privateDNSZone": "string"
    },
    "autoScalerProfile": {
      "balance-similar-node-groups": "string",
      "expander": "string",
      "max-empty-bulk-delete": "string",
      "max-graceful-termination-sec": "string",
      "max-node-provision-time": "string",
      "max-total-unready-percentage": "string",
      "new-pod-scale-up-delay": "string",
      "ok-total-unready-count": "string",
      "scale-down-delay-after-add": "string",
      "scale-down-delay-after-delete": "string",
      "scale-down-delay-after-failure": "string",
      "scale-down-unneeded-time": "string",
      "scale-down-unready-time": "string",
      "scale-down-utilization-threshold": "string",
      "scan-interval": "string",
      "skip-nodes-with-local-storage": "string",
      "skip-nodes-with-system-pods": "string"
    },
    "autoUpgradeProfile": {
      "upgradeChannel": "string"
    },
    "disableLocalAccounts": "bool",
    "diskEncryptionSetID": "string",
    "dnsPrefix": "string",
    "enablePodSecurityPolicy": "bool",
    "enableRBAC": "bool",
    "fqdnSubdomain": "string",
    "httpProxyConfig": {
      "httpProxy": "string",
      "httpsProxy": "string",
      "noProxy": [ "string" ],
      "trustedCa": "string"
    },
    "identityProfile": {
      "{customized property}": {
        "clientId": "string",
        "objectId": "string",
        "resourceId": "string"
      }
    },
    "kubernetesVersion": "string",
    "linuxProfile": {
      "adminUsername": "string",
      "ssh": {
        "publicKeys": [
          {
            "keyData": "string"
          }
        ]
      }
    },
    "networkProfile": {
      "dnsServiceIP": "string",
      "dockerBridgeCidr": "string",
      "ipFamilies": [ "string" ],
      "loadBalancerProfile": {
        "allocatedOutboundPorts": "int",
        "effectiveOutboundIPs": [
          {
            "id": "string"
          }
        ],
        "enableMultipleStandardLoadBalancers": "bool",
        "idleTimeoutInMinutes": "int",
        "managedOutboundIPs": {
          "count": "int",
          "countIPv6": "int"
        },
        "outboundIPPrefixes": {
          "publicIPPrefixes": [
            {
              "id": "string"
            }
          ]
        },
        "outboundIPs": {
          "publicIPs": [
            {
              "id": "string"
            }
          ]
        }
      },
      "loadBalancerSku": "string",
      "natGatewayProfile": {
        "effectiveOutboundIPs": [
          {
            "id": "string"
          }
        ],
        "idleTimeoutInMinutes": "int",
        "managedOutboundIPProfile": {
          "count": "int"
        }
      },
      "networkMode": "string",
      "networkPlugin": "string",
      "networkPolicy": "string",
      "outboundType": "string",
      "podCidr": "string",
      "podCidrs": [ "string" ],
      "serviceCidr": "string",
      "serviceCidrs": [ "string" ]
    },
    "nodeResourceGroup": "string",
    "oidcIssuerProfile": {
      "enabled": "bool"
    },
    "podIdentityProfile": {
      "allowNetworkPluginKubenet": "bool",
      "enabled": "bool",
      "userAssignedIdentities": [
        {
          "bindingSelector": "string",
          "identity": {
            "clientId": "string",
            "objectId": "string",
            "resourceId": "string"
          },
          "name": "string",
          "namespace": "string"
        }
      ],
      "userAssignedIdentityExceptions": [
        {
          "name": "string",
          "namespace": "string",
          "podLabels": {
            "{customized property}": "string"
          }
        }
      ]
    },
    "privateLinkResources": [
      {
        "groupId": "string",
        "id": "string",
        "name": "string",
        "requiredMembers": [ "string" ],
        "type": "string"
      }
    ],
    "publicNetworkAccess": "string",
    "securityProfile": {
      "azureKeyVaultKms": {
        "enabled": "bool",
        "keyId": "string",
        "keyVaultNetworkAccess": "string",
        "keyVaultResourceId": "string"
      },
      "defender": {
        "logAnalyticsWorkspaceResourceId": "string",
        "securityMonitoring": {
          "enabled": "bool"
        }
      }
    },
    "servicePrincipalProfile": {
      "clientId": "string",
      "secret": "string"
    },
    "storageProfile": {
      "blobCSIDriver": {
        "enabled": "bool"
      },
      "diskCSIDriver": {
        "enabled": "bool"
      },
      "fileCSIDriver": {
        "enabled": "bool"
      },
      "snapshotController": {
        "enabled": "bool"
      }
    },
    "windowsProfile": {
      "adminPassword": "string",
      "adminUsername": "string",
      "enableCSIProxy": "bool",
      "gmsaProfile": {
        "dnsServer": "string",
        "enabled": "bool",
        "rootDomainName": "string"
      },
      "licenseType": "string"
    }
  }
}

속성 값

managedClusters

Name Description 값
형식 리소스 종류 'Microsoft.ContainerService/managedClusters'
apiVersion 리소스 api 버전 '2022-09-01'
name 리소스 이름 string(필수)

문자 제한: 1-63

유효한 문자:
영숫자, 밑줄 및 하이픈

영숫자로 시작하고 끝납니다.
위치 리소스가 있는 지리적 위치 string(필수)
tags 리소스 태그. 태그 이름 및 값의 사전입니다. 템플릿의 태그를 참조하세요.
sku 관리형 클러스터 SKU입니다. ManagedClusterSKU
extendedLocation Virtual Machine의 확장된 위치입니다. ExtendedLocation
identity 구성된 경우 관리형 클러스터의 ID입니다. ManagedClusterIdentity
properties 관리형 클러스터의 속성입니다. ManagedClusterProperties

ExtendedLocation

Name Description 값
name 확장된 위치의 이름입니다. 문자열
type 확장된 위치의 형식입니다. 'EdgeZone'

ManagedClusterIdentity

Name Description 값
형식 자세한 내용은 AKS에서 관리 ID 사용을 참조하세요. 'None'
'SystemAssigned'
'UserAssigned'
userAssignedIdentities 키는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}' 형식의 ARM 리소스 ID여야 합니다. ManagedClusterIdentityUserAssignedIdentities

ManagedClusterIdentityUserAssignedIdentities

Name Description 값
{사용자 지정 속성} ManagedServiceIdentityUserAssignedIdentitiesValue

ManagedServiceIdentityUserAssignedIdentitiesValue

이 개체에는 배포 중에 설정할 속성이 포함되어 있지 않습니다. 모든 속성은 ReadOnly입니다.

ManagedClusterProperties

Name Description 값
aadProfile Azure Active Directory 구성입니다. ManagedClusterAADProfile
addonProfiles 관리형 클러스터 추가 기능의 프로필입니다. ManagedClusterPropertiesAddonProfiles
agentPoolProfiles 에이전트 풀 속성입니다. ManagedClusterAgentPoolProfile[]
apiServerAccessProfile 관리형 클러스터 API 서버에 대한 액세스 프로필입니다. ManagedClusterAPIServerAccessProfile
autoScalerProfile 사용하도록 설정된 경우 클러스터 자동 크기 조정기에 적용할 매개 변수 ManagedClusterPropertiesAutoScalerProfile
autoUpgradeProfile 자동 업그레이드 구성입니다. ManagedClusterAutoUpgradeProfile
disableLocalAccounts true로 설정하면 이 클러스터에 대해 정적 자격 증명 가져오기가 비활성화됩니다. AAD를 사용하도록 설정된 관리형 클러스터에서만 사용해야 합니다. 자세한 내용은 로컬 계정 사용 안 함을 참조하세요. bool
diskEncryptionSetID '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/diskEncryptionSets/{encryptionSetName}' 형식입니다. string
dnsPrefix 관리형 클러스터를 만든 후에는 업데이트할 수 없습니다. 문자열
enablePodSecurityPolicy (사용되지 않음) Kubernetes Pod 보안 정책(미리 보기)을 사용하도록 설정할지 여부입니다. 이 기능은 2020년 10월 15일에 제거하도록 설정됩니다. aka.ms/aks/azpodpolicy 자세히 알아보세요. bool
enableRBAC Kubernetes Role-Based Access Control 사용하도록 설정할지 여부입니다. bool
fqdnSubdomain 관리형 클러스터를 만든 후에는 업데이트할 수 없습니다. string
httpProxyConfig HTTP 프록시 서버를 사용하여 클러스터를 프로비전하기 위한 구성입니다. ManagedClusterHttpProxyConfig
identityProfile 클러스터와 연결된 ID입니다. ManagedClusterPropertiesIdentityProfile
kubernetesVersion 패치 버전 {major.minor.patch}(예: 1.20.13) 및 {major.minor}(예: 1.20)가 모두 지원됩니다. {major.minor}를 지정하면 지원되는 최신 GA 패치 버전이 자동으로 선택됩니다. 클러스터를 만든 후 동일한 {major.minor}(예: 1.14.x -} 1.14)로 업데이트해도 최신 패치 버전을 사용할 수 있더라도 업그레이드가 트리거되지 않습니다. 지원되는 AKS 클러스터를 업그레이드하는 경우 Kubernetes 부 버전은 건너뛸 수 없습니다. 모든 업그레이드는 주 버전 번호로 순차적으로 수행되어야 합니다. 예를 들어 1.14.x -} 1.15.x 또는 1.15.x -} 1.16.x 간의 업그레이드는 허용되지만 1.14.x -} 1.16.x는 허용되지 않습니다. 자세한 내용은 AKS 클러스터 업그레이드 를 참조하세요. 문자열
linuxProfile 관리형 클러스터의 Linux VM에 대한 프로필입니다. ContainerServiceLinuxProfile
networkProfile 네트워크 구성 프로필입니다. ContainerServiceNetworkProfile
nodeResourceGroup 에이전트 풀 노드를 포함하는 리소스 그룹의 이름입니다. string
oidcIssuerProfile 관리형 클러스터의 OIDC 발급자 프로필입니다. ManagedClusterOidcIssuerProfile
podIdentityProfile AAD Pod ID 통합에 대한 자세한 내용은 AAD Pod ID 사용을 참조하세요. ManagedClusterPodIdentityProfile
privateLinkResources 클러스터와 연결된 프라이빗 링크 리소스입니다. PrivateLinkResource[]
publicNetworkAccess AKS에 대한 공용 네트워크 액세스 허용 또는 거부 '사용 안 함'
'사용'
securityProfile 관리형 클러스터에 대한 보안 프로필입니다. ManagedClusterSecurityProfile
servicePrincipalProfile Azure API 조작에 사용할 클러스터의 서비스 주체 ID에 대한 정보입니다. ManagedClusterServicePrincipalProfile
storageProfile 관리형 클러스터에 대한 스토리지 프로필입니다. ManagedClusterStorageProfile
windowsProfile 관리형 클러스터의 Windows VM에 대한 프로필입니다. ManagedClusterWindowsProfile

ManagedClusterAADProfile

Name Description 값
adminGroupObjectIDs 클러스터의 관리자 역할이 있는 AAD 그룹 개체 ID 목록입니다. string[]
clientAppID 클라이언트 AAD 애플리케이션 ID입니다. string
enableAzureRBAC Kubernetes 권한 부여에 Azure RBAC를 사용하도록 설정할지 여부입니다. bool
관리 관리되는 AAD를 사용하도록 설정할지 여부입니다. bool
serverAppID 서버 AAD 애플리케이션 ID입니다. string
serverAppSecret 서버 AAD 애플리케이션 암호입니다. 문자열
tenantID 인증에 사용할 AAD 테넌트 ID입니다. 지정하지 않으면 는 배포 구독의 테넌트 를 사용합니다. 문자열

ManagedClusterPropertiesAddonProfiles

Name Description 값
{사용자 지정 속성} ManagedClusterAddonProfile

ManagedClusterAddonProfile

Name Description 값
config 추가 기능을 구성하기 위한 키-값 쌍입니다. ManagedClusterAddonProfileConfig
사용 추가 기능을 사용할 수 있는지 여부입니다. bool(필수)

ManagedClusterAddonProfileConfig

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

ManagedClusterAgentPoolProfile

Name Description 값
availabilityZones 노드에 사용할 가용성 영역 목록입니다. AgentPoolType 속성이 'VirtualMachineScaleSets'인 경우에만 지정할 수 있습니다. string[]
count Docker 컨테이너를 호스트할 에이전트(VM)의 수입니다. 허용되는 값은 사용자 풀의 경우 0~1000(포함) 범위이고 시스템 풀의 경우 1~1000(포함) 범위여야 합니다. 기본값은 1입니다. int
creationData createData는 노드 풀이 스냅샷 사용하여 생성/업그레이드될 경우 원본 스냅샷 ID를 지정하는 데 사용됩니다. CreationData
enableAutoScaling 자동 크기 조정기를 사용하도록 설정할지 여부 bool
enableEncryptionAtHost 이는 특정 VM 크기 및 특정 Azure 지역에서만 지원됩니다. 자세한 내용은 /azure/aks/enable-host-encryption을 참조하세요. bool
enableFIPS 자세한 내용은 FIPS 사용 노드 풀 추가 를 참조하세요. bool
enableNodePublicIP 일부 시나리오에서는 노드 풀의 노드가 고유한 전용 공용 IP 주소를 수신해야 할 수 있습니다. 홉을 최소화하기 위해 콘솔에서 클라우드 가상 머신에 직접 연결해야 하는 게임 워크로드가 대표적인 시나리오입니다. 자세한 내용은 노드당 공용 IP 할당을 참조하세요. 기본값은 false입니다. bool
enableUltraSSD UltraSSD를 사용하도록 설정할지 여부 bool
gpuInstanceProfile GPUInstanceProfile은 지원되는 GPU VM SKU에 대한 GPU MIG instance 프로필을 지정하는 데 사용됩니다. 'MIG1g'
'MIG2g'
'MIG3g'
'MIG4g'
'MIG7g'
hostGroupID /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}의 형식입니다. 자세한 내용은 Azure 전용 호스트를 참조하세요. string
kubeletConfig 에이전트 풀 노드의 Kubelet 구성입니다. KubeletConfig
kubeletDiskType emptyDir 볼륨, 컨테이너 런타임 데이터 루트 및 Kubelet 임시 스토리지의 배치를 결정합니다. 'OS'
'임시'
linuxOSConfig Linux 에이전트 노드의 OS 구성입니다. LinuxOSConfig
maxCount 자동 크기 조정을 위한 최대 노드 수 int
maxPods 노드에서 실행할 수 있는 최대 Pod 수입니다. int
minCount 자동 크기 조정을 위한 최소 노드 수 int
mode 클러스터에는 항상 하나 이상의 '시스템' 에이전트 풀이 있어야 합니다. 에이전트 풀 제한 및 모범 사례에 대한 자세한 내용은 /azure/aks/use-system-pools를 참조하세요. '시스템'
'User'
name Windows 에이전트 풀 이름은 6자 이하여야 합니다. string(필수)

제약 조건:
패턴 = ^[a-z][a-z0-9]{0,11}$
nodeLabels 에이전트 풀의 모든 노드에서 유지할 노드 레이블입니다. ManagedClusterAgentPoolProfilePropertiesNodeLabels
nodePublicIPPrefixID /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName} 형식입니다. string
nodeTaints 노드 풀 만들기 및 크기 조정 중에 새 노드에 추가된 taint입니다. 예를 들어 key=value:NoSchedule입니다. string[]
orchestratorVersion 패치 버전 {major.minor.patch}(예: 1.20.13) 및 {major.minor}(예: 1.20)가 모두 지원됩니다. {major.minor}를 지정하면 지원되는 최신 GA 패치 버전이 자동으로 선택됩니다. 클러스터를 만든 후 동일한 {major.minor}(예: 1.14.x -} 1.14)로 업데이트해도 최신 패치 버전을 사용할 수 있더라도 업그레이드가 트리거되지 않습니다. AKS 클러스터의 모든 노드 풀을 동일한 Kubernetes 버전으로 업그레이드하는 것이 가장 좋습니다. 노드 풀 버전은 컨트롤 플레인과 동일한 주 버전이어야 합니다. 노드 풀 부 버전은 컨트롤 플레인 버전의 두 가지 부 버전 내에 있어야 합니다. 노드 풀 버전은 컨트롤 플레인 버전보다 클 수 없습니다. 자세한 내용은 노드 풀 업그레이드를 참조하세요. 문자열
osDiskSizeGB MASTER/에이전트 풀의 모든 컴퓨터에 대한 디스크 크기를 지정하는 데 사용할 OS 디스크 크기(GB)입니다. 0을 지정하면 지정된 vmSize에 따라 기본 osDisk 크기가 적용됩니다. int

제약 조건:
최소값 = 0
최대값 = 2048
osDiskType VM이 지원하며 요청된 OSDiskSizeGB보다 큰 캐시 디스크가 있는 경우 기본값은 'Ephemeral'입니다. 그렇지 않으면 기본값은 '관리'입니다. 만든 후에는 변경되지 않을 수 있습니다. 자세한 내용은 임시 OS를 참조하세요. '임시'
'관리'
osSKU 에이전트 풀에서 사용하는 OS SKU를 지정합니다. OSType이 Linux인 경우 기본값은 Ubuntu입니다. OSType이 Windows인 경우 Kubernetes <= 1.24 또는 Windows2022인 경우 Kubernetes >= 1.25인 경우 기본값은 Windows2019입니다. 'CBLMariner'
'Ubuntu'
'Windows2019'
'Windows2022'
osType 운영 체제 유형입니다. 기본값은 Linux입니다. 'Linux'
'Windows'
podSubnetID 생략하면 노드 서브넷에 Pod IP가 정적으로 할당됩니다(자세한 내용은 vnetSubnetID 참조). /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} 형식입니다. 문자열
powerState 에이전트 풀이 처음 만들어지면 처음에는 실행 중입니다. 이 필드를 중지됨으로 설정하여 에이전트 풀을 중지할 수 있습니다. 중지된 에이전트 풀은 모든 VM을 중지하고 청구 요금이 발생하지 않습니다. 에이전트 풀이 실행 중이고 프로비저닝 상태가 성공인 경우에만 중지할 수 있습니다. PowerState
proximityPlacementGroupID 근접 배치 그룹의 ID입니다. string
scaleDownMode 클러스터 자동 크기 조정기 동작에도 영향을 줍니다. 지정하지 않으면 기본적으로 삭제로 설정됩니다. '할당 취소'
'Delete'
scaleSetEvictionPolicy scaleSetPriority가 'Spot'이 아니면 지정할 수 없습니다. 지정하지 않으면 기본값은 'Delete'입니다. '할당 취소'
'Delete'
scaleSetPriority Virtual Machine Scale Set 우선 순위입니다. 지정하지 않으면 기본값은 'Regular'입니다. 'Regular'
'Spot'
spotMaxPrice 가능한 값은 주문형 가격을 지불하려는 의지를 나타내는 0 또는 -1보다 큰 10진수 값입니다. 스폿 가격 책정에 대한 자세한 내용은 스폿 VM 가격 책정 10진수 값을 지정하려면 json() 함수 사용을 참조하세요. int 또는 json decimal
tags 에이전트 풀 가상 머신 확장 집합에 유지할 태그입니다. object
형식 에이전트 풀의 유형입니다. 'AvailabilitySet'
'VirtualMachineScaleSets'
upgradeSettings 에이전트 풀 업그레이드 설정 AgentPoolUpgradeSettings
vmSize VM 크기 가용성은 지역에 따라 다릅니다. 노드에 컴퓨팅 리소스(메모리, cpu 등)가 부족한 경우 Pod가 올바르게 실행되지 않을 수 있습니다. 제한된 VM 크기에 대한 자세한 내용은 /azure/aks/quotas-skus-regions를 참조하세요. 문자열
vnetSubnetID 지정하지 않으면 VNET 및 서브넷이 생성되고 사용됩니다. podSubnetID를 지정하지 않으면 노드 및 Pod에 적용되고, 그렇지 않으면 노드에만 적용됩니다. /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} 형식입니다. 문자열
workloadRuntime 노드에서 실행할 수 있는 워크로드 유형을 결정합니다. 'OCIContainer'
'WasmWasi'

CreationData

Name Description 값
sourceResourceId 대상 개체를 만드는 데 사용할 원본 개체의 ARM ID입니다. 문자열

KubeletConfig

Name Description 값
allowedUnsafeSysctls 안전하지 않은 sysctls 또는 안전하지 않은 sysctl 패턴의 허용된 목록입니다(로 끝) *. string[]
containerLogMaxFiles 컨테이너에 제공할 수 있는 컨테이너 로그 파일의 최대 수입니다. 숫자는 ≥ 2여야 합니다. int

제약 조건:
최소값 = 2
containerLogMaxSizeMB 컨테이너 로그 파일이 회전되기 전의 최대 크기(예: 10Mi)입니다. int
cpuCfsQuota 기본값은 true입니다. bool
cpuCfsQuotaPeriod 기본값은 '100ms'입니다. 유효한 값은 선택적 소수점과 단위 접미사가 있는 10진수 시퀀스입니다. 예: '300ms', '2h45m'. 지원되는 단위는 'ns', 'us', 'ms', 's', 'm', 'h'입니다. string
cpuManagerPolicy 기본값은 'none'입니다. 자세한 내용은 Kubernetes CPU 관리 정책을 참조하세요. 허용되는 값은 'none' 및 'static'입니다. string
failSwapOn true로 설정하면 노드에서 교환을 사용하도록 설정하면 Kubelet이 시작되지 않습니다. bool
imageGcHighThreshold 이미지 가비지 수집을 사용하지 않으려면 100으로 설정합니다. 기본값은 85%입니다. int
imageGcLowThreshold imageGcHighThreshold보다 높게 설정할 수 없습니다. 기본값은 80%입니다. int
podMaxPids Pod당 최대 프로세스 수입니다. int
topologyManagerPolicy 자세한 내용은 Kubernetes 토폴로지 관리자를 참조하세요. 기본값은 'none'입니다. 허용되는 값은 'none', 'best-effort', 'restricted', 'single-numa-node'입니다. string

LinuxOSConfig

Name Description 값
swapFileSizeMB 각 노드에서 만들 스왑 파일의 크기(MB)입니다. int
sysctls Linux 에이전트 노드에 대한 Sysctl 설정입니다. SysctlConfig
transparentHugePageDefrag 유효한 값은 'always', 'defer', 'defer+madvise', 'madvise' 및 'never'입니다. 기본값은 'madvise'입니다. 자세한 내용은 투명한 거대한 페이지를 참조하세요. string
transparentHugePageEnabled 유효한 값은 'always', 'madvise', 'never'입니다. 기본값은 'always'입니다. 자세한 내용은 투명한 거대한 페이지를 참조하세요. string

SysctlConfig

Name Description 값
fsAioMaxNr Sysctl 설정 fs.aio-max-nr. int
fsFileMax Sysctl 설정 fs.file-max. int
fsInotifyMaxUserWatches Sysctl 설정 fs.inotify.max_user_watches. int
fsNrOpen Sysctl 설정 fs.nr_open. int
kernelThreadsMax Sysctl 설정 kernel.threads-max. int
netCoreNetdevMaxBacklog Sysctl 설정 net.core.netdev_max_backlog. int
netCoreOptmemMax Sysctl 설정 net.core.optmem_max. int
netCoreRmemDefault Sysctl 설정 net.core.rmem_default. int
netCoreRmemMax Sysctl 설정 net.core.rmem_max. int
netCoreSomaxconn sysctl 설정 net.core.somaxconn. int
netCoreWmemDefault Sysctl 설정 net.core.wmem_default. int
netCoreWmemMax Sysctl 설정 net.core.wmem_max. int
netIpv4IpLocalPortRange Sysctl 설정 net.ipv4.ip_local_port_range. 문자열
netIpv4NeighDefaultGcThresh1 Sysctl 설정 net.ipv4.neigh.default.gc_thresh1. int
netIpv4NeighDefaultGcThresh2 Sysctl 설정 net.ipv4.neigh.default.gc_thresh2. int
netIpv4NeighDefaultGcThresh3 Sysctl 설정 net.ipv4.neigh.default.gc_thresh3. int
netIpv4TcpFinTimeout Sysctl 설정 net.ipv4.tcp_fin_timeout. int
netIpv4TcpkeepaliveIntvl Sysctl 설정 net.ipv4.tcp_keepalive_intvl. int
netIpv4TcpKeepaliveProbes Sysctl 설정 net.ipv4.tcp_keepalive_probes. int
netIpv4TcpKeepaliveTime Sysctl 설정 net.ipv4.tcp_keepalive_time. int
netIpv4TcpMaxSynBacklog Sysctl 설정 net.ipv4.tcp_max_syn_backlog. int
netIpv4TcpMaxTwBuckets Sysctl 설정 net.ipv4.tcp_max_tw_buckets. int
netIpv4TcpTwReuse Sysctl 설정 net.ipv4.tcp_tw_reuse. bool
netNetfilterNfConntrackBuckets Sysctl 설정 net.netfilter.nf_conntrack_buckets. int
netNetfilterNfConntrackMax Sysctl 설정 net.netfilter.nf_conntrack_max. int
vmMaxMapCount Sysctl 설정 vm.max_map_count. int
vmSwappiness Sysctl 설정 vm.swappiness. int
vmVfsCachePressure Sysctl 설정 vm.vfs_cache_pressure. int

ManagedClusterAgentPoolProfilePropertiesNodeLabels

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

PowerState

Name Description 값
코드 클러스터가 실행 중인지 또는 중지되었는지를 알려줍니다. '실행 중'
'중지됨'

AgentPoolUpgradeSettings

Name Description 값
maxSurge 정수(예: '5') 또는 백분율(예: '50%')으로 설정할 수 있습니다. 백분율을 지정하면 업그레이드 시 총 에이전트 풀 크기의 백분율입니다. 백분율의 경우 소수 노드가 반올림됩니다. 이 인수를 지정하지 않으면 기본값은 1입니다. 모범 사례를 포함한 자세한 내용은 다음을 참조하세요. /azure/aks/upgrade-cluster#customize-node-surge-upgrade 문자열

ManagedClusterAPIServerAccessProfile

Name Description 값
authorizedIPRanges IP 범위는 CIDR 형식으로 지정됩니다(예: 137.117.106.88/29). 이 기능은 노드당 공용 IP를 사용하는 클러스터 또는 기본 Load Balancer 사용하는 클러스터와 호환되지 않습니다. 자세한 내용은 API 서버 권한 있는 IP 범위를 참조하세요. string[]
disableRunCommand 클러스터에 대한 실행 명령을 사용하지 않도록 설정할지 여부입니다. bool
enablePrivateCluster 자세한 내용은 프라이빗 AKS 클러스터 만들기를 참조하세요. bool
enablePrivateClusterPublicFQDN 프라이빗 클러스터에 대한 추가 공용 FQDN을 만들지 여부를 지정합니다. bool
privateDNSZone 기본값은 시스템입니다. 자세한 내용은 프라이빗 DNS 영역 구성을 참조하세요. 허용되는 값은 'system' 및 'none'입니다. 문자열

ManagedClusterPropertiesAutoScalerProfile

Name Description 값
balance-similar-node-groups 유효한 값은 'true'와 'false'입니다. 문자열
확장기 지정하지 않으면 기본값은 'random'입니다. 자세한 내용은 확장기를 참조하세요. '최소 폐기물'
'대부분의 포드'
'priority'
'random'
max-empty-bulk-delete 기본값은 10입니다. string
max-graceful-termination-sec 기본값은 600입니다. 문자열
max-node-provision-time 기본값은 '15m'입니다. 값은 정수 뒤에 'm'이어야 합니다. 분(m) 이외의 시간 단위는 지원되지 않습니다. 문자열
max-total-unready-percentage 기본값은 45입니다. 최대값은 100이고 최소값은 0입니다. 문자열
new-pod-scale-up-delay Kubernetes 스케줄러가 모든 Pod를 예약하기 전에 CA가 작동하지 않도록 하려는 버스트/일괄 처리 규모와 같은 시나리오의 경우, 어느 정도 시간이 지나기 전에 예약되지 않은 Pod를 CA가 무시하도록 지시할 수 있습니다. 기본값은 '0s'입니다. 값은 정수와 단위(초의 경우', 분은 'm', 시간 단위는 'h' 등)여야 합니다. 문자열
ok-total-unready-count 정수여야 합니다. 기본값은 3입니다. string
scale-down-delay-after-add 기본값은 '10m'입니다. 값은 정수 뒤에 'm'이어야 합니다. 분(m) 이외의 시간 단위는 지원되지 않습니다. 문자열
scale-down-delay-after-delete 기본값은 스캔 간격입니다. 값은 정수 뒤에 'm'이어야 합니다. 분(m) 이외의 시간 단위는 지원되지 않습니다. 문자열
scale-down-delay-after-failure 기본값은 '3m'입니다. 값은 정수 뒤에 'm'이어야 합니다. 분(m) 이외의 시간 단위는 지원되지 않습니다. 문자열
scale-down-unneeded-time 기본값은 '10m'입니다. 값은 정수 뒤에 'm'이어야 합니다. 분(m) 이외의 시간 단위는 지원되지 않습니다. 문자열
scale-down-unready-time 기본값은 '20m'입니다. 값은 정수 뒤에 'm'이어야 합니다. 분(m) 이외의 시간 단위는 지원되지 않습니다. 문자열
scale-down-utilization-threshold 기본값은 '0.5'입니다. 문자열
scan-interval 기본값은 '10'입니다. 값은 정수 초여야 합니다. string
skip-nodes-with-local-storage 기본값은 true입니다. 문자열
skip-nodes-with-system-pods 기본값은 true입니다. 문자열

ManagedClusterAutoUpgradeProfile

Name Description 값
upgradeChannel 자세한 내용은 AKS 클러스터 자동 업그레이드 채널 설정을 참조하세요. 'node-image'
'none'
'patch'
'rapid'
'안정'

ManagedClusterHttpProxyConfig

Name Description 값
httpProxy 사용할 HTTP 프록시 서버 엔드포인트입니다. 문자열
httpsProxy 사용할 HTTPS 프록시 서버 엔드포인트입니다. 문자열
noProxy 프록시를 통과해서는 안 되는 엔드포인트입니다. string[]
trustedCa 프록시 서버에 연결하는 데 사용할 대체 CA 인증서입니다. 문자열

ManagedClusterPropertiesIdentityProfile

Name Description 값
{사용자 지정 속성} UserAssignedIdentity

UserAssignedIdentity

Name Description 값
clientId 사용자 할당 ID의 클라이언트 ID입니다. 문자열
objectId 사용자 할당 ID의 개체 ID입니다. string
resourceId 사용자 할당 ID의 리소스 ID입니다. string

ContainerServiceLinuxProfile

Name Description 값
adminUsername Linux VM에 사용할 관리자 사용자 이름입니다. string(필수)

제약 조건:
패턴 = ^[A-Za-z][-A-Za-z0-9_]*$
ssh Azure에서 실행되는 Linux 기반 VM에 대한 SSH 구성입니다. ContainerServiceSshConfiguration (필수)

ContainerServiceSshConfiguration

Name Description 값
publicKeys Linux 기반 VM으로 인증하는 데 사용되는 SSH 공개 키 목록입니다. 최대 1키를 지정할 수 있습니다. ContainerServiceSshPublicKey[] (필수)

ContainerServiceSshPublicKey

Name Description 값
keyData SSH를 통해 VM으로 인증하는 데 사용되는 인증서 공개 키입니다. 인증서는 헤더를 사용하거나 사용하지 않는 PEM 형식이어야 합니다. string(필수)

ContainerServiceNetworkProfile

Name Description 값
dnsServiceIP Kubernetes DNS 서비스에 할당된 IP 주소입니다. serviceCidr에 지정된 Kubernetes 서비스 주소 범위 내에 있어야 합니다. 문자열

제약 조건:
패턴 = ^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$
dockerBridgeCidr Docker 브리지 네트워크에 할당된 CIDR 표기법 IP 범위입니다. 서브넷 IP 범위 또는 Kubernetes 서비스 주소 범위와 겹치지 않아야 합니다. string

제약 조건:
패턴 = ^([0-9]{1,3}\.){3}[0-9]{1,3}(\/([0-9]|[1-2][0-9]|3[0-2]))?$
ipFamilies IP 패밀리는 단일 스택 또는 이중 스택 클러스터를 결정하는 데 사용됩니다. 단일 스택의 경우 예상 값은 IPv4입니다. 이중 스택의 경우 예상 값은 IPv4 및 IPv6입니다. 다음 중 어느 것을 포함하는 문자열 배열:
'IPv4'
'IPv6'
loadBalancerProfile 클러스터 부하 분산 장치의 프로필입니다. ManagedClusterLoadBalancerProfile
loadBalancerSku 기본값은 '표준'입니다. 부하 분산 장치 SKU 간의 차이점에 대한 자세한 내용은 Azure Load Balancer SKU를 참조하세요. 'basic'
'standard'
natGatewayProfile 클러스터 NAT 게이트웨이의 프로필입니다. ManagedClusterNATGatewayProfile
networkMode networkPlugin이 'azure' 이외의 항목인 경우 지정할 수 없습니다. '브리지'
'투명'
networkPlugin Kubernetes 네트워크를 빌드하는 데 사용되는 네트워크 플러그 인입니다. 'azure'
'kubenet'
'none'
networkPolicy Kubernetes 네트워크를 빌드하는 데 사용되는 네트워크 정책입니다. 'azure'
'calico'
outboundType 클러스터를 만들 때만 설정할 수 있으며 나중에 변경할 수 없습니다. 자세한 내용은 송신 아웃바운드 형식을 참조하세요. 'loadBalancer'
'managedNATGateway'
'userAssignedNATGateway'
'userDefinedRouting'
podCidr kubenet이 사용되는 경우 Pod IP를 할당하는 CIDR 표기법 IP 범위입니다. 문자열

제약 조건:
패턴 = ^([0-9]{1,3}\.){3}[0-9]{1,3}(\/([0-9]|[1-2][0-9]|3[0-2]))?$
podCidrs 단일 스택 네트워킹에는 하나의 IPv4 CIDR이 필요합니다. 이중 스택 네트워킹에는 각 IP 패밀리(IPv4/IPv6)에 대해 하나씩 두 개의 CIDR이 필요합니다. string[]
serviceCidr 서비스 클러스터 IP를 할당하는 CIDR 표기법 IP 범위입니다. 서브넷 IP 범위와 겹치지 않아야 합니다. string

제약 조건:
패턴 = ^([0-9]{1,3}\.){3}[0-9]{1,3}(\/([0-9]|[1-2][0-9]|3[0-2]))?$
serviceCidrs 단일 스택 네트워킹에는 하나의 IPv4 CIDR이 필요합니다. 이중 스택 네트워킹에는 각 IP 패밀리(IPv4/IPv6)에 대해 하나씩 두 개의 CIDR이 필요합니다. 서브넷 IP 범위와 겹쳐서는 안 됩니다. string[]

ManagedClusterLoadBalancerProfile

Name Description 값
allocatedOutboundPorts VM당 할당된 SNAT 포트의 원하는 수입니다. 허용되는 값은 0에서 64000(포함) 범위입니다. 기본값은 0으로, Azure에서 포트를 동적으로 할당합니다. int

제약 조건:
최소값 = 0
최대값 = 64000
effectiveOutboundIPs 클러스터 부하 분산 장치의 효과적인 아웃바운드 IP 리소스입니다. ResourceReference[]
enableMultipleStandardLoadBalancers AKS 클러스터당 여러 표준 부하 분산 장치를 사용하도록 설정합니다. bool
idleTimeoutInMinutes 원하는 아웃바운드 흐름 유휴 시간 제한(분)입니다. 허용되는 값은 4~120(포함) 범위에 있습니다. 기본값은 30분입니다. int

제약 조건:
최소값 = 4
최대값 = 120
managedOutboundIPs 클러스터 부하 분산 장치에 대해 원하는 관리형 아웃바운드 IP입니다. ManagedClusterLoadBalancerProfileManagedOutboundIPs
outboundIPPrefixes 클러스터 부하 분산 장치에 대한 원하는 아웃바운드 IP 접두사 리소스입니다. ManagedClusterLoadBalancerProfileOutboundIPPrefixes
아웃바운드 IP 클러스터 부하 분산 장치에 대해 원하는 아웃바운드 IP 리소스입니다. ManagedClusterLoadBalancerProfileOutboundIPs

ResourceReference

Name Description 값
id 정규화된 Azure 리소스 ID입니다. 문자열

ManagedClusterLoadBalancerProfileManagedOutboundIPs

Name Description 값
count 클러스터 부하 분산 장치에 대해 Azure에서 생성/관리하는 원하는 IPv4 아웃바운드 IP 수입니다. 허용되는 값은 1에서 100(포함) 범위여야 합니다. 기본값은 1입니다. int

제약 조건:
최소값 = 1
최대값 = 100
countIPv6 클러스터 부하 분산 장치에 대해 Azure에서 생성/관리하는 원하는 IPv6 아웃바운드 IP 수입니다. 허용되는 값은 1에서 100(포함) 범위여야 합니다. 기본값은 단일 스택의 경우 0이고 이중 스택의 경우 1입니다. int

제약 조건:
최소값 = 0
최대값 = 100

ManagedClusterLoadBalancerProfileOutboundIPPrefixes

Name Description 값
publicIPPrefixes 공용 IP 접두사 리소스 목록입니다. ResourceReference[]

ManagedClusterLoadBalancerProfileOutboundIPs

Name Description 값
publicIPs 공용 IP 리소스 목록입니다. ResourceReference[]

ManagedClusterNATGatewayProfile

Name Description 값
effectiveOutboundIPs 클러스터 NAT 게이트웨이의 효과적인 아웃바운드 IP 리소스입니다. ResourceReference[]
idleTimeoutInMinutes 원하는 아웃바운드 흐름 유휴 시간 제한(분)입니다. 허용되는 값은 4~120(포함) 범위에 있습니다. 기본값은 4분입니다. int

제약 조건:
최소값 = 4
최대값 = 120
managedOutboundIPProfile 클러스터 NAT 게이트웨이의 관리되는 아웃바운드 IP 리소스 프로필입니다. ManagedClusterManagedOutboundIPProfile

ManagedClusterManagedOutboundIPProfile

Name Description 값
count Azure에서 생성/관리하는 원하는 아웃바운드 IP 수입니다. 허용되는 값은 1에서 16(포함) 범위여야 합니다. 기본값은 1입니다. int

제약 조건:
최소값 = 1
최대값 = 16

ManagedClusterOidcIssuerProfile

Name Description 값
사용 OIDC 발급자를 사용할 수 있는지 여부입니다. bool

ManagedClusterPodIdentityProfile

Name Description 값
allowNetworkPluginKubenet Kubenet에서 실행은 기본적으로 AAD Pod ID의 보안 관련 특성 및 IP 스푸핑의 위험으로 인해 사용하지 않도록 설정됩니다. 자세한 내용은 AAD Pod ID와 함께 Kubenet 네트워크 플러그 인 사용을 참조하세요 . bool
사용 Pod ID 추가 기능을 사용할 수 있는지 여부입니다. bool
userAssignedIdentities 클러스터에서 사용할 Pod ID입니다. ManagedClusterPodIdentity[]
userAssignedIdentityExceptions 허용할 Pod ID 예외입니다. ManagedClusterPodIdentityException[]

ManagedClusterPodIdentity

Name Description 값
bindingSelector AzureIdentityBinding 리소스에 사용할 바인딩 선택기입니다. string
identity 사용자가 할당한 ID 세부 정보입니다. UserAssignedIdentity (필수)
name Pod ID의 이름입니다. string(필수)
namespace Pod ID의 네임스페이스입니다. string(필수)

ManagedClusterPodIdentityException

Name Description 값
name Pod ID 예외의 이름입니다. string(필수)
namespace Pod ID 예외의 네임스페이스입니다. string(필수)
podLabels 일치시킬 Pod 레이블입니다. ManagedClusterPodIdentityExceptionPodLabels (필수)

ManagedClusterPodIdentityExceptionPodLabels

Name Description 값
{customized property} string

PrivateLinkResource

Name Description 값
groupId 리소스의 그룹 ID입니다. 문자열
id 프라이빗 링크 리소스의 ID입니다. 문자열
name 프라이빗 링크 리소스의 이름입니다. string
requiredMembers 리소스의 RequiredMembers string[]
형식 리소스 종류입니다. 문자열

ManagedClusterSecurityProfile

Name Description 값
azureKeyVaultKms 보안 프로필에 대한 Azure Key Vault 키 관리 서비스 설정입니다. AzureKeyVaultKms
defender 보안 프로필에 대한 설정을 Microsoft Defender. ManagedClusterSecurityProfileDefender

AzureKeyVaultKms

Name Description 값
사용 Azure Key Vault 키 관리 서비스를 사용하도록 설정할지 여부입니다. 기본값은 false입니다. bool
keyId Azure Key Vault 키의 식별자입니다. 자세한 내용은 키 식별자 형식 을 참조하세요. Azure Key Vault 키 관리 서비스를 사용하도록 설정하면 이 필드가 필요하며 유효한 키 식별자여야 합니다. Azure Key Vault 키 관리 서비스를 사용하지 않도록 설정하면 필드를 비워 둡니다. string
keyVaultNetworkAccess 키 자격 증명 모음의 네트워크 액세스. 가능한 값은 Public 및 Private입니다. Public 는 키 자격 증명 모음이 모든 네트워크에서 공용 액세스를 허용한다는 것을 의미합니다. Private 는 키 자격 증명 모음이 공용 액세스를 사용하지 않도록 설정하고 프라이빗 링크를 사용하도록 설정함을 의미합니다. 기본값은 Public입니다. 'Private'
'Public'
keyVaultResourceId 키 자격 증명 모음의 리소스 ID입니다. keyVaultNetworkAccess가 인 경우 Private이 필드는 필수이며 유효한 리소스 ID여야 합니다. keyVaultNetworkAccess가 이면 Public필드를 비워 둡니다. 문자열

ManagedClusterSecurityProfileDefender

Name Description 값
logAnalyticsWorkspaceResourceId Microsoft Defender 연결할 Log Analytics 작업 영역의 리소스 ID입니다. Microsoft Defender 사용하도록 설정되면 이 필드가 필요하며 유효한 작업 영역 리소스 ID여야 합니다. Microsoft Defender 사용하지 않도록 설정되면 필드를 비워 둡니다. string
securityMonitoring 보안 프로필에 대한 클라우드 설정에 대한 위협 탐지를 Microsoft Defender. ManagedClusterSecurityProfileDefenderSecurityMonitor...

ManagedClusterSecurityProfileDefenderSecurityMonitor...

Name Description 값
사용 Defender 위협 탐지를 사용하도록 설정할지 여부 bool

ManagedClusterServicePrincipalProfile

Name Description 값
clientId 서비스 주체의 ID입니다. string(필수)
secret 일반 텍스트로 서비스 주체와 연결된 비밀 암호입니다. string

ManagedClusterStorageProfile

Name Description 값
blobCSIDriver 스토리지 프로필에 대한 AzureBlob CSI 드라이버 설정입니다. ManagedClusterStorageProfileBlobCSIDriver
diskCSIDriver 스토리지 프로필에 대한 AzureDisk CSI 드라이버 설정입니다. ManagedClusterStorageProfileDiskCSIDriver
fileCSIDriver 스토리지 프로필에 대한 AzureFile CSI 드라이버 설정입니다. ManagedClusterStorageProfileFileCSIDriver
snapshotController 스토리지 프로필에 대한 스냅샷 컨트롤러 설정입니다. ManagedClusterStorageProfileSnapshotController

ManagedClusterStorageProfileBlobCSIDriver

Name Description 값
사용 AzureBlob CSI 드라이버를 사용하도록 설정할지 여부입니다. 기본값은 false입니다. bool

ManagedClusterStorageProfileDiskCSIDriver

Name Description 값
사용 AzureDisk CSI 드라이버를 사용하도록 설정할지 여부입니다. 기본값은 true입니다. bool

ManagedClusterStorageProfileFileCSIDriver

Name Description 값
사용 AzureFile CSI 드라이버를 사용하도록 설정할지 여부입니다. 기본값은 true입니다. bool

ManagedClusterStorageProfileSnapshotController

Name Description 값
사용 스냅샷 컨트롤러를 사용하도록 설정할지 여부입니다. 기본값은 true입니다. bool

ManagedClusterWindowsProfile

Name Description 값
adminPassword 관리자 계정의 암호를 지정합니다.

최소 길이: 8자

최대 길이: 123자

복잡성 요구 사항: 아래의 4개 조건 중 3개는 충족해야 합니다.
문자가 낮습니다.
대문자 포함
숫자가 있습니다.
특수 문자가 있습니다(Regex 일치 [\W_])

허용되지 않는 값: "abc@123", "P@$$w 0rd", "P@ssw0rd", "P@ssword123", "Pa$$word", "pass@word1", "Password!", "Password1", "Password22", "iloveyou!"		 string
adminUsername 관리자 계정의 이름을 지정합니다.

제한: ""로 끝날 수 없습니다.

허용되지 않는 값: "administrator", "admin", "user", "user1", "test", "user2", "test1", "user3", "admin1", "1", "123", "a", "actuser", "adm", "admin2", "aspnet", "backup", "console", "david", "guest", "john", "owner", "root", "server", "sql", "support", "support_388945a0", "sys", "test2", "test3", "user4", "user5".

최소 길이: 1자

최대 길이: 20자		 string(필수)
enableCSIProxy CSI 프록시에 대한 자세한 내용은 CSI 프록시 GitHub 리포지토리를 참조하세요. bool
gmsaProfile 관리형 클러스터의 Windows gMSA 프로필입니다. WindowsGmsaProfile
licenseType Windows VM에 사용할 라이선스 유형입니다. 자세한 내용은 Azure 하이브리드 사용자 혜택을 참조하세요. 'None'
'Windows_Server'

WindowsGmsaProfile

Name Description 값
dnsServer Windows gMSA에 대한 DNS 서버를 지정합니다.

관리형 클러스터를 만드는 데 사용되는 vnet에서 DNS 서버를 구성한 경우 빈 상태로 설정합니다.		 string
사용 관리형 클러스터에서 Windows gMSA를 사용하도록 설정할지 여부를 지정합니다. bool
rootDomainName Windows gMSA의 루트 도메인 이름을 지정합니다.

관리형 클러스터를 만드는 데 사용되는 vnet에서 DNS 서버를 구성한 경우 빈 상태로 설정합니다.		 string

ManagedClusterSKU

Name Description 값
name 관리형 클러스터 SKU의 이름입니다. '기본'
계층 지정하지 않으면 기본값은 'Free'입니다. 자세한 내용은 작동 시간 SLA 를 참조하세요. '무료'
'유료'

빠른 시작 템플릿

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

템플릿 Description
AKS(Azure Container Service)에서 Jenkins를 사용하는 CI/CD

Azure에 배포		 컨테이너를 사용하면 애플리케이션을 지속적으로 빌드하고 배포할 수 있습니다. Azure Container Service에서 Kubernetes를 사용하여 해당 컨테이너의 배포를 오케스트레이션하면 복제 가능하고 관리 가능한 컨테이너 클러스터를 달성할 수 있습니다. 컨테이너 이미지 및 오케스트레이션을 생성하도록 연속 빌드를 설정하면 배포의 속도와 안정성을 높일 수 있습니다.
Azure Gateway min.io

Azure에 배포		 Blob Storage에서 지원되는 S3 규격 스토리지 API를 제공하기 위한 완전 프라이빗 min.io Azure Gateway 배포
NAT 게이트웨이 및 Application Gateway 있는 AKS 클러스터

Azure에 배포		 이 샘플에서는 아웃바운드 연결을 위한 NAT Gateway 및 인바운드 연결에 대한 Application Gateway 사용하여 AKS 클러스터를 배포하는 방법을 보여 줍니다.
프라이빗 AKS 클러스터 만들기

Azure에 배포		 이 샘플에서는 jumpbox 가상 머신과 함께 가상 네트워크에서 프라이빗 AKS 클러스터를 만드는 방법을 보여 줍니다.
공용 DNS 영역을 사용하여 프라이빗 AKS 클러스터 만들기

Azure에 배포		 이 샘플에서는 공용 DNS 영역을 사용하여 프라이빗 AKS 클러스터를 배포하는 방법을 보여 줍니다.
AKS(관리형 Kubernetes 클러스터) 배포

Azure에 배포		 이 ARM 템플릿은 고급 네트워킹 기능이 있는 AKS instance 기존 가상 네트워크에 배포하는 방법을 보여 줍니다. 또한 선택한 서비스 주체에는 AKS 클러스터가 포함된 서브넷에 대해 네트워크 기여자 역할이 할당됩니다.
AAD(AKS)를 사용하여 관리되는 Kubernetes 클러스터 배포

Azure에 배포		 이 ARM 템플릿은 고급 네트워킹 기능이 있는 AKS instance 기존 가상 네트워크 및 Azure AD 정수에 배포하는 방법을 보여 줍니다. 또한 선택한 서비스 주체에는 AKS 클러스터가 포함된 서브넷에 대해 네트워크 기여자 역할이 할당됩니다.
Azure ML용 AKS 클러스터 배포

Azure에 배포		 이 템플릿을 사용하면 Azure ML에 연결할 수 있는 엔트로프라이즈 규격 AKS 클러스터를 배포할 수 있습니다.
Azure Container Service(AKS)

Azure에 배포		 AKS(Azure Container Service)를 사용하여 관리형 클러스터 배포
Azure Container Service(AKS)

Azure에 배포		 Azure Linux 컨테이너 호스트를 사용하여 AKS(Azure Container Service)를 사용하여 관리형 클러스터 배포
Helm을 사용하는 AKS(Azure Container Service)

Azure에 배포		 Helm을 사용하여 AKS(Azure Container Service)를 사용하여 관리형 클러스터 배포
AKS(Azure Kubernetes Service)

Azure에 배포		 AKS(Azure Kubernetes Service)를 통해 관리되는 Kubernetes 클러스터 배포
Application Gateway 수신 컨트롤러가 있는 AKS 클러스터

Azure에 배포		 이 샘플에서는 Application Gateway, Application Gateway 수신 컨트롤러, Azure Container Registry, Log Analytics 및 Key Vault 사용하여 AKS 클러스터를 배포하는 방법을 보여 줍니다.

Terraform(AzAPI 공급자) 리소스 정의

managedClusters 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

  • 리소스 그룹

각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.

리소스 형식

Microsoft.ContainerService/managedClusters 리소스를 만들려면 템플릿에 다음 Terraform을 추가합니다.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ContainerService/managedClusters@2022-09-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    type = "string"
    identity_ids = []
  }
  body = jsonencode({
    properties = {
      aadProfile = {
        adminGroupObjectIDs = [
          "string"
        ]
        clientAppID = "string"
        enableAzureRBAC = bool
        managed = bool
        serverAppID = "string"
        serverAppSecret = "string"
        tenantID = "string"
      }
      addonProfiles = {
        {customized property} = {
          config = {
            {customized property} = "string"
          }
          enabled = bool
        }
      }
      agentPoolProfiles = [
        {
          availabilityZones = [
            "string"
          ]
          count = int
          creationData = {
            sourceResourceId = "string"
          }
          enableAutoScaling = bool
          enableEncryptionAtHost = bool
          enableFIPS = bool
          enableNodePublicIP = bool
          enableUltraSSD = bool
          gpuInstanceProfile = "string"
          hostGroupID = "string"
          kubeletConfig = {
            allowedUnsafeSysctls = [
              "string"
            ]
            containerLogMaxFiles = int
            containerLogMaxSizeMB = int
            cpuCfsQuota = bool
            cpuCfsQuotaPeriod = "string"
            cpuManagerPolicy = "string"
            failSwapOn = bool
            imageGcHighThreshold = int
            imageGcLowThreshold = int
            podMaxPids = int
            topologyManagerPolicy = "string"
          }
          kubeletDiskType = "string"
          linuxOSConfig = {
            swapFileSizeMB = int
            sysctls = {
              fsAioMaxNr = int
              fsFileMax = int
              fsInotifyMaxUserWatches = int
              fsNrOpen = int
              kernelThreadsMax = int
              netCoreNetdevMaxBacklog = int
              netCoreOptmemMax = int
              netCoreRmemDefault = int
              netCoreRmemMax = int
              netCoreSomaxconn = int
              netCoreWmemDefault = int
              netCoreWmemMax = int
              netIpv4IpLocalPortRange = "string"
              netIpv4NeighDefaultGcThresh1 = int
              netIpv4NeighDefaultGcThresh2 = int
              netIpv4NeighDefaultGcThresh3 = int
              netIpv4TcpFinTimeout = int
              netIpv4TcpkeepaliveIntvl = int
              netIpv4TcpKeepaliveProbes = int
              netIpv4TcpKeepaliveTime = int
              netIpv4TcpMaxSynBacklog = int
              netIpv4TcpMaxTwBuckets = int
              netIpv4TcpTwReuse = bool
              netNetfilterNfConntrackBuckets = int
              netNetfilterNfConntrackMax = int
              vmMaxMapCount = int
              vmSwappiness = int
              vmVfsCachePressure = int
            }
            transparentHugePageDefrag = "string"
            transparentHugePageEnabled = "string"
          }
          maxCount = int
          maxPods = int
          minCount = int
          mode = "string"
          name = "string"
          nodeLabels = {
            {customized property} = "string"
          }
          nodePublicIPPrefixID = "string"
          nodeTaints = [
            "string"
          ]
          orchestratorVersion = "string"
          osDiskSizeGB = int
          osDiskType = "string"
          osSKU = "string"
          osType = "string"
          podSubnetID = "string"
          powerState = {
            code = "string"
          }
          proximityPlacementGroupID = "string"
          scaleDownMode = "string"
          scaleSetEvictionPolicy = "string"
          scaleSetPriority = "string"
          spotMaxPrice = "decimal-as-string"
          tags = {}
          type = "string"
          upgradeSettings = {
            maxSurge = "string"
          }
          vmSize = "string"
          vnetSubnetID = "string"
          workloadRuntime = "string"
        }
      ]
      apiServerAccessProfile = {
        authorizedIPRanges = [
          "string"
        ]
        disableRunCommand = bool
        enablePrivateCluster = bool
        enablePrivateClusterPublicFQDN = bool
        privateDNSZone = "string"
      }
      autoScalerProfile = {
        balance-similar-node-groups = "string"
        expander = "string"
        max-empty-bulk-delete = "string"
        max-graceful-termination-sec = "string"
        max-node-provision-time = "string"
        max-total-unready-percentage = "string"
        new-pod-scale-up-delay = "string"
        ok-total-unready-count = "string"
        scale-down-delay-after-add = "string"
        scale-down-delay-after-delete = "string"
        scale-down-delay-after-failure = "string"
        scale-down-unneeded-time = "string"
        scale-down-unready-time = "string"
        scale-down-utilization-threshold = "string"
        scan-interval = "string"
        skip-nodes-with-local-storage = "string"
        skip-nodes-with-system-pods = "string"
      }
      autoUpgradeProfile = {
        upgradeChannel = "string"
      }
      disableLocalAccounts = bool
      diskEncryptionSetID = "string"
      dnsPrefix = "string"
      enablePodSecurityPolicy = bool
      enableRBAC = bool
      fqdnSubdomain = "string"
      httpProxyConfig = {
        httpProxy = "string"
        httpsProxy = "string"
        noProxy = [
          "string"
        ]
        trustedCa = "string"
      }
      identityProfile = {
        {customized property} = {
          clientId = "string"
          objectId = "string"
          resourceId = "string"
        }
      }
      kubernetesVersion = "string"
      linuxProfile = {
        adminUsername = "string"
        ssh = {
          publicKeys = [
            {
              keyData = "string"
            }
          ]
        }
      }
      networkProfile = {
        dnsServiceIP = "string"
        dockerBridgeCidr = "string"
        ipFamilies = [
          "string"
        ]
        loadBalancerProfile = {
          allocatedOutboundPorts = int
          effectiveOutboundIPs = [
            {
              id = "string"
            }
          ]
          enableMultipleStandardLoadBalancers = bool
          idleTimeoutInMinutes = int
          managedOutboundIPs = {
            count = int
            countIPv6 = int
          }
          outboundIPPrefixes = {
            publicIPPrefixes = [
              {
                id = "string"
              }
            ]
          }
          outboundIPs = {
            publicIPs = [
              {
                id = "string"
              }
            ]
          }
        }
        loadBalancerSku = "string"
        natGatewayProfile = {
          effectiveOutboundIPs = [
            {
              id = "string"
            }
          ]
          idleTimeoutInMinutes = int
          managedOutboundIPProfile = {
            count = int
          }
        }
        networkMode = "string"
        networkPlugin = "string"
        networkPolicy = "string"
        outboundType = "string"
        podCidr = "string"
        podCidrs = [
          "string"
        ]
        serviceCidr = "string"
        serviceCidrs = [
          "string"
        ]
      }
      nodeResourceGroup = "string"
      oidcIssuerProfile = {
        enabled = bool
      }
      podIdentityProfile = {
        allowNetworkPluginKubenet = bool
        enabled = bool
        userAssignedIdentities = [
          {
            bindingSelector = "string"
            identity = {
              clientId = "string"
              objectId = "string"
              resourceId = "string"
            }
            name = "string"
            namespace = "string"
          }
        ]
        userAssignedIdentityExceptions = [
          {
            name = "string"
            namespace = "string"
            podLabels = {
              {customized property} = "string"
            }
          }
        ]
      }
      privateLinkResources = [
        {
          groupId = "string"
          id = "string"
          name = "string"
          requiredMembers = [
            "string"
          ]
          type = "string"
        }
      ]
      publicNetworkAccess = "string"
      securityProfile = {
        azureKeyVaultKms = {
          enabled = bool
          keyId = "string"
          keyVaultNetworkAccess = "string"
          keyVaultResourceId = "string"
        }
        defender = {
          logAnalyticsWorkspaceResourceId = "string"
          securityMonitoring = {
            enabled = bool
          }
        }
      }
      servicePrincipalProfile = {
        clientId = "string"
        secret = "string"
      }
      storageProfile = {
        blobCSIDriver = {
          enabled = bool
        }
        diskCSIDriver = {
          enabled = bool
        }
        fileCSIDriver = {
          enabled = bool
        }
        snapshotController = {
          enabled = bool
        }
      }
      windowsProfile = {
        adminPassword = "string"
        adminUsername = "string"
        enableCSIProxy = bool
        gmsaProfile = {
          dnsServer = "string"
          enabled = bool
          rootDomainName = "string"
        }
        licenseType = "string"
      }
    }
    sku = {
      name = "Basic"
      tier = "string"
    }
    extendedLocation = {
      name = "string"
      type = "EdgeZone"
    }
  })
}

속성 값

managedClusters

Name Description 값
형식 리소스 종류 "Microsoft.ContainerService/managedClusters@2022-09-01"
name 리소스 이름 string(필수)

문자 제한: 1-63

유효한 문자:
영숫자, 밑줄 및 하이픈

영숫자로 시작하고 끝납니다.
위치 리소스가 있는 지리적 위치 string(필수)
parent_id 리소스 그룹에 배포하려면 해당 리소스 그룹의 ID를 사용합니다. string(필수)
tags 리소스 태그. 태그 이름 및 값의 사전입니다.
sku 관리형 클러스터 SKU입니다. ManagedClusterSKU
extendedLocation Virtual Machine의 확장된 위치입니다. ExtendedLocation
identity 구성된 경우 관리형 클러스터의 ID입니다. ManagedClusterIdentity
properties 관리형 클러스터의 속성입니다. ManagedClusterProperties

ExtendedLocation

Name Description 값
name 확장된 위치의 이름입니다. 문자열
type 확장된 위치의 형식입니다. "EdgeZone"

ManagedClusterIdentity

Name Description 값
형식 자세한 내용은 AKS에서 관리 ID 사용을 참조하세요. "SystemAssigned"
"UserAssigned"
identity_ids 키는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}' 형식의 ARM 리소스 ID여야 합니다. 사용자 ID ID의 배열입니다.

ManagedClusterIdentityUserAssignedIdentities

Name Description 값
{사용자 지정 속성} ManagedServiceIdentityUserAssignedIdentitiesValue

ManagedServiceIdentityUserAssignedIdentitiesValue

이 개체에는 배포 중에 설정할 속성이 포함되어 있지 않습니다. 모든 속성은 ReadOnly입니다.

ManagedClusterProperties

Name Description 값
aadProfile Azure Active Directory 구성입니다. ManagedClusterAADProfile
addonProfiles 관리형 클러스터 추가 기능의 프로필입니다. ManagedClusterPropertiesAddonProfiles
agentPoolProfiles 에이전트 풀 속성입니다. ManagedClusterAgentPoolProfile[]
apiServerAccessProfile 관리형 클러스터 API 서버에 대한 액세스 프로필입니다. ManagedClusterAPIServerAccessProfile
autoScalerProfile 사용하도록 설정된 경우 클러스터 자동 크기 조정기에 적용할 매개 변수 ManagedClusterPropertiesAutoScalerProfile
autoUpgradeProfile 자동 업그레이드 구성입니다. ManagedClusterAutoUpgradeProfile
disableLocalAccounts true로 설정하면 이 클러스터에 대해 정적 자격 증명 가져오기가 비활성화됩니다. AAD를 사용하도록 설정된 관리형 클러스터에서만 사용해야 합니다. 자세한 내용은 로컬 계정 사용 안 함을 참조하세요. bool
diskEncryptionSetID '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/diskEncryptionSets/{encryptionSetName}' 형식입니다. string
dnsPrefix 관리형 클러스터를 만든 후에는 업데이트할 수 없습니다. 문자열
enablePodSecurityPolicy (사용되지 않음) Kubernetes Pod 보안 정책(미리 보기)을 사용하도록 설정할지 여부입니다. 이 기능은 2020년 10월 15일에 제거하도록 설정됩니다. aka.ms/aks/azpodpolicy 자세히 알아보세요. bool
enableRBAC Kubernetes Role-Based Access Control 사용하도록 설정할지 여부입니다. bool
fqdnSubdomain 관리형 클러스터를 만든 후에는 업데이트할 수 없습니다. string
httpProxyConfig HTTP 프록시 서버를 사용하여 클러스터를 프로비전하기 위한 구성입니다. ManagedClusterHttpProxyConfig
identityProfile 클러스터와 연결된 ID입니다. ManagedClusterPropertiesIdentityProfile
kubernetesVersion 패치 버전 {major.minor.patch}(예: 1.20.13) 및 {major.minor}(예: 1.20)가 모두 지원됩니다. {major.minor}를 지정하면 지원되는 최신 GA 패치 버전이 자동으로 선택됩니다. 클러스터가 만들어지면(예: 1.14.x -} 1.14) 동일한 {major.minor}로 클러스터를 업데이트해도 최신 패치 버전을 사용할 수 있더라도 업그레이드가 트리거되지 않습니다. 지원되는 AKS 클러스터를 업그레이드하는 경우 Kubernetes 부 버전은 건너뛸 수 없습니다. 모든 업그레이드는 주 버전 번호로 순차적으로 수행되어야 합니다. 예를 들어 1.14.x -} 1.15.x 또는 1.15.x -} 1.16.x 간의 업그레이드는 허용되지만 1.14.x -} 1.16.x는 허용되지 않습니다. 자세한 내용은 AKS 클러스터 업그레이드 를 참조하세요. 문자열
linuxProfile 관리형 클러스터의 Linux VM에 대한 프로필입니다. ContainerServiceLinuxProfile
networkProfile 네트워크 구성 프로필입니다. ContainerServiceNetworkProfile
nodeResourceGroup 에이전트 풀 노드를 포함하는 리소스 그룹의 이름입니다. 문자열
oidcIssuerProfile 관리형 클러스터의 OIDC 발급자 프로필입니다. ManagedClusterOidcIssuerProfile
podIdentityProfile AAD Pod ID 통합에 대한 자세한 내용은 AAD Pod ID 사용을 참조하세요. ManagedClusterPodIdentityProfile
privateLinkResources 클러스터와 연결된 프라이빗 링크 리소스입니다. PrivateLinkResource[]
publicNetworkAccess AKS에 대한 공용 네트워크 액세스 허용 또는 거부 "사용 안 함"
"사용"
securityProfile 관리형 클러스터에 대한 보안 프로필입니다. ManagedClusterSecurityProfile
servicePrincipalProfile Azure API 조작에 사용할 클러스터의 서비스 주체 ID에 대한 정보입니다. ManagedClusterServicePrincipalProfile
storageProfile 관리형 클러스터에 대한 스토리지 프로필입니다. ManagedClusterStorageProfile
windowsProfile 관리형 클러스터의 Windows VM에 대한 프로필입니다. ManagedClusterWindowsProfile

ManagedClusterAADProfile

Name Description 값
adminGroupObjectIDs 클러스터의 관리자 역할이 있는 AAD 그룹 개체 ID 목록입니다. string[]
clientAppID 클라이언트 AAD 애플리케이션 ID입니다. 문자열
enableAzureRBAC Kubernetes 권한 부여에 Azure RBAC를 사용하도록 설정할지 여부입니다. bool
관리 관리되는 AAD를 사용하도록 설정할지 여부입니다. bool
serverAppID 서버 AAD 애플리케이션 ID입니다. string
serverAppSecret 서버 AAD 애플리케이션 암호입니다. 문자열
tenantID 인증에 사용할 AAD 테넌트 ID입니다. 지정하지 않으면 는 배포 구독의 테넌트 를 사용합니다. 문자열

ManagedClusterPropertiesAddonProfiles

Name Description 값
{사용자 지정 속성} ManagedClusterAddonProfile

ManagedClusterAddonProfile

Name Description 값
config 추가 기능을 구성하기 위한 키-값 쌍입니다. ManagedClusterAddonProfileConfig
사용 추가 기능을 사용할 수 있는지 여부입니다. bool(필수)

ManagedClusterAddonProfileConfig

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

ManagedClusterAgentPoolProfile

Name Description 값
availabilityZones 노드에 사용할 가용성 영역 목록입니다. AgentPoolType 속성이 'VirtualMachineScaleSets'인 경우에만 지정할 수 있습니다. string[]
count Docker 컨테이너를 호스트할 에이전트(VM)의 수입니다. 허용되는 값은 사용자 풀의 경우 0~1000(포함) 범위이고 시스템 풀의 경우 1~1000(포함) 범위여야 합니다. 기본값은 1입니다. int
creationData createData는 노드 풀이 스냅샷 사용하여 생성/업그레이드될 경우 원본 스냅샷 ID를 지정하는 데 사용됩니다. CreationData
enableAutoScaling 자동 크기 조정기를 사용하도록 설정할지 여부 bool
enableEncryptionAtHost 이는 특정 VM 크기 및 특정 Azure 지역에서만 지원됩니다. 자세한 내용은 /azure/aks/enable-host-encryption을 참조하세요. bool
enableFIPS 자세한 내용은 FIPS 사용 노드 풀 추가 를 참조하세요. bool
enableNodePublicIP 일부 시나리오에서는 노드 풀의 노드가 고유한 전용 공용 IP 주소를 수신해야 할 수 있습니다. 홉을 최소화하기 위해 콘솔에서 클라우드 가상 머신에 직접 연결해야 하는 게임 워크로드가 대표적인 시나리오입니다. 자세한 내용은 노드당 공용 IP 할당을 참조하세요. 기본값은 false입니다. bool
enableUltraSSD UltraSSD를 사용하도록 설정할지 여부 bool
gpuInstanceProfile GPUInstanceProfile은 지원되는 GPU VM SKU에 대한 GPU MIG instance 프로필을 지정하는 데 사용됩니다. "MIG1g"
"MIG2g"
"MIG3g"
"MIG4g"
"MIG7g"
hostGroupID /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}의 형식입니다. 자세한 내용은 Azure 전용 호스트를 참조하세요. string
kubeletConfig 에이전트 풀 노드의 Kubelet 구성입니다. KubeletConfig
kubeletDiskType emptyDir 볼륨, 컨테이너 런타임 데이터 루트 및 Kubelet 임시 스토리지의 배치를 결정합니다. "OS"
"임시"
linuxOSConfig Linux 에이전트 노드의 OS 구성입니다. LinuxOSConfig
maxCount 자동 크기 조정을 위한 최대 노드 수 int
maxPods 노드에서 실행할 수 있는 최대 Pod 수입니다. int
minCount 자동 크기 조정을 위한 최소 노드 수 int
mode 클러스터에는 항상 하나 이상의 '시스템' 에이전트 풀이 있어야 합니다. 에이전트 풀 제한 및 모범 사례에 대한 자세한 내용은 /azure/aks/use-system-pools를 참조하세요. "시스템"
"User"
name Windows 에이전트 풀 이름은 6자 이하여야 합니다. string(필수)

제약 조건:
패턴 = ^[a-z][a-z0-9]{0,11}$
nodeLabels 에이전트 풀의 모든 노드에서 유지할 노드 레이블입니다. ManagedClusterAgentPoolProfilePropertiesNodeLabels
nodePublicIPPrefixID /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName} 형식입니다. string
nodeTaints 노드 풀 만들기 및 크기 조정 중에 새 노드에 추가된 taint입니다. 예를 들어 key=value:NoSchedule입니다. string[]
orchestratorVersion 패치 버전 {major.minor.patch}(예: 1.20.13) 및 {major.minor}(예: 1.20)가 모두 지원됩니다. {major.minor}를 지정하면 지원되는 최신 GA 패치 버전이 자동으로 선택됩니다. 클러스터를 만든 후 동일한 {major.minor}(예: 1.14.x -} 1.14)로 업데이트해도 최신 패치 버전을 사용할 수 있더라도 업그레이드가 트리거되지 않습니다. AKS 클러스터의 모든 노드 풀을 동일한 Kubernetes 버전으로 업그레이드하는 것이 가장 좋습니다. 노드 풀 버전은 컨트롤 플레인과 동일한 주 버전이어야 합니다. 노드 풀 부 버전은 컨트롤 플레인 버전의 두 가지 부 버전 내에 있어야 합니다. 노드 풀 버전은 컨트롤 플레인 버전보다 클 수 없습니다. 자세한 내용은 노드 풀 업그레이드를 참조하세요. 문자열
osDiskSizeGB OS 디스크 크기(GB)는 master/에이전트 풀의 모든 컴퓨터에 대한 디스크 크기를 지정하는 데 사용됩니다. 0을 지정하면 지정된 vmSize에 따라 기본 osDisk 크기가 적용됩니다. int

제약 조건:
최소값 = 0
최대값 = 2048
osDiskType VM이 지원되고 요청된 OSDiskSizeGB보다 큰 캐시 디스크가 있는 경우 기본값은 '임시'입니다. 그렇지 않으면 기본값은 'Managed'입니다. 만든 후에는 변경되지 않을 수 있습니다. 자세한 내용은 임시 OS를 참조하세요. "임시"
"관리"
osSKU 에이전트 풀에서 사용하는 OS SKU를 지정합니다. OSType이 Linux인 경우 기본값은 Ubuntu입니다. OSType이 Windows인 경우 Kubernetes <= 1.24 또는 Windows2022인 경우 Kubernetes >= 1.25인 경우 기본값은 Windows2019입니다. "CBLMariner"
"Ubuntu"
"Windows2019"
"Windows2022"
osType 운영 체제 유형입니다. 기본값은 Linux입니다. "Linux"
"Windows"
podSubnetID 생략하면 노드 서브넷에 Pod IP가 정적으로 할당됩니다(자세한 내용은 vnetSubnetID 참조). /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} 형식입니다. 문자열
powerState 에이전트 풀이 처음 만들어지면 처음에는 실행 중입니다. 이 필드를 중지됨으로 설정하여 에이전트 풀을 중지할 수 있습니다. 중지된 에이전트 풀은 모든 VM을 중지하고 청구 요금이 발생하지 않습니다. 에이전트 풀이 실행 중이고 프로비저닝 상태가 성공인 경우에만 중지할 수 있습니다. PowerState
proximityPlacementGroupID 근접 배치 그룹의 ID입니다. string
scaleDownMode 클러스터 자동 크기 조정기 동작에도 영향을 줍니다. 지정하지 않으면 기본적으로 삭제로 설정됩니다. "할당 취소"
"Delete"
scaleSetEvictionPolicy scaleSetPriority가 'Spot'이 아니면 지정할 수 없습니다. 지정하지 않으면 기본값은 'Delete'입니다. "할당 취소"
"Delete"
scaleSetPriority Virtual Machine Scale Set 우선 순위입니다. 지정하지 않으면 기본값은 'Regular'입니다. "일반"
"스폿"
spotMaxPrice 가능한 값은 주문형 가격을 지불하려는 의지를 나타내는 0 또는 -1보다 큰 10진수 값입니다. 스폿 가격 책정에 대한 자세한 내용은 스폿 VM 가격 책정 10진수 값을 문자열로 지정을 참조하세요. int 또는 json decimal
tags 에이전트 풀 가상 머신 확장 집합에 유지할 태그입니다. object
형식 에이전트 풀의 유형입니다. "AvailabilitySet"
"VirtualMachineScaleSets"
upgradeSettings 에이전트 풀 업그레이드 설정 AgentPoolUpgradeSettings
vmSize VM 크기 가용성은 지역에 따라 다릅니다. 노드에 컴퓨팅 리소스(메모리, cpu 등)가 부족한 경우 Pod가 올바르게 실행되지 않을 수 있습니다. 제한된 VM 크기에 대한 자세한 내용은 /azure/aks/quotas-skus-regions를 참조하세요. string
vnetSubnetID 지정하지 않으면 VNET 및 서브넷이 생성되고 사용됩니다. podSubnetID를 지정하지 않으면 노드 및 Pod에 적용되고, 그렇지 않으면 노드에만 적용됩니다. /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} 형식입니다. 문자열
workloadRuntime 노드에서 실행할 수 있는 워크로드 유형을 결정합니다. "OCIContainer"
"WasmWasi"

CreationData

Name Description 값
sourceResourceId 대상 개체를 만드는 데 사용할 원본 개체의 ARM ID입니다. string

KubeletConfig

Name Description 값
allowedUnsafeSysctls 안전하지 않은 sysctls 또는 안전하지 않은 sysctl 패턴의 허용된 목록입니다(로 종료 *). string[]
containerLogMaxFiles 컨테이너에 제공할 수 있는 컨테이너 로그 파일의 최대 수입니다. 숫자는 ≥ 2여야 합니다. int

제약 조건:
최소값 = 2
containerLogMaxSizeMB 컨테이너 로그 파일이 회전되기 전의 최대 크기(예: 10Mi)입니다. int
cpuCfsQuota 기본값은 true입니다. bool
cpuCfsQuotaPeriod 기본값은 '100ms'입니다. 유효한 값은 선택적 소수점과 단위 접미사가 있는 10진수 시퀀스입니다. 예: '300ms', '2h45m'. 지원되는 단위는 'ns', 'us', 'ms', 's', 'm', 'h'입니다. string
cpuManagerPolicy 기본값은 'none'입니다. 자세한 내용은 Kubernetes CPU 관리 정책을 참조하세요. 허용되는 값은 'none' 및 'static'입니다. 문자열
failSwapOn true로 설정하면 노드에서 교환을 사용하도록 설정하면 Kubelet이 시작되지 않습니다. bool
imageGcHighThreshold 이미지 가비지 수집을 사용하지 않으려면 100으로 설정합니다. 기본값은 85%입니다. int
imageGcLowThreshold imageGcHighThreshold보다 높게 설정할 수 없습니다. 기본값은 80%입니다. int
podMaxPids Pod당 최대 프로세스 수입니다. int
topologyManagerPolicy 자세한 내용은 Kubernetes 토폴로지 관리자를 참조하세요. 기본값은 'none'입니다. 허용되는 값은 'none', 'best-effort', 'restricted', 'single-numa-node'입니다. 문자열

LinuxOSConfig

Name Description 값
swapFileSizeMB 각 노드에서 만들 스왑 파일의 크기(MB)입니다. int
sysctls Linux 에이전트 노드에 대한 Sysctl 설정입니다. SysctlConfig
transparentHugePageDefrag 유효한 값은 'always', 'defer', 'defer+madvise', 'madvise' 및 'never'입니다. 기본값은 'madvise'입니다. 자세한 내용은 투명한 거대한 페이지를 참조하세요. 문자열
transparentHugePageEnabled 유효한 값은 'always', 'madvise', 'never'입니다. 기본값은 'always'입니다. 자세한 내용은 투명한 거대한 페이지를 참조하세요. 문자열

SysctlConfig

Name Description 값
fsAioMaxNr Sysctl 설정 fs.aio-max-nr. int
fsFileMax Sysctl 설정 fs.file-max. int
fsInotifyMaxUserWatches Sysctl 설정 fs.inotify.max_user_watches. int
fsNrOpen Sysctl 설정 fs.nr_open. int
kernelThreadsMax Sysctl 설정 kernel.threads-max. int
netCoreNetdevMaxBacklog Sysctl 설정 net.core.netdev_max_backlog. int
netCoreOptmemMax Sysctl 설정 net.core.optmem_max. int
netCoreRmemDefault Sysctl 설정 net.core.rmem_default. int
netCoreRmemMax Sysctl 설정 net.core.rmem_max. int
netCoreSomaxconn sysctl 설정 net.core.somaxconn. int
netCoreWmemDefault Sysctl 설정 net.core.wmem_default. int
netCoreWmemMax Sysctl 설정 net.core.wmem_max. int
netIpv4IpLocalPortRange Sysctl 설정 net.ipv4.ip_local_port_range. string
netIpv4NeighDefaultGcThresh1 Sysctl 설정 net.ipv4.neigh.default.gc_thresh1. int
netIpv4NeighDefaultGcThresh2 Sysctl 설정 net.ipv4.neigh.default.gc_thresh2. int
netIpv4NeighDefaultGcThresh3 Sysctl 설정 net.ipv4.neigh.default.gc_thresh3. int
netIpv4TcpFinTimeout Sysctl 설정 net.ipv4.tcp_fin_timeout. int
netIpv4TcpkeepaliveIntvl Sysctl 설정 net.ipv4.tcp_keepalive_intvl. int
netIpv4TcpKeepaliveProbes Sysctl 설정 net.ipv4.tcp_keepalive_probes. int
netIpv4TcpKeepaliveTime Sysctl 설정 net.ipv4.tcp_keepalive_time. int
netIpv4TcpMaxSynBacklog Sysctl 설정 net.ipv4.tcp_max_syn_backlog. int
netIpv4TcpMaxTwBuckets Sysctl 설정 net.ipv4.tcp_max_tw_buckets. int
netIpv4TcpTwReuse Sysctl 설정 net.ipv4.tcp_tw_reuse. bool
netNetfilterNfConntrackBuckets Sysctl 설정 net.netfilter.nf_conntrack_buckets. int
netNetfilterNfConntrackMax Sysctl 설정 net.netfilter.nf_conntrack_max. int
vmMaxMapCount Sysctl 설정 vm.max_map_count. int
vmSwappiness Sysctl 설정 vm.swappiness. int
vmVfsCachePressure Sysctl 설정 vm.vfs_cache_pressure. int

ManagedClusterAgentPoolProfilePropertiesNodeLabels

Name Description 값
{customized property} 문자열

PowerState

Name Description 값
코드 클러스터가 실행 중인지 또는 중지되었는지를 알려줍니다. "실행 중"
"중지됨"

AgentPoolUpgradeSettings

Name Description 값
maxSurge 이 값은 정수(예: '5') 또는 백분율(예: '50%')으로 설정할 수 있습니다. 백분율을 지정하면 업그레이드 시 총 에이전트 풀 크기의 백분율입니다. 백분율의 경우 소수 노드가 반올림됩니다. 이 인수를 지정하지 않으면 기본값은 1입니다. 모범 사례를 포함한 자세한 내용은 다음을 참조하세요. /azure/aks/upgrade-cluster#customize-node-surge-upgrade 문자열

ManagedClusterAPIServerAccessProfile

Name Description 값
authorizedIPRanges IP 범위는 CIDR 형식으로 지정됩니다(예: 137.117.106.88/29). 이 기능은 노드당 공용 IP를 사용하는 클러스터 또는 기본 Load Balancer 사용하는 클러스터와 호환되지 않습니다. 자세한 내용은 API 서버 권한 있는 IP 범위를 참조하세요. string[]
disableRunCommand 클러스터에 대한 실행 명령을 사용하지 않도록 설정할지 여부입니다. bool
enablePrivateCluster 자세한 내용은 프라이빗 AKS 클러스터 만들기를 참조하세요. bool
enablePrivateClusterPublicFQDN 프라이빗 클러스터에 대한 추가 공용 FQDN을 만들지 여부를 지정합니다. bool
privateDNSZone 기본값은 시스템입니다. 자세한 내용은 프라이빗 DNS 영역 구성을 참조하세요. 허용되는 값은 'system' 및 'none'입니다. string

ManagedClusterPropertiesAutoScalerProfile

Name Description 값
balance-similar-node-groups 유효한 값은 'true'와 'false'입니다. 문자열
확장기 지정하지 않으면 기본값은 'random'입니다. 자세한 내용은 확장기를 참조하세요. "최소 폐기물"
"대부분의 포드"
"priority"
"random"
max-empty-bulk-delete 기본값은 10입니다. string
max-graceful-termination-sec 기본값은 600입니다. 문자열
max-node-provision-time 기본값은 '15m'입니다. 값은 정수 뒤에 'm'이어야 합니다. 분(m) 이외의 시간 단위는 지원되지 않습니다. 문자열
max-total-unready-percentage 기본값은 45입니다. 최대값은 100이고 최소값은 0입니다. 문자열
new-pod-scale-up-delay Kubernetes 스케줄러가 모든 Pod를 예약하기 전에 CA가 작동하지 않도록 하려는 버스트/일괄 처리 규모와 같은 시나리오의 경우, 어느 정도 시간이 지나기 전에 예약되지 않은 Pod를 CA가 무시하도록 지시할 수 있습니다. 기본값은 '0s'입니다. 값은 정수와 단위(초의 경우', 분은 'm', 시간 단위는 'h' 등)여야 합니다. 문자열
ok-total-unready-count 정수여야 합니다. 기본값은 3입니다. 문자열
scale-down-delay-after-add 기본값은 '10m'입니다. 값은 정수 뒤에 'm'이어야 합니다. 분(m) 이외의 시간 단위는 지원되지 않습니다. 문자열
scale-down-delay-after-delete 기본값은 스캔 간격입니다. 값은 정수 뒤에 'm'이어야 합니다. 분(m) 이외의 시간 단위는 지원되지 않습니다. 문자열
scale-down-delay-after-failure 기본값은 '3m'입니다. 값은 정수 뒤에 'm'이어야 합니다. 분(m) 이외의 시간 단위는 지원되지 않습니다. 문자열
scale-down-unneeded-time 기본값은 '10m'입니다. 값은 정수 뒤에 'm'이어야 합니다. 분(m) 이외의 시간 단위는 지원되지 않습니다. 문자열
scale-down-unready-time 기본값은 '20m'입니다. 값은 정수 뒤에 'm'이어야 합니다. 분(m) 이외의 시간 단위는 지원되지 않습니다. 문자열
scale-down-utilization-threshold 기본값은 '0.5'입니다. string
scan-interval 기본값은 '10'입니다. 값은 정수 초여야 합니다. string
skip-nodes-with-local-storage 기본값은 true입니다. string
skip-nodes-with-system-pods 기본값은 true입니다. string

ManagedClusterAutoUpgradeProfile

Name Description 값
upgradeChannel 자세한 내용은 AKS 클러스터 자동 업그레이드 채널 설정을 참조하세요. "node-image"
"none"
"patch"
"빠른"
"안정적"

ManagedClusterHttpProxyConfig

Name Description 값
httpProxy 사용할 HTTP 프록시 서버 엔드포인트입니다. 문자열
httpsProxy 사용할 HTTPS 프록시 서버 엔드포인트입니다. 문자열
noProxy 프록시를 통과해서는 안 되는 엔드포인트입니다. string[]
trustedCa 프록시 서버에 연결하는 데 사용할 대체 CA 인증서입니다. string

ManagedClusterPropertiesIdentityProfile

Name Description 값
{사용자 지정 속성} UserAssignedIdentity

UserAssignedIdentity

Name Description 값
clientId 사용자 할당 ID의 클라이언트 ID입니다. 문자열
objectId 사용자 할당 ID의 개체 ID입니다. 문자열
resourceId 사용자 할당 ID의 리소스 ID입니다. string

ContainerServiceLinuxProfile

Name Description 값
adminUsername Linux VM에 사용할 관리자 사용자 이름입니다. string(필수)

제약 조건:
패턴 = ^[A-Za-z][-A-Za-z0-9_]*$
ssh Azure에서 실행되는 Linux 기반 VM에 대한 SSH 구성입니다. ContainerServiceSshConfiguration (필수)

ContainerServiceSshConfiguration

Name Description 값
publicKeys Linux 기반 VM으로 인증하는 데 사용되는 SSH 공개 키 목록입니다. 최대 1키를 지정할 수 있습니다. ContainerServiceSshPublicKey[] (필수)

ContainerServiceSshPublicKey

Name Description 값
keyData SSH를 통해 VM으로 인증하는 데 사용되는 인증서 공개 키입니다. 인증서는 헤더를 사용하거나 사용하지 않는 PEM 형식이어야 합니다. string(필수)

ContainerServiceNetworkProfile

Name Description 값
dnsServiceIP Kubernetes DNS 서비스에 할당된 IP 주소입니다. serviceCidr에 지정된 Kubernetes 서비스 주소 범위 내에 있어야 합니다. string

제약 조건:
패턴 = ^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$
dockerBridgeCidr Docker 브리지 네트워크에 할당된 CIDR 표기법 IP 범위입니다. 서브넷 IP 범위 또는 Kubernetes 서비스 주소 범위와 겹치지 않아야 합니다. 문자열

제약 조건:
패턴 = ^([0-9]{1,3}\.){3}[0-9]{1,3}(\/([0-9]|[1-2][0-9]|3[0-2]))?$
ipFamilies IP 패밀리는 단일 스택 또는 이중 스택 클러스터를 결정하는 데 사용됩니다. 단일 스택의 경우 예상 값은 IPv4입니다. 이중 스택의 경우 예상 값은 IPv4 및 IPv6입니다. 다음 중 어느 것을 포함하는 문자열 배열:
"IPv4"
"IPv6"
loadBalancerProfile 클러스터 부하 분산 장치의 프로필입니다. ManagedClusterLoadBalancerProfile
loadBalancerSku 기본값은 '표준'입니다. 부하 분산 장치 SKU 간의 차이점에 대한 자세한 내용은 Azure Load Balancer SKU를 참조하세요. "기본"
"표준"
natGatewayProfile 클러스터 NAT 게이트웨이의 프로필입니다. ManagedClusterNATGatewayProfile
networkMode networkPlugin이 'azure' 이외의 항목인 경우 지정할 수 없습니다. "브리지"
"투명"
networkPlugin Kubernetes 네트워크를 빌드하는 데 사용되는 네트워크 플러그 인입니다. "azure"
"kubenet"
"none"
networkPolicy Kubernetes 네트워크를 빌드하는 데 사용되는 네트워크 정책입니다. "azure"
"calico"
outboundType 클러스터를 만들 때만 설정할 수 있으며 나중에 변경할 수 없습니다. 자세한 내용은 송신 아웃바운드 형식을 참조하세요. "loadBalancer"
"managedNATGateway"
"userAssignedNATGateway"
"userDefinedRouting"
podCidr kubenet이 사용되는 경우 Pod IP를 할당하는 CIDR 표기법 IP 범위입니다. 문자열

제약 조건:
패턴 = ^([0-9]{1,3}\.){3}[0-9]{1,3}(\/([0-9]|[1-2][0-9]|3[0-2]))?$
podCidrs 단일 스택 네트워킹에는 하나의 IPv4 CIDR이 필요합니다. 이중 스택 네트워킹에는 각 IP 패밀리(IPv4/IPv6)에 대해 하나씩 두 개의 CIDR이 필요합니다. string[]
serviceCidr 서비스 클러스터 IP를 할당하는 CIDR 표기법 IP 범위입니다. 서브넷 IP 범위와 겹치지 않아야 합니다. 문자열

제약 조건:
패턴 = ^([0-9]{1,3}\.){3}[0-9]{1,3}(\/([0-9]|[1-2][0-9]|3[0-2]))?$
serviceCidrs 단일 스택 네트워킹에는 하나의 IPv4 CIDR이 필요합니다. 이중 스택 네트워킹에는 각 IP 패밀리(IPv4/IPv6)에 대해 하나씩 두 개의 CIDR이 필요합니다. 서브넷 IP 범위와 겹쳐서는 안 됩니다. string[]

ManagedClusterLoadBalancerProfile

Name Description 값
allocatedOutboundPorts VM당 할당된 SNAT 포트의 원하는 수입니다. 허용되는 값은 0에서 64000(포함) 범위입니다. 기본값은 0으로, Azure에서 포트를 동적으로 할당합니다. int

제약 조건:
최소값 = 0
최대값 = 64000
effectiveOutboundIPs 클러스터 부하 분산 장치의 효과적인 아웃바운드 IP 리소스입니다. ResourceReference[]
enableMultipleStandardLoadBalancers AKS 클러스터당 여러 표준 부하 분산 장치를 사용하도록 설정합니다. bool
idleTimeoutInMinutes 원하는 아웃바운드 흐름 유휴 시간 제한(분)입니다. 허용되는 값은 4~120(포함) 범위에 있습니다. 기본값은 30분입니다. int

제약 조건:
최소값 = 4
최대값 = 120
managedOutboundIPs 클러스터 부하 분산 장치에 대해 원하는 관리형 아웃바운드 IP입니다. ManagedClusterLoadBalancerProfileManagedOutboundIPs
outboundIPPrefixes 클러스터 부하 분산 장치에 대한 원하는 아웃바운드 IP 접두사 리소스입니다. ManagedClusterLoadBalancerProfileOutboundIPPrefixes
아웃바운드 IP 클러스터 부하 분산 장치에 대해 원하는 아웃바운드 IP 리소스입니다. ManagedClusterLoadBalancerProfileOutboundIPs

ResourceReference

Name Description 값
id 정규화된 Azure 리소스 ID입니다. 문자열

ManagedClusterLoadBalancerProfileManagedOutboundIPs

Name Description 값
count 클러스터 부하 분산 장치에 대해 Azure에서 생성/관리하는 원하는 IPv4 아웃바운드 IP 수입니다. 허용되는 값은 1에서 100(포함) 범위여야 합니다. 기본값은 1입니다. int

제약 조건:
최소값 = 1
최대값 = 100
countIPv6 클러스터 부하 분산 장치에 대해 Azure에서 생성/관리하는 원하는 IPv6 아웃바운드 IP 수입니다. 허용되는 값은 1에서 100(포함) 범위여야 합니다. 기본값은 단일 스택의 경우 0이고 이중 스택의 경우 1입니다. int

제약 조건:
최소값 = 0
최대값 = 100

ManagedClusterLoadBalancerProfileOutboundIPPrefixes

Name Description 값
publicIPPrefixes 공용 IP 접두사 리소스 목록입니다. ResourceReference[]

ManagedClusterLoadBalancerProfileOutboundIPs

Name Description 값
publicIPs 공용 IP 리소스 목록입니다. ResourceReference[]

ManagedClusterNATGatewayProfile

Name Description 값
effectiveOutboundIPs 클러스터 NAT 게이트웨이의 효과적인 아웃바운드 IP 리소스입니다. ResourceReference[]
idleTimeoutInMinutes 원하는 아웃바운드 흐름 유휴 시간 제한(분)입니다. 허용되는 값은 4~120(포함) 범위에 있습니다. 기본값은 4분입니다. int

제약 조건:
최소값 = 4
최대값 = 120
managedOutboundIPProfile 클러스터 NAT 게이트웨이의 관리되는 아웃바운드 IP 리소스 프로필입니다. ManagedClusterManagedOutboundIPProfile

ManagedClusterManagedOutboundIPProfile

Name Description 값
count Azure에서 생성/관리하는 원하는 아웃바운드 IP 수입니다. 허용되는 값은 1에서 16(포함) 범위여야 합니다. 기본값은 1입니다. int

제약 조건:
최소값 = 1
최대값 = 16

ManagedClusterOidcIssuerProfile

Name Description 값
사용 OIDC 발급자를 사용할 수 있는지 여부입니다. bool

ManagedClusterPodIdentityProfile

Name Description 값
allowNetworkPluginKubenet Kubenet에서 실행은 기본적으로 AAD Pod ID의 보안 관련 특성 및 IP 스푸핑의 위험으로 인해 사용하지 않도록 설정됩니다. 자세한 내용은 AAD Pod ID와 함께 Kubenet 네트워크 플러그 인 사용을 참조하세요 . bool
사용 Pod ID 추가 기능을 사용할 수 있는지 여부입니다. bool
userAssignedIdentities 클러스터에서 사용할 Pod ID입니다. ManagedClusterPodIdentity[]
userAssignedIdentityExceptions 허용할 Pod ID 예외입니다. ManagedClusterPodIdentityException[]

ManagedClusterPodIdentity

Name Description 값
bindingSelector AzureIdentityBinding 리소스에 사용할 바인딩 선택기입니다. string
identity 사용자가 할당한 ID 세부 정보입니다. UserAssignedIdentity (필수)
name Pod ID의 이름입니다. string(필수)
namespace Pod ID의 네임스페이스입니다. string(필수)

ManagedClusterPodIdentityException

Name Description 값
name Pod ID 예외의 이름입니다. string(필수)
namespace Pod ID 예외의 네임스페이스입니다. string(필수)
podLabels 일치시킬 Pod 레이블입니다. ManagedClusterPodIdentityExceptionPodLabels (필수)

ManagedClusterPodIdentityExceptionPodLabels

Name Description 값
{customized property} 문자열

PrivateLinkResource

Name Description 값
groupId 리소스의 그룹 ID입니다. 문자열
id 프라이빗 링크 리소스의 ID입니다. 문자열
name 프라이빗 링크 리소스의 이름입니다. 문자열
requiredMembers 리소스의 RequiredMembers string[]
형식 리소스 종류입니다. 문자열

ManagedClusterSecurityProfile

Name Description 값
azureKeyVaultKms 보안 프로필에 대한 Azure Key Vault 키 관리 서비스 설정입니다. AzureKeyVaultKms
defender 보안 프로필에 대한 설정을 Microsoft Defender. ManagedClusterSecurityProfileDefender

AzureKeyVaultKms

Name Description 값
사용 Azure Key Vault 키 관리 서비스를 사용하도록 설정할지 여부입니다. 기본값은 false입니다. bool
keyId Azure Key Vault 키의 식별자입니다. 자세한 내용은 키 식별자 형식 을 참조하세요. Azure Key Vault 키 관리 서비스를 사용하도록 설정하면 이 필드가 필요하며 유효한 키 식별자여야 합니다. Azure Key Vault 키 관리 서비스를 사용하지 않도록 설정하면 필드를 비워 둡니다. 문자열
keyVaultNetworkAccess 키 자격 증명 모음의 네트워크 액세스. 가능한 값은 Public 및 Private입니다. Public 는 키 자격 증명 모음이 모든 네트워크에서 공용 액세스를 허용한다는 것을 의미합니다. Private 는 키 자격 증명 모음이 공용 액세스를 사용하지 않도록 설정하고 프라이빗 링크를 사용하도록 설정함을 의미합니다. 기본값은 Public입니다. "Private"
"Public"
keyVaultResourceId 키 자격 증명 모음의 리소스 ID입니다. keyVaultNetworkAccess가 인 경우 Private이 필드는 필수이며 유효한 리소스 ID여야 합니다. keyVaultNetworkAccess가 이면 Public필드를 비워 둡니다. string

ManagedClusterSecurityProfileDefender

Name Description 값
logAnalyticsWorkspaceResourceId Microsoft Defender 연결할 Log Analytics 작업 영역의 리소스 ID입니다. Microsoft Defender 사용하도록 설정되면 이 필드가 필요하며 유효한 작업 영역 리소스 ID여야 합니다. Microsoft Defender 사용하지 않도록 설정되면 필드를 비워 둡니다. 문자열
securityMonitoring 보안 프로필에 대한 클라우드 설정에 대한 위협 탐지를 Microsoft Defender. ManagedClusterSecurityProfileDefenderSecurityMonitor...

ManagedClusterSecurityProfileDefenderSecurityMonitor...

Name Description 값
사용 Defender 위협 탐지를 사용하도록 설정할지 여부 bool

ManagedClusterServicePrincipalProfile

Name Description 값
clientId 서비스 주체의 ID입니다. string(필수)
secret 일반 텍스트로 서비스 주체와 연결된 비밀 암호입니다. 문자열

ManagedClusterStorageProfile

Name Description 값
blobCSIDriver 스토리지 프로필에 대한 AzureBlob CSI 드라이버 설정입니다. ManagedClusterStorageProfileBlobCSIDriver
diskCSIDriver 스토리지 프로필에 대한 AzureDisk CSI 드라이버 설정입니다. ManagedClusterStorageProfileDiskCSIDriver
fileCSIDriver 스토리지 프로필에 대한 AzureFile CSI 드라이버 설정입니다. ManagedClusterStorageProfileFileCSIDriver
snapshotController 스토리지 프로필에 대한 스냅샷 컨트롤러 설정입니다. ManagedClusterStorageProfileSnapshotController

ManagedClusterStorageProfileBlobCSIDriver

Name Description 값
사용 AzureBlob CSI 드라이버를 사용하도록 설정할지 여부입니다. 기본값은 false입니다. bool

ManagedClusterStorageProfileDiskCSIDriver

Name Description 값
사용 AzureDisk CSI 드라이버를 사용하도록 설정할지 여부입니다. 기본값은 true입니다. bool

ManagedClusterStorageProfileFileCSIDriver

Name Description 값
사용 AzureFile CSI 드라이버를 사용하도록 설정할지 여부입니다. 기본값은 true입니다. bool

ManagedClusterStorageProfileSnapshotController

Name Description 값
사용 스냅샷 컨트롤러를 사용하도록 설정할지 여부입니다. 기본값은 true입니다. bool

ManagedClusterWindowsProfile

Name Description 값
adminPassword 관리자 계정의 암호를 지정합니다.

최소 길이: 8자

최대 길이: 123자

복잡성 요구 사항: 아래의 4개 조건 중 3개는 충족해야 합니다.
문자가 낮습니다.
대문자 포함
숫자 가 있습니다.
특수 문자가 있습니다(Regex 일치 [\W_])

허용되지 않는 값: "abc@123", "P@$$w 0rd", "P@ssw0rd", "P@ssword123", "Pa$$word", "pass@word1", "Password!", "Password1", "Password22", "iloveyou!"		 string
adminUsername 관리자 계정의 이름을 지정합니다.

제한: ""로 끝날 수 없습니다.

허용되지 않는 값: "administrator", "admin", "user", "user1", "test", "user2", "test1", "user3", "admin1", "1", "123", "a", "actuser", "adm", "admin2", "aspnet", "backup", "console", "david", "guest", "john", "owner", "root", "server", "sql", "support", "support_388945a0", "sys", "test2", "test3", "user4", "user5".

최소 길이: 1자

최대 길이: 20자		 string(필수)
enableCSIProxy CSI 프록시에 대한 자세한 내용은 CSI 프록시 GitHub 리포지토리를 참조하세요. bool
gmsaProfile 관리형 클러스터의 Windows gMSA 프로필입니다. WindowsGmsaProfile
licenseType Windows VM에 사용할 라이선스 유형입니다. 자세한 내용은 Azure 하이브리드 사용자 혜택을 참조하세요. “None”
"Windows_Server"

WindowsGmsaProfile

Name Description 값
dnsServer Windows gMSA에 대한 DNS 서버를 지정합니다.

관리형 클러스터를 만드는 데 사용되는 VNet에서 DNS 서버를 구성한 경우 이 서버를 빈 상태로 설정합니다.		 문자열
사용 관리형 클러스터에서 Windows gMSA를 사용하도록 설정할지 여부를 지정합니다. bool
rootDomainName Windows gMSA의 루트 도메인 이름을 지정합니다.

관리형 클러스터를 만드는 데 사용되는 VNet에서 DNS 서버를 구성한 경우 이 서버를 빈 상태로 설정합니다.		 string

ManagedClusterSKU

Name Description 값
name 관리형 클러스터 SKU의 이름입니다. "Basic"
계층 지정하지 않으면 기본값은 'Free'입니다. 자세한 내용은 작동 시간 SLA 를 참조하세요. "무료"
"유료"