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 Kubernetes Fleet Manager를 사용하여 프라이빗 Hubful 플릿 배포 |
|
Azure Kubernetes 플릿 관리자 |
Azure Kubernetes Fleet Manager를 사용하여 Hubful 플릿 배포 |
|
Azure Kubernetes 플릿 관리자 |
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 = {}
}
}