다음을 통해 공유


Microsoft.ContainerService 플릿

Bicep 리소스 정의

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

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

리소스 형식

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

resource symbolicname 'Microsoft.ContainerService/fleets@2025-08-01-preview' = {
  scope: resourceSymbolicName or scope
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    hubProfile: {
      agentProfile: {
        subnetId: 'string'
        vmSize: 'string'
      }
      apiServerAccessProfile: {
        enablePrivateCluster: bool
        enableVnetIntegration: bool
        subnetId: 'string'
      }
      dnsPrefix: 'string'
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

속성 값

Microsoft.ContainerService/fleets (마이크로소프트 컨테이너 서비스/플릿)

이름 설명 가치
정체성 관리 ID입니다. ManagedServiceIdentity
위치 리소스가 있는 지리적 위치 string(필수)
이름 리소스 이름 문자열

제약 조건:
최소 길이 = 1
최대 길이 = 63
패턴 = ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$(필수)
속성 이 리소스에 대한 리소스별 속성입니다. 플릿프로퍼티
scope 배포 범위와 다른 범위에서 리소스를 만들 때 사용합니다. 이 속성을 리소스의 기호 이름으로 설정하여 확장 리소스를 적용합니다.
태그 리소스 태그 태그 이름 및 값의 사전입니다. 템플릿 태그를 참조하세요.

상담원 프로필

이름 설명 가치
서브넷 ID Fleet 허브 노드가 시작할 때 조인할 서브넷의 ID입니다. 지정하지 않으면 vnet 및 서브넷이 생성되고 사용됩니다. 문자열
vm크기 Fleet 허브의 가상 머신 크기입니다. 문자열

APIServerAccessProfile

이름 설명 가치
enablePrivateCluster Fleet 허브를 프라이빗 클러스터로 만들지 여부입니다. bool
enableVnetIntegration Fleet 허브에 apiserver vnet 통합을 사용하도록 설정할지 여부입니다. bool
서브넷 ID apiserver vnet 통합을 사용할 때 사용할 서브넷입니다. BYO vnet을 사용하여 새 Fleet를 만들 때 필요합니다. 문자열

플릿허브프로필

이름 설명 가치
상담원프로필 Fleet 허브의 에이전트 프로필입니다. 상담원 프로필
apiServerAccessProfile Fleet 허브 API 서버에 대한 액세스 프로필입니다. APIServerAccessProfile
dns접두사 Fleet 허브에 대한 FQDN을 만드는 데 사용되는 DNS 접두사입니다. 문자열

제약 조건:
최소 길이 = 1
최대 길이 = 54
패턴 = ^[a-zA-Z0-9]$|^[a-zA-Z0-9][a-zA-Z0-9-]{0,52}[a-zA-Z0-9]$

플릿프로퍼티

이름 설명 가치
허브프로필 FleetHubProfile은 Fleet의 허브를 구성합니다. 플릿허브프로필

ManagedServiceIdentity (관리형 서비스 ID)

이름 설명 가치
유형 관리 서비스 ID의 유형입니다(SystemAssigned 및 UserAssigned 형식이 모두 허용되는 경우). '없음'
'시스템 할당됨'
'시스템 할당, 사용자 할당'
'UserAssigned'(필수)
userAssignedIdentities 리소스와 연결된 사용자 할당 ID 집합입니다. userAssignedIdentities 사전 키는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} 형식의 ARM 리소스 ID입니다. 사전 값은 요청에서 빈 개체({})일 수 있습니다. UserAssignedIdentities

TrackedResource태그

이름 설명 가치

UserAssignedIdentities

이름 설명 가치

사용자 할당 ID

이름 설명 가치

사용 예제

Azure 빠른 시작 샘플

다음 Azure 빠른 시작 템플릿에는 이 리소스 유형을 배포하기 위한 Bicep 샘플이 포함되어 있습니다.

Bicep 파일 설명
Azure Kubernetes 플릿 관리자 Azure Kubernetes Fleet Manager를 사용하여 프라이빗 Hubful 플릿 배포
Azure Kubernetes 플릿 관리자 Azure Kubernetes Fleet Manager를 사용하여 Hubful 플릿 배포
Azure Kubernetes 플릿 관리자 Azure Kubernetes Fleet Manager를 사용하여 허브리스 플릿 배포

ARM 템플릿 리소스 정의

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

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

리소스 형식

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

{
  "type": "Microsoft.ContainerService/fleets",
  "apiVersion": "2025-08-01-preview",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "hubProfile": {
      "agentProfile": {
        "subnetId": "string",
        "vmSize": "string"
      },
      "apiServerAccessProfile": {
        "enablePrivateCluster": "bool",
        "enableVnetIntegration": "bool",
        "subnetId": "string"
      },
      "dnsPrefix": "string"
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

속성 값

Microsoft.ContainerService/fleets (마이크로소프트 컨테이너 서비스/플릿)

이름 설명 가치
API버전 api 버전 '2025-08-01-미리보기'
정체성 관리 ID입니다. ManagedServiceIdentity
위치 리소스가 있는 지리적 위치 string(필수)
이름 리소스 이름 문자열

제약 조건:
최소 길이 = 1
최대 길이 = 63
패턴 = ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$(필수)
속성 이 리소스에 대한 리소스별 속성입니다. 플릿프로퍼티
태그 리소스 태그 태그 이름 및 값의 사전입니다. 템플릿 태그를 참조하세요.
유형 리소스 종류 'Microsoft.ContainerService/플릿'

상담원 프로필

이름 설명 가치
서브넷 ID Fleet 허브 노드가 시작할 때 조인할 서브넷의 ID입니다. 지정하지 않으면 vnet 및 서브넷이 생성되고 사용됩니다. 문자열
vm크기 Fleet 허브의 가상 머신 크기입니다. 문자열

APIServerAccessProfile

이름 설명 가치
enablePrivateCluster Fleet 허브를 프라이빗 클러스터로 만들지 여부입니다. bool
enableVnetIntegration Fleet 허브에 apiserver vnet 통합을 사용하도록 설정할지 여부입니다. bool
서브넷 ID apiserver vnet 통합을 사용할 때 사용할 서브넷입니다. BYO vnet을 사용하여 새 Fleet를 만들 때 필요합니다. 문자열

플릿허브프로필

이름 설명 가치
상담원프로필 Fleet 허브의 에이전트 프로필입니다. 상담원 프로필
apiServerAccessProfile Fleet 허브 API 서버에 대한 액세스 프로필입니다. APIServerAccessProfile
dns접두사 Fleet 허브에 대한 FQDN을 만드는 데 사용되는 DNS 접두사입니다. 문자열

제약 조건:
최소 길이 = 1
최대 길이 = 54
패턴 = ^[a-zA-Z0-9]$|^[a-zA-Z0-9][a-zA-Z0-9-]{0,52}[a-zA-Z0-9]$

플릿프로퍼티

이름 설명 가치
허브프로필 FleetHubProfile은 Fleet의 허브를 구성합니다. 플릿허브프로필

ManagedServiceIdentity (관리형 서비스 ID)

이름 설명 가치
유형 관리 서비스 ID의 유형입니다(SystemAssigned 및 UserAssigned 형식이 모두 허용되는 경우). '없음'
'시스템 할당됨'
'시스템 할당, 사용자 할당'
'UserAssigned'(필수)
userAssignedIdentities 리소스와 연결된 사용자 할당 ID 집합입니다. userAssignedIdentities 사전 키는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} 형식의 ARM 리소스 ID입니다. 사전 값은 요청에서 빈 개체({})일 수 있습니다. UserAssignedIdentities

TrackedResource태그

이름 설명 가치

UserAssignedIdentities

이름 설명 가치

사용자 할당 ID

이름 설명 가치

사용 예제

Azure 빠른 시작 템플릿

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

Template 설명
Azure Kubernetes 플릿 관리자

Azure에 배포
Azure Kubernetes Fleet Manager를 사용하여 프라이빗 Hubful 플릿 배포
Azure Kubernetes 플릿 관리자

Azure에 배포
Azure Kubernetes Fleet Manager를 사용하여 Hubful 플릿 배포
Azure Kubernetes 플릿 관리자

Azure에 배포
Azure Kubernetes Fleet Manager를 사용하여 허브리스 플릿 배포

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

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

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

리소스 형식

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ContainerService/fleets@2025-08-01-preview"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      hubProfile = {
        agentProfile = {
          subnetId = "string"
          vmSize = "string"
        }
        apiServerAccessProfile = {
          enablePrivateCluster = bool
          enableVnetIntegration = bool
          subnetId = "string"
        }
        dnsPrefix = "string"
      }
    }
  }
}

속성 값

Microsoft.ContainerService/fleets (마이크로소프트 컨테이너 서비스/플릿)

이름 설명 가치
정체성 관리 ID입니다. ManagedServiceIdentity
위치 리소스가 있는 지리적 위치 string(필수)
이름 리소스 이름 문자열

제약 조건:
최소 길이 = 1
최대 길이 = 63
패턴 = ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$(필수)
parent_id 이 확장 리소스를 적용할 리소스의 ID입니다. string(필수)
속성 이 리소스에 대한 리소스별 속성입니다. 플릿프로퍼티
태그 리소스 태그 태그 이름 및 값의 사전입니다.
유형 리소스 종류 "Microsoft.ContainerService/fleets@2025-08-01-preview"

상담원 프로필

이름 설명 가치
서브넷 ID Fleet 허브 노드가 시작할 때 조인할 서브넷의 ID입니다. 지정하지 않으면 vnet 및 서브넷이 생성되고 사용됩니다. 문자열
vm크기 Fleet 허브의 가상 머신 크기입니다. 문자열

APIServerAccessProfile

이름 설명 가치
enablePrivateCluster Fleet 허브를 프라이빗 클러스터로 만들지 여부입니다. bool
enableVnetIntegration Fleet 허브에 apiserver vnet 통합을 사용하도록 설정할지 여부입니다. bool
서브넷 ID apiserver vnet 통합을 사용할 때 사용할 서브넷입니다. BYO vnet을 사용하여 새 Fleet를 만들 때 필요합니다. 문자열

플릿허브프로필

이름 설명 가치
상담원프로필 Fleet 허브의 에이전트 프로필입니다. 상담원 프로필
apiServerAccessProfile Fleet 허브 API 서버에 대한 액세스 프로필입니다. APIServerAccessProfile
dns접두사 Fleet 허브에 대한 FQDN을 만드는 데 사용되는 DNS 접두사입니다. 문자열

제약 조건:
최소 길이 = 1
최대 길이 = 54
패턴 = ^[a-zA-Z0-9]$|^[a-zA-Z0-9][a-zA-Z0-9-]{0,52}[a-zA-Z0-9]$

플릿프로퍼티

이름 설명 가치
허브프로필 FleetHubProfile은 Fleet의 허브를 구성합니다. 플릿허브프로필

ManagedServiceIdentity (관리형 서비스 ID)

이름 설명 가치
유형 관리 서비스 ID의 유형입니다(SystemAssigned 및 UserAssigned 형식이 모두 허용되는 경우). '없음'
'시스템 할당됨'
'시스템 할당, 사용자 할당'
'UserAssigned'(필수)
userAssignedIdentities 리소스와 연결된 사용자 할당 ID 집합입니다. userAssignedIdentities 사전 키는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} 형식의 ARM 리소스 ID입니다. 사전 값은 요청에서 빈 개체({})일 수 있습니다. UserAssignedIdentities

TrackedResource태그

이름 설명 가치

UserAssignedIdentities

이름 설명 가치

사용자 할당 ID

이름 설명 가치

사용 예제

Terraform 샘플

Kubernetes Fleet Manager 배포의 기본 예입니다.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westus"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "fleet" {
  type      = "Microsoft.ContainerService/fleets@2024-04-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {}
  }
}