- Latest
- 2025-09-01
- 2025-08-02-プレビュー
- 2025-08-01
- 2025-07-02-プレビュー
- 2025-07-01
- 2025-06-02-プレビュー
- 2025-05-02-preview
- 2025-05-01
- 2025-04-02-preview
- 2025-04-01
- 2025-03-02-preview
- 2025-03-01
- 2025-02-02-preview
- 2025-02-01
- 2025-01-02-preview
- 2025-01-01
- 2024-10-02-preview
- 2024-10-01
- 2024-09-02-preview
- 2024-09-01
- 2024-08-01
- 2024-07-02-preview
- 2024-07-01
- 2024-06-02-preview
- 2024-05-02-preview
- 2024-05-01
- 2024-04-02-preview
- 2024-03-02-preview
- 2024-02-02-preview
- 2024-02-01
- 2024-01-02-preview
- 2024-01-01
- 2023-11-02-preview
- 2023-11-01
- 2023-10-02-preview
- 2023-10-01
- 2023-09-02-preview
- 2023-09-01
- 2023-08-02-preview
- 2023-08-01
- 2023-07-02-preview
- 2023-07-01
- 2023-06-02-preview
- 2023-06-01
- 2023-05-02-preview
- 2023-05-01
- 2023-04-02-preview
- 2023-04-01
- 2023-03-02-preview
- 2023-03-01
- 2023-02-02-preview
- 2023-02-01
- 2023-01-02-preview
- 2023-01-01
- 2022-11-02-preview
- 2022-11-01
- 2022-10-02-preview
- 2022-09-02-preview
- 2022-09-01
- 2022-08-03-preview
- 2022-08-02-preview
- 2022-07-02-preview
- 2022-07-01
- 2022-06-02-preview
- 2022-06-01
- 2022-05-02-preview
- 2022-04-02-preview
- 2022-04-01
- 2022-03-02-preview
- 2022-03-01
- 2022-02-02-preview
- 2022-02-01
- 2022-01-02-preview
- 2022-01-01
- 2021-11-01-preview
- 2021-10-01
- 2021-09-01
- 2021-08-01
- 2021-07-01
- 2021-05-01
- 2021-03-01
- 2021-02-01
- 2020-12-01
- 2020-11-01
- 2020-09-01
- 2020-07-01
- 2020-06-01
- 2020-04-01
- 2020-03-01
- 2020-02-01
- 2020-01-01
- 2019-11-01
- 2019-10-01
- 2019-08-01
- 2019-06-01
- 2019-04-01
- 2019-02-01
- 2018-08-01-preview
- 2018-03-31
- 2017-08-31
Remarks
使用可能なアドオンの詳細については、「 アドオン、拡張機能、および Azure Kubernetes Service とのその他の統合」を参照してください。
Bicep リソース定義
managedClusters リソースの種類は、次を対象とする操作と共にデプロイできます。
各 API バージョンで変更されたプロパティの一覧については、変更ログの
リソースの形式
Microsoft.ContainerService/managedClusters リソースを作成するには、次の Bicep をテンプレートに追加します。
resource symbolicname 'Microsoft.ContainerService/managedClusters@2023-02-02-preview' = {
scope: resourceSymbolicName or scope
extendedLocation: {
name: 'string'
type: 'string'
}
identity: {
type: 'string'
userAssignedIdentities: {
{customized property}: {}
}
}
location: 'string'
name: 'string'
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'
]
capacityReservationGroupID: 'string'
count: int
creationData: {
sourceResourceId: 'string'
}
enableAutoScaling: bool
enableCustomCATrust: 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
messageOfTheDay: 'string'
minCount: int
mode: 'string'
name: 'string'
networkProfile: {
allowedHostPorts: [
{
portEnd: int
portStart: int
protocol: 'string'
}
]
applicationSecurityGroups: [
'string'
]
nodePublicIPTags: [
{
ipTagType: 'string'
tag: '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: int
tags: {
{customized property}: 'string'
}
type: 'string'
upgradeSettings: {
maxSurge: 'string'
}
vmSize: 'string'
vnetSubnetID: 'string'
windowsProfile: {
disableOutboundNat: bool
}
workloadRuntime: 'string'
}
]
apiServerAccessProfile: {
authorizedIPRanges: [
'string'
]
disableRunCommand: bool
enablePrivateCluster: bool
enablePrivateClusterPublicFQDN: bool
enableVnetIntegration: bool
privateDNSZone: 'string'
subnetId: '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: {
nodeOSUpgradeChannel: 'string'
upgradeChannel: 'string'
}
azureMonitorProfile: {
metrics: {
enabled: bool
kubeStateMetrics: {
metricAnnotationsAllowList: 'string'
metricLabelsAllowlist: 'string'
}
}
}
creationData: {
sourceResourceId: 'string'
}
disableLocalAccounts: bool
diskEncryptionSetID: 'string'
dnsPrefix: 'string'
enableNamespaceResources: bool
enablePodSecurityPolicy: bool
enableRBAC: bool
fqdnSubdomain: 'string'
guardrailsProfile: {
excludedNamespaces: [
'string'
]
level: 'string'
version: 'string'
}
httpProxyConfig: {
httpProxy: 'string'
httpsProxy: 'string'
noProxy: [
'string'
]
trustedCa: 'string'
}
identityProfile: {
{customized property}: {
clientId: 'string'
objectId: 'string'
resourceId: 'string'
}
}
ingressProfile: {
webAppRouting: {
dnsZoneResourceId: 'string'
enabled: bool
}
}
kubernetesVersion: 'string'
linuxProfile: {
adminUsername: 'string'
ssh: {
publicKeys: [
{
keyData: 'string'
}
]
}
}
networkProfile: {
dnsServiceIP: 'string'
dockerBridgeCidr: 'string'
ipFamilies: [
'string'
]
kubeProxyConfig: {
enabled: bool
ipvsConfig: {
scheduler: 'string'
tcpFinTimeoutSeconds: int
tcpTimeoutSeconds: int
udpTimeoutSeconds: int
}
mode: 'string'
}
loadBalancerProfile: {
allocatedOutboundPorts: int
backendPoolType: 'string'
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
}
}
networkDataplane: 'string'
networkMode: 'string'
networkPlugin: 'string'
networkPluginMode: 'string'
networkPolicy: 'string'
outboundType: 'string'
podCidr: 'string'
podCidrs: [
'string'
]
serviceCidr: 'string'
serviceCidrs: [
'string'
]
}
nodeResourceGroup: 'string'
nodeResourceGroupProfile: {
restrictionLevel: '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'
}
customCATrustCertificates: [
any(...)
]
defender: {
logAnalyticsWorkspaceResourceId: 'string'
securityMonitoring: {
enabled: bool
}
}
imageCleaner: {
enabled: bool
intervalHours: int
}
nodeRestriction: {
enabled: bool
}
workloadIdentity: {
enabled: bool
}
}
serviceMeshProfile: {
istio: {
components: {
ingressGateways: [
{
enabled: bool
mode: 'string'
}
]
}
}
mode: 'string'
}
servicePrincipalProfile: {
clientId: 'string'
secret: 'string'
}
storageProfile: {
blobCSIDriver: {
enabled: bool
}
diskCSIDriver: {
enabled: bool
version: 'string'
}
fileCSIDriver: {
enabled: bool
}
snapshotController: {
enabled: bool
}
}
upgradeSettings: {
overrideSettings: {
controlPlaneOverrides: [
'string'
]
until: 'string'
}
}
windowsProfile: {
adminPassword: 'string'
adminUsername: 'string'
enableCSIProxy: bool
gmsaProfile: {
dnsServer: 'string'
enabled: bool
rootDomainName: 'string'
}
licenseType: 'string'
}
workloadAutoScalerProfile: {
keda: {
enabled: bool
}
verticalPodAutoscaler: {
controlledValues: 'string'
enabled: bool
updateMode: 'string'
}
}
}
sku: {
name: 'string'
tier: 'string'
}
tags: {
{customized property}: 'string'
}
}
プロパティ値
Microsoft.ContainerService/managedClusters
| Name | Description | Value |
|---|---|---|
| extendedLocation | 仮想マシンの拡張された場所。 | ExtendedLocation |
| ID | マネージド クラスターの ID (構成されている場合)。 | ManagedClusterIdentity |
| 位置 | リソースが存在する地理的な場所 | string (必須) |
| name | リソース名 | string Constraints: 最小長 = 1 最大長 = 63 パターン = ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-_a-zA-Z0-9]{0,61}[a-zA-Z0-9]$ (必須) |
| properties | マネージド クラスターのプロパティ。 | ManagedClusterProperties |
| スコープ | デプロイ スコープとは異なるスコープでリソースを作成するときに使用します。 | このプロパティをリソースのシンボリック名に設定して、拡張リソースを適用します。 |
| sku | マネージド クラスター SKU。 | ManagedClusterSKU |
| tags | リソース タグ | タグ名と値のディクショナリ。 テンプレート の |
AgentPoolNetworkProfile
| Name | Description | Value |
|---|---|---|
| allowedHostPorts | アクセスが許可されているポート範囲。 指定した範囲は重複できます。 | PortRange[] |
| applicationSecurityGroups | エージェント プールの作成時に関連付けるアプリケーション セキュリティ グループの ID。 | string[] |
| nodePublicIPTags | インスタンス レベルのパブリック IP の IP タグ。 | IPTag[] |
AgentPoolUpgradeSettings
| Name | Description | Value |
|---|---|---|
| maxSurge | これは、整数 (例: '5') またはパーセンテージ (例: '50%') に設定できます。 パーセンテージを指定すると、アップグレード時のエージェント・プール・サイズの合計に対するパーセンテージになります。 パーセンテージの場合、小数部のノードは切り上げられます。 指定しない場合、既定値は 1 です。 ベスト プラクティスを含む詳細については、「/azure/aks/upgrade-cluster#customize-node-surge-upgrade」を参照してください。 | 文字列 |
AgentPoolWindowsProfile
| Name | Description | Value |
|---|---|---|
| disableOutboundNat | 既定値は false です。 送信 NAT を無効にできるのは、クラスターの outboundType が NAT ゲートウェイであり、Windows エージェント プールでノード パブリック IP が有効になっていない場合のみです。 | bool |
AzureKeyVaultKms
| Name | Description | Value |
|---|---|---|
| enabled | 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されている場合は、フィールドを空のままにします。 |
文字列 |
ClusterUpgradeSettings
| Name | Description | Value |
|---|---|---|
| overrideSettings | オーバーライドの設定。 | UpgradeOverrideSettings |
ContainerServiceLinuxProfile
| Name | Description | Value |
|---|---|---|
| adminUsername | Linux VM に使用する管理者ユーザー名。 | string Constraints: パターン = ^[A-Za-z][-A-Za-z0-9_]*$ (必須) |
| ssh | Azure で実行されている Linux ベースの VM の SSH 構成。 | ContainerServiceSshConfiguration (必須) |
ContainerServiceNetworkProfile
| Name | Description | Value |
|---|---|---|
| dnsServiceIP | Kubernetes DNS サービスに割り当てられた IP アドレス。 これは、serviceCidr で指定された Kubernetes サービス アドレス範囲内にある必要があります。 | string Constraints: パターン = ^(?:(?: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 Constraints: パターン = ^([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' |
| kubeProxyConfig | kube-proxy の構成のカスタマイズを保持します。 定義されていない値は、kube-proxy の既定の動作を使用します。 https://v<バージョン>.docs.kubernetes.io/docs/reference/command-line-tools-reference/kube-proxy/ を参照してください。 <version> は <バージョン>-<minor バージョン> 文字列で表されます。 Kubernetes バージョン 1.23 は '1-23' になります。 | ContainerServiceNetworkProfileKubeProxyConfig |
| loadBalancerProfile | クラスター ロード バランサーのプロファイル。 | ManagedClusterLoadBalancerProfile |
| loadBalancerSku | 既定値は 'standard' です。 ロード バランサー SKU の違いの詳細については、Azure Load Balancer SKU に関するページを参照してください。 | 'basic' 'standard' |
| natGatewayProfile | クラスター NAT ゲートウェイのプロファイル。 | ManagedClusterNATGatewayProfile |
| networkDataplane | Kubernetes クラスターで使用されるネットワーク データプレーン。 | 'azure' 'cilium' |
| networkMode | networkPlugin が 'azure' 以外の場合は、これを指定できません。 | 'bridge' 'transparent' |
| networkPlugin | Kubernetes ネットワークの構築に使用されるネットワーク プラグイン。 | 'azure' 'kubenet' 'none' |
| networkPluginMode | Kubernetes ネットワークの構築に使用されるネットワーク プラグイン モード。 | 'Overlay' |
| networkPolicy | Kubernetes ネットワークの構築に使用されるネットワーク ポリシー。 | 'azure' 'calico' 'cilium' |
| outboundType | これはクラスター作成時にのみ設定でき、後で変更することはできません。 詳細については、 エグレス送信の種類を参照してください。 | 'loadBalancer' 'managedNATGateway' 'userAssignedNATGateway' 'userDefinedRouting' |
| podCidr | kubenet の使用時にポッド IP を割り当てる CIDR 表記 IP 範囲。 | string Constraints: パターン = ^([0-9]{1,3}\.){3}[0-9]{1,3}(\/([0-9]|[1-2][0-9]|3[0-2]))?$ |
| podCidrs | 単一スタック ネットワークでは、1 つの IPv4 CIDR が必要です。 デュアルスタック ネットワークでは、2 つの CIDR (各 IP ファミリ (IPv4/IPv6) に 1 つ) が必要です。 | string[] |
| serviceCidr | サービス クラスター IP を割り当てる CIDR 表記 IP 範囲。 サブネット IP 範囲と重複しないようにする必要があります。 | string Constraints: パターン = ^([0-9]{1,3}\.){3}[0-9]{1,3}(\/([0-9]|[1-2][0-9]|3[0-2]))?$ |
| serviceCidrs | 単一スタック ネットワークでは、1 つの IPv4 CIDR が必要です。 デュアルスタック ネットワークでは、2 つの CIDR (各 IP ファミリ (IPv4/IPv6) に 1 つ) が必要です。 サブネット IP 範囲と重複しないようにする必要があります。 | string[] |
ContainerServiceNetworkProfileKubeProxyConfig
| Name | Description | Value |
|---|---|---|
| enabled | クラスター上の kube-proxy で有効にするかどうかを指定します ('kubeProxyConfig' が存在しない場合、kube-proxy は既定でこれらのカスタマイズなしで AKS で有効になります)。 | bool |
| ipvsConfig | IPVS の構成のカスタマイズを保持します。 'mode' が 'IPVS' に設定されている場合にのみ指定できます。 | ContainerServiceNetworkProfileKubeProxyConfigIpvsConfig |
| mode | 使用するプロキシ モード ('IPTABLES' または 'IPVS') を指定する | 'IPTABLES' 'IPVS' |
ContainerServiceNetworkProfileKubeProxyConfigIpvsConfig
| Name | Description | Value |
|---|---|---|
| scheduler | IPVS スケジューラの詳細については、 http://www.linuxvirtualserver.org/docs/scheduling.htmlを参照してください。 | 'LeastConnection' 'RoundRobin' |
| tcpFinTimeoutSeconds | FIN を受信した後の IPVS TCP セッションに使用されるタイムアウト値 (秒単位)。 正の整数値である必要があります。 | int |
| tcpTimeoutSeconds | アイドル状態の IPVS TCP セッションに使用されるタイムアウト値 (秒単位)。 正の整数値である必要があります。 | int |
| udpTimeoutSeconds | IPVS UDP パケットに使用されるタイムアウト値 (秒単位)。 正の整数値である必要があります。 | int |
ContainerServiceSshConfiguration
| Name | Description | Value |
|---|---|---|
| publicKeys | Linux ベースの VM での認証に使用される SSH 公開キーの一覧。 最大 1 つのキーを指定できます。 | ContainerServiceSshPublicKey[] (必須) |
ContainerServiceSshPublicKey
| Name | Description | Value |
|---|---|---|
| keyData | SSH 経由で VM で認証するために使用される証明書公開キー。 証明書は、ヘッダーの有無にかかわらず PEM 形式である必要があります。 | string (必須) |
CreationData
| Name | Description | Value |
|---|---|---|
| sourceResourceId | これは、ターゲット オブジェクトの作成に使用するソース オブジェクトの ARM ID です。 | 文字列 |
ExtendedLocation
| Name | Description | Value |
|---|---|---|
| name | 拡張された場所の名前。 | 文字列 |
| 型 | 拡張された場所の種類。 | 'EdgeZone' |
GuardrailsProfile
| Name | Description | Value |
|---|---|---|
| excludedNamespaces | ガードレール チェックから除外される名前空間の一覧 | string[] |
| レベル | 使用するガードレール レベル。 既定では、AKS が systemExcludedNamespaces 経由で除外する名前空間を除くすべての名前空間に対して Guardrails が有効になっています | 'Enforcement' 'Off' '警告' (必須) |
| バージョン | 使用する制約のバージョン | string (必須) |
IPTag
| Name | Description | Value |
|---|---|---|
| ipTagType | IP タグの種類。 例: RoutingPreference。 | 文字列 |
| タグ | パブリック IP に関連付けられている IP タグの値。 例: インターネット。 | 文字列 |
IstioComponents
| Name | Description | Value |
|---|---|---|
| ingressGateways | Istio イングレス ゲートウェイ。 | IstioIngressGateway[] |
IstioIngressGateway
| Name | Description | Value |
|---|---|---|
| enabled | イングレス ゲートウェイを有効にするかどうか。 | bool (必須) |
| mode | イングレス ゲートウェイのモード。 | 'External' 'Internal' (必須) |
IstioServiceMesh
| Name | Description | Value |
|---|---|---|
| components | Istio コンポーネントの構成。 | IstioComponents |
KubeletConfig
| Name | Description | Value |
|---|---|---|
| allowedUnsafeSysctls | 安全でない sysctl または安全でない sysctl パターンの許可されたリスト ( *で終わる)。 |
string[] |
| containerLogMaxFiles | コンテナーに存在できるコンテナー ログ ファイルの最大数。 数値は 2 ≥する必要があります。 | int Constraints: 最小値 = 2 |
| containerLogMaxSizeMB | ローテーション前のコンテナー ログ ファイルの最大サイズ (10Mi など)。 | int |
| cpuCfsQuota | 既定値は true です。 | bool |
| cpuCfsQuotaPeriod | 既定値は '100 ミリ秒' です。 有効な値は、省略可能な分数と単位サフィックスを持つ 10 進数のシーケンスです。 例: '300ms'、'2h45m'。 サポートされるユニットは、'ns'、'us'、'ms'、's'、'm'、および 'h' です。 | 文字列 |
| cpuManagerPolicy | 既定値は 'none' です。 詳細については、 Kubernetes CPU 管理ポリシーを 参照してください。 使用できる値は 'none' と 'static' です。 | 文字列 |
| failSwapOn | true に設定すると、ノードでスワップが有効になっている場合、Kubelet の起動に失敗します。 | bool |
| imageGcHighThreshold | イメージ ガベージ コレクションを無効にするには、100 に設定します。 既定値は 85% | int |
| imageGcLowThreshold | imageGcHighThreshold より高く設定することはできません。 既定値は 80% | int |
| podMaxPids | ポッドあたりのプロセスの最大数。 | int |
| topologyManagerPolicy | 詳細については、「 Kubernetes Topology Manager」を参照してください。 既定値は 'none' です。 使用できる値は、'none'、'best-effort'、'restricted'、および 'single-numa-node' です。 | 文字列 |
LinuxOSConfig
| Name | Description | Value |
|---|---|---|
| swapFileSizeMB | 各ノードに作成されるスワップ ファイルのサイズ (MB)。 | int |
| sysctls | Linux エージェント ノードの Sysctl 設定。 | SysctlConfig |
| transparentHugePageDefrag | 有効な値は、'always'、'defer'、'defer+madvise'、'madvise' および 'never' です。 既定値は 'madvise' です。 詳細については、「Transparent Hugepages」を参照してください。 | 文字列 |
| transparentHugePageEnabled | 有効な値は、'always'、'madvise'、および 'never' です。 既定値は "always" です。 詳細については、「Transparent Hugepages」を参照してください。 | 文字列 |
ManagedClusterAADProfile
| Name | Description | Value |
|---|---|---|
| adminGroupObjectIDs | クラスターの管理者ロールを持つ AAD グループ オブジェクト ID の一覧。 | string[] |
| clientAppID | (非推奨)クライアント AAD アプリケーション ID。 詳細については、https://aka.ms/aks/aad-legacyを参照してください。 | 文字列 |
| enableAzureRBAC | Kubernetes 承認に対して Azure RBAC を有効にするかどうかを指定します。 | bool |
| マネージ | マネージド AAD を有効にするかどうか。 | bool |
| serverAppID | (非推奨)サーバー AAD アプリケーション ID。 詳細については、https://aka.ms/aks/aad-legacyを参照してください。 | 文字列 |
| serverAppSecret | (非推奨)サーバー AAD アプリケーション シークレット。 詳細については、https://aka.ms/aks/aad-legacyを参照してください。 | 文字列 |
| tenantID | 認証に使用する AAD テナント ID。 指定しない場合は、デプロイ サブスクリプションのテナントを使用します。 | 文字列 |
ManagedClusterAddonProfile
| Name | Description | Value |
|---|---|---|
| config | アドオンを構成するためのキーと値のペア。 | ManagedClusterAddonProfileConfig |
| enabled | アドオンが有効かどうか。 | bool (必須) |
ManagedClusterAddonProfileConfig
| Name | Description | Value |
|---|
ManagedClusterAgentPoolProfile
| Name | Description | Value |
|---|---|---|
| availabilityZones | ノードに使用する可用性ゾーンの一覧。 これは、AgentPoolType プロパティが 'VirtualMachineScaleSets' の場合にのみ指定できます。 | string[] |
| capacityReservationGroupID | AKS は、指定されたエージェント プールを容量予約グループに関連付けます。 | 文字列 |
| count | Docker コンテナーをホストするエージェント (VM) の数。 使用できる値は、ユーザー プールの場合は 0 から 1000 (含む) の範囲、システム プールの場合は 1 から 1000 (含む) の範囲である必要があります。 既定値は 1 です。 | int |
| creationData | スナップショットを使用してノード プールを作成またはアップグレードする場合に、ソース スナップショット ID を指定するために使用する CreationData。 | CreationData |
| enableAutoScaling | 自動スケーラーを有効にするかどうか | bool |
| enableCustomCATrust | true に設定すると、AKS は機能が有効になっていることを示すラベルをノードに追加し、ホスト サービスと共にデーモンセットをデプロイして、base64 でエンコードされた証明書のユーザー指定リストからノード信頼ストアにカスタム証明機関を同期します。 既定値は false です。 | bool |
| enableEncryptionAtHost | これは、特定の VM サイズと特定の Azure リージョンでのみサポートされます。 詳細については、「/azure/aks/enable-host-encryption」を参照してください。 | bool |
| enableFIPS | 詳細については 、FIPS 対応ノード プールの追加 を参照してください。 | bool |
| enableNodePublicIP | シナリオによっては、ノード プール内のノードが独自の専用パブリック IP アドレスを受け取る必要がある場合があります。 一般的なシナリオは、ホップを最小限に抑えるために、コンソールがクラウド仮想マシンに直接接続する必要があるゲーム ワークロードです。 詳細については、 ノードごとのパブリック IP の割り当てを参照してください。 既定値は false です。 | bool |
| enableUltraSSD | UltraSSD を有効にするかどうか | bool |
| gpuInstanceProfile | サポートされている GPU VM SKU の GPU MIG インスタンス プロファイルを指定するために使用される GPUInstanceProfile。 | 'MIG1g' 'MIG2g' 'MIG3g' 'MIG4g' 'MIG7g' |
| hostGroupID | 形式は /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}です。 詳細については、 Azure 専用ホストに関するページを参照してください。 | 文字列 |
| kubeletConfig | エージェント プール ノード上の Kubelet 構成。 | KubeletConfig |
| kubeletDiskType | emptyDir ボリューム、コンテナー ランタイム データ ルート、および Kubelet エフェメラル ストレージの配置を決定します。 | 'OS' 'Temporary' |
| linuxOSConfig | Linux エージェント ノードの OS 構成。 | LinuxOSConfig |
| maxCount | 自動スケーリングのノードの最大数 | int |
| maxPods | ノードで実行できるポッドの最大数。 | int |
| messageOfTheDay | デコード後に /etc/motd に書き込まれる base64 でエンコードされた文字列。 これにより、Linux ノードに対するその日のメッセージをカスタマイズできます。 Windows ノードには指定しないでください。 静的文字列である必要があります (つまり、生で出力され、スクリプトとして実行されません)。 | 文字列 |
| minCount | 自動スケーリング用のノードの最小数 | int |
| mode | クラスターには、常に少なくとも 1 つの "システム" エージェント プールが必要です。 エージェント プールの制限とベスト プラクティスの詳細については、/azure/aks/use-system-pools を参照してください。 | 'System' 'User' |
| name | Windows エージェント プール名は 6 文字以下にする必要があります。 | string Constraints: パターン = ^[a-z][a-z0-9]{0,11}$ (必須) |
| networkProfile | エージェント プールのネットワーク関連の設定。 | AgentPoolNetworkProfile |
| nodeLabels | エージェント プール内のすべてのノードにわたって保持されるノード ラベル。 | ManagedClusterAgentPoolProfilePropertiesNodeLabels |
| nodePublicIPPrefixID | これは、/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName} の形式です。 | 文字列 |
| nodeTaints | ノード プールの作成とスケーリング中に新しいノードに追加されたテイント。 たとえば、key=value:NoSchedule です。 | string[] |
| orchestratorVersion | パッチ バージョン <major.minor.patch> と <major.minor> の両方がサポートされています。 <major.minor>を指定すると、サポートされている最新のパッチ バージョンが自動的に選択されます。 エージェント プールを同じ <major.minor> を作成した後に更新しても、新しいパッチ バージョンが使用可能な場合でもアップグレードはトリガーされません。 ベスト プラクティスとして、AKS クラスター内のすべてのノード プールを同じ Kubernetes バージョンにアップグレードする必要があります。 ノード プールのバージョンには、コントロール プレーンと同じメジャー バージョンが必要です。 ノード プールのマイナー バージョンは、コントロール プレーン バージョンの 2 つのマイナー バージョン内にある必要があります。 ノード プールのバージョンをコントロール プレーンのバージョンより大きくすることはできません。 詳細については、 ノード・プールのアップグレードを参照してください。 | 文字列 |
| osDiskSizeGB | マスター/エージェント プール内のすべてのマシンのディスク サイズを指定するために使用する OS ディスク サイズ (GB)。 0 を指定すると、指定された vmSize に従って既定の osDisk サイズが適用されます。 | int Constraints: 最小値 = 0 最大値 = 2048 |
| osDiskType | VM でサポートされていて、要求された OSDiskSizeGB より大きいキャッシュ ディスクがある場合、既定値は "エフェメラル" です。 それ以外の場合、既定値は 'Managed' です。 作成後に変更できない場合があります。 詳細については、「エフェメラル OS を参照してください。 | 'Ephemeral' 'Managed' |
| osSKU | エージェント プールで使用される OS SKU を指定します。 指定しない場合、既定値は OSType=Linux の場合は Ubuntu、OSType=Windows の場合は Windows2019 です。 また、Windows 2019 が非推奨になった後、既定の Windows OSSKU が Windows2022 に変更されます。 | 'CBLMariner' 'Mariner' 'Ubuntu' 'Windows2019' 'Windows2022' |
| osType | オペレーティング システムの種類。 既定値は Linux です。 | 'Linux' 'Windows' |
| podSubnetID | 省略すると、ポッド IP はノード サブネットに静的に割り当てられます (詳細については、vnetSubnetID を参照してください)。 これは、/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} の形式です。 | 文字列 |
| powerState | エージェント プールが最初に作成されるときは、最初に実行中です。 エージェント プールは、このフィールドを [停止済み] に設定することで停止できます。 停止したエージェント プールは、すべての VM を停止し、課金料金は発生しません。 エージェント プールは、実行中でプロビジョニング状態が成功した場合にのみ停止できます | PowerState |
| proximityPlacementGroupID | 近接通信配置グループの ID。 | 文字列 |
| scaleDownMode | これは、クラスターオートスケーラーの動作にも影響します。 指定しない場合は、既定で Delete に設定されます。 | 'Deallocate' 'Delete' |
| scaleSetEvictionPolicy | scaleSetPriority が 'Spot' でない限り、これは指定できません。 指定しない場合、既定値は 'Delete' です。 | 'Deallocate' 'Delete' |
| scaleSetPriority | 仮想マシン スケール セットの優先順位。 指定しない場合、既定値は 'Regular' です。 | 'Regular' 'Spot' |
| spotMaxPrice | 指定できる値は、0 より大きい任意の 10 進値またはオンデマンド価格を支払う意欲を示す -1 です。 スポット価格の詳細については、スポット VM の価格に関するページを参照してください。 | int |
| tags | エージェント プールの仮想マシン スケール セットに保持されるタグ。 | ManagedClusterAgentPoolProfilePropertiesTags |
| 型 | エージェント プールの種類。 | 'AvailabilitySet' 'VirtualMachineScaleSets' |
| upgradeSettings | エージェント プールをアップグレードするための設定 | AgentPoolUpgradeSettings |
| vmSize | VM サイズの可用性はリージョンによって異なります。 ノードに十分なコンピューティング リソース (メモリ、cpu など) が含まれている場合、ポッドが正常に実行されない可能性があります。 制限付き VM サイズの詳細については、/azure/aks/quotas-skus-regions を参照してください。 | 文字列 |
| vnetSubnetID | これが指定されていない場合は、VNET とサブネットが生成されて使用されます。 podSubnetID が指定されていない場合、これはノードとポッドに適用され、それ以外の場合はノードのみに適用されます。 これは、/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} の形式です。 | 文字列 |
| windowsProfile | Windows エージェント プールの特定のプロファイル。 | AgentPoolWindowsProfile |
| workloadRuntime | ノードが実行できるワークロードの種類を決定します。 | 'KataMshvVmIsolation' 'OCIContainer' 'WasmWasi' |
ManagedClusterAgentPoolProfilePropertiesNodeLabels
| Name | Description | Value |
|---|
ManagedClusterAgentPoolProfilePropertiesTags
| Name | Description | Value |
|---|
ManagedClusterAPIServerAccessProfile
| Name | Description | Value |
|---|---|---|
| authorizedIPRanges | IP 範囲は CIDR 形式で指定されます (例: 137.117.106.88/29)。 この機能は、ノードあたりのパブリック IP を使用するクラスター、または Basic Load Balancer を使用しているクラスターとは互換性がありません。 詳細については、 API サーバーの承認済み IP 範囲を参照してください。 | string[] |
| disableRunCommand | クラスターの実行コマンドを無効にするかどうかを指定します。 | bool |
| enablePrivateCluster | 詳細については、「 プライベート AKS クラスターの作成」を参照してください。 | bool |
| enablePrivateClusterPublicFQDN | プライベート クラスター用に追加のパブリック FQDN を作成するかどうか。 | bool |
| enableVnetIntegration | クラスターの apiserver vnet 統合を有効にするかどうか。 | bool |
| privateDNSZone | 既定値は System です。 詳細については、 プライベート DNS ゾーンの構成に関するページを参照してください。 使用できる値は 'system' と 'none' です。 | 文字列 |
| subnetId | 1 の場合に必要です。 BYO Vnet を使用して新しいクラスターを作成する。2. 既存のクラスターを更新して apiserver vnet 統合を有効にする。 | 文字列 |
ManagedClusterAutoUpgradeProfile
| Name | Description | Value |
|---|---|---|
| nodeOSUpgradeChannel | 既定値はアンマネージドですが、GA で NodeImage または SecurityPatch に変更される可能性があります。 | 'NodeImage' 'None' 'SecurityPatch' 'Unmanaged' |
| upgradeChannel | 詳細については、 AKS クラスターの自動アップグレード チャネルの設定を参照してください。 | 'node-image' 'none' 'patch' 'rapid' 'stable' |
ManagedClusterAzureMonitorProfile
| Name | Description | Value |
|---|---|---|
| メトリクス | prometheus サービス アドオンのメトリック プロファイル | ManagedClusterAzureMonitorProfileMetrics |
ManagedClusterAzureMonitorProfileKubeStateMetrics
| Name | Description | Value |
|---|---|---|
| metricAnnotationsAllowList | リソースのラベル メトリックで使用される追加の Kubernetes ラベル キーのコンマ区切りの一覧。 | 文字列 |
| metricLabelsAllowlist | リソースのラベル メトリックで使用される Kubernetes 注釈キーのコンマ区切りの一覧。 | 文字列 |
ManagedClusterAzureMonitorProfileMetrics
| Name | Description | Value |
|---|---|---|
| enabled | Prometheus コレクターを有効にするかどうか | bool (必須) |
| kubeStateMetrics | コンテナー サービス クラスターの prometheus アドオン プロファイルの Kube 状態メトリック | ManagedClusterAzureMonitorProfileKubeStateMetrics |
ManagedClusterHttpProxyConfig
| Name | Description | Value |
|---|---|---|
| httpProxy | 使用する HTTP プロキシ サーバー エンドポイント。 | 文字列 |
| httpsProxy | 使用する HTTPS プロキシ サーバー エンドポイント。 | 文字列 |
| noProxy | プロキシを経由しないエンドポイント。 | string[] |
| trustedCa | プロキシ サーバーへの接続に使用する代替 CA 証明書。 | 文字列 |
ManagedClusterIdentity
| Name | Description | Value |
|---|---|---|
| 型 | 詳細については、 AKS でのマネージド ID の使用に関する説明を参照してください。 | 'None' 'SystemAssigned' 'UserAssigned' |
| userAssignedIdentities | キーは、"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}" という形式の ARM リソース ID である必要があります。 | ManagedClusterIdentityUserAssignedIdentities |
ManagedClusterIdentityUserAssignedIdentities
| Name | Description | Value |
|---|
ManagedClusterIngressProfile
| Name | Description | Value |
|---|---|---|
| webAppRouting | イングレス プロファイルの Web アプリ ルーティング設定。 | ManagedClusterIngressProfileWebAppRouting |
ManagedClusterIngressProfileWebAppRouting
| Name | Description | Value |
|---|---|---|
| dnsZoneResourceId | Web アプリに関連付ける DNS ゾーンのリソース ID。 Web アプリ ルーティングが有効になっている場合にのみ使用されます。 | 文字列 |
| enabled | Web アプリのルーティングを有効にするかどうかを指定します。 | bool |
ManagedClusterLoadBalancerProfile
| Name | Description | Value |
|---|---|---|
| allocatedOutboundPorts | VM ごとに割り当てられた SNAT ポートの必要な数。 使用できる値は、0 ~ 64000 (含む) の範囲です。 既定値は 0 で、Azure でポートが動的に割り当てられます。 | int Constraints: 最小値 = 0 最大値 = 64000 |
| backendPoolType | マネージド受信ロード バランサー BackendPool の種類。 | 'NodeIP' 'NodeIPConfiguration' |
| effectiveOutboundIPs | クラスター ロード バランサーの有効な送信 IP リソース。 | ResourceReference[] |
| enableMultipleStandardLoadBalancers | AKS クラスターごとに複数の Standard ロード バランサーを有効にするかどうか。 | bool |
| idleTimeoutInMinutes | 必要な送信フローのアイドル タイムアウト (分単位)。 使用できる値の範囲は、4 ~ 120 (両端を含む) です。 既定値は 30 分です。 | int Constraints: 最小値 = 4 最大値 = 120 |
| managedOutboundIPs | クラスター ロード バランサーに必要なマネージド送信 IP。 | ManagedClusterLoadBalancerProfileManagedOutboundIPs |
| outboundIPPrefixes | クラスター ロード バランサーに必要な送信 IP プレフィックス リソース。 | ManagedClusterLoadBalancerProfileOutboundIPPrefixes |
| outboundIPs | クラスター ロード バランサーに必要な送信 IP リソース。 | ManagedClusterLoadBalancerProfileOutboundIPs |
ManagedClusterLoadBalancerProfileManagedOutboundIPs
| Name | Description | Value |
|---|---|---|
| count | クラスター ロード バランサー用に Azure によって作成/管理される IPv4 送信 IP の目的の数。 使用できる値は、1 ~ 100 (両端を含む) の範囲である必要があります。 既定値は 1 です。 | int Constraints: 最小値 = 1 最大値 = 100 |
| countIPv6 | クラスター ロード バランサー用に Azure によって作成/管理される IPv6 送信 IP の目的の数。 使用できる値は、1 ~ 100 (両端を含む) の範囲である必要があります。 既定値は、単一スタックの場合は 0、デュアル スタックの場合は 1 です。 | int Constraints: 最小値 = 0 最大値 = 100 |
ManagedClusterLoadBalancerProfileOutboundIPPrefixes
| Name | Description | Value |
|---|---|---|
| publicIPPrefixes | パブリック IP プレフィックス リソースの一覧。 | ResourceReference[] |
ManagedClusterLoadBalancerProfileOutboundIPs
| Name | Description | Value |
|---|---|---|
| publicIPs | パブリック IP リソースの一覧。 | ResourceReference[] |
ManagedClusterManagedOutboundIPProfile
| Name | Description | Value |
|---|---|---|
| count | Azure によって作成/管理される送信 IP の目的の数。 使用できる値は、1 ~ 16 (両端を含む) の範囲である必要があります。 既定値は 1 です。 | int Constraints: 最小値 = 1 最大値 = 16 |
ManagedClusterNATGatewayProfile
| Name | Description | Value |
|---|---|---|
| effectiveOutboundIPs | クラスター NAT ゲートウェイの有効な送信 IP リソース。 | ResourceReference[] |
| idleTimeoutInMinutes | 必要な送信フローのアイドル タイムアウト (分単位)。 使用できる値の範囲は、4 ~ 120 (両端を含む) です。 既定値は 4 分です。 | int Constraints: 最小値 = 4 最大値 = 120 |
| managedOutboundIPProfile | クラスター NAT ゲートウェイのマネージド送信 IP リソースのプロファイル。 | ManagedClusterManagedOutboundIPProfile |
ManagedClusterNodeResourceGroupProfile
| Name | Description | Value |
|---|---|---|
| restrictionLevel | クラスターのノード リソース グループに適用される制限レベル | 'ReadOnly' 'Unrestricted' |
ManagedClusterOidcIssuerProfile
| Name | Description | Value |
|---|---|---|
| enabled | OIDC 発行者が有効かどうか。 | bool |
ManagedClusterPodIdentity
| Name | Description | Value |
|---|---|---|
| bindingSelector | AzureIdentityBinding リソースに使用するバインド セレクター。 | 文字列 |
| ID | ユーザー割り当て ID の詳細。 | UserAssignedIdentity (必須) |
| name | ポッド ID の名前。 | string (必須) |
| 名前空間 | ポッド ID の名前空間。 | string (必須) |
ManagedClusterPodIdentityException
| Name | Description | Value |
|---|---|---|
| name | ポッド ID 例外の名前。 | string (必須) |
| 名前空間 | ポッド ID 例外の名前空間。 | string (必須) |
| podLabels | 一致するポッド ラベル。 | ManagedClusterPodIdentityExceptionPodLabels (必須) |
ManagedClusterPodIdentityExceptionPodLabels
| Name | Description | Value |
|---|
ManagedClusterPodIdentityProfile
| Name | Description | Value |
|---|---|---|
| allowNetworkPluginKubenet | AAD ポッド ID のセキュリティ関連の性質と IP スプーフィングのリスクにより、Kubenet での実行は既定で無効になっています。 詳細については、 AAD ポッド ID での Kubenet ネットワーク プラグインの使用 を参照してください。 | bool |
| enabled | ポッド ID アドオンが有効かどうか。 | bool |
| userAssignedIdentities | クラスターで使用するポッド ID。 | ManagedClusterPodIdentity[] |
| userAssignedIdentityExceptions | 許可するポッド ID の例外。 | ManagedClusterPodIdentityException[] |
ManagedClusterProperties
| Name | Description | Value |
|---|---|---|
| aadProfile | Azure Active Directory の構成。 | ManagedClusterAADProfile |
| addonProfiles | マネージド クラスター アドオンのプロファイル。 | ManagedClusterPropertiesAddonProfiles |
| agentPoolProfiles | エージェント プールのプロパティ。 | ManagedClusterAgentPoolProfile[] |
| apiServerAccessProfile | マネージド クラスター API サーバーのアクセス プロファイル。 | ManagedClusterAPIServerAccessProfile |
| autoScalerProfile | 有効な場合にクラスター オートスケーラーに適用されるパラメーター | ManagedClusterPropertiesAutoScalerProfile |
| autoUpgradeProfile | 自動アップグレードの構成。 | ManagedClusterAutoUpgradeProfile |
| azureMonitorProfile | コンテナー サービス クラスターの Prometheus アドオン プロファイル | ManagedClusterAzureMonitorProfile |
| creationData | クラスターがスナップショットを使用して作成またはアップグレードされる場合に、ソース スナップショット ID を指定するために使用される CreationData。 | CreationData |
| disableLocalAccounts | true に設定すると、このクラスターで静的資格情報の取得が無効になります。 これは、AAD が有効になっているマネージド クラスターでのみ使用する必要があります。 詳細については、 ローカル アカウントの無効化に関するページを参照してください。 | bool |
| diskEncryptionSetID | "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/diskEncryptionSets/{encryptionSetName}" の形式です。 | 文字列 |
| dnsPrefix | これは、マネージド クラスターが作成された後は更新できません。 | 文字列 |
| enableNamespaceResources | 既定値は false です。 マネージド クラスターの作成と更新時に有効または無効にすることができます。 ARM リソースとしての名前空間の詳細については、 https://aka.ms/NamespaceARMResource を参照してください。 | bool |
| enablePodSecurityPolicy | (非推奨)Kubernetes ポッドのセキュリティ ポリシー (プレビュー) を有効にするかどうかを指定します。 PodSecurityPolicy は Kubernetes v1.21 で非推奨となり、v1.25 の Kubernetes から削除されました。 詳細については、 https://aka.ms/k8s/psp と https://aka.ms/aks/pspを参照してください。 | bool |
| enableRBAC | Kubernetes Role-Based アクセス制御を有効にするかどうかを指定します。 | bool |
| fqdnSubdomain | これは、マネージド クラスターが作成された後は更新できません。 | 文字列 |
| guardrailsProfile | ガードレール プロファイルは、特定のクラスターのすべてのガードレール情報を保持します。 | GuardrailsProfile |
| httpProxyConfig | HTTP プロキシ サーバーを使用してクラスターをプロビジョニングするための構成。 | ManagedClusterHttpProxyConfig |
| identityProfile | クラスターに関連付けられている ID。 | ManagedClusterPropertiesIdentityProfile |
| ingressProfile | マネージド クラスターのイングレス プロファイル。 | ManagedClusterIngressProfile |
| kubernetesVersion | サポートされている 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 | エージェント プール ノードを含むリソース グループの名前。 | 文字列 |
| nodeResourceGroupProfile | ノード リソース グループ構成プロファイル。 | ManagedClusterNodeResourceGroupProfile |
| oidcIssuerProfile | マネージド クラスターの OIDC 発行者プロファイル。 | ManagedClusterOidcIssuerProfile |
| podIdentityProfile | AAD ポッド ID の統合の詳細については、AAD ポッド ID の使用に関するページを参照してください。 | ManagedClusterPodIdentityProfile |
| privateLinkResources | クラスターに関連付けられているプライベート リンク リソース。 | PrivateLinkResource[] |
| publicNetworkAccess | AKS のパブリック ネットワーク アクセスを許可または拒否する | 'Disabled' 'Enabled' 'SecuredByPerimeter' |
| securityProfile | マネージド クラスターのセキュリティ プロファイル。 | ManagedClusterSecurityProfile |
| serviceMeshProfile | マネージド クラスターのサービス メッシュ プロファイル。 | ServiceMeshProfile |
| servicePrincipalProfile | Azure API の操作に使用するクラスターのサービス プリンシパル ID に関する情報。 | ManagedClusterServicePrincipalProfile |
| storageProfile | マネージド クラスターのストレージ プロファイル。 | ManagedClusterStorageProfile |
| upgradeSettings | クラスターをアップグレードするための設定。 | ClusterUpgradeSettings |
| windowsProfile | マネージド クラスター内の Windows VM のプロファイル。 | ManagedClusterWindowsProfile |
| workloadAutoScalerProfile | マネージド クラスターのワークロード 自動スケーラー プロファイル。 | ManagedClusterWorkloadAutoScalerProfile |
ManagedClusterPropertiesAddonProfiles
| Name | Description | Value |
|---|
ManagedClusterPropertiesAutoScalerProfile
| Name | Description | Value |
|---|---|---|
| balance-similar-node-groups | 有効な値は 'true' と 'false' です | 文字列 |
| expander | 指定しない場合、既定値は 'random' です。 詳細については、「 expanders を参照してください。 | 'least-waste' 'most-pods' '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 スケジューラがすべてのポッドをスケジュールする前に CA を動作させたくないバースト/バッチ スケールなどのシナリオでは、特定の期間になる前にスケジュールされていないポッドを無視するように CA に指示できます。 既定値は '0s' です。 値は整数の後に単位 (秒の場合は 's'、分の場合は '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 です。 | 文字列 |
| skip-nodes-with-system-pods | 既定値は true です。 | 文字列 |
ManagedClusterPropertiesIdentityProfile
| Name | Description | Value |
|---|
ManagedClusterSecurityProfile
| Name | Description | Value |
|---|---|---|
| azureKeyVaultKms | セキュリティ プロファイルの Azure Key Vault キー管理サービス の設定。 | AzureKeyVaultKms |
| customCATrustCertificates | カスタム CA 信頼機能が有効になっているノードの信頼ストアに追加される、最大 10 個の base64 でエンコードされた CA の一覧。 詳細については、「カスタム CA 信頼証明書」を参照してください。 | any[] |
| defender | セキュリティ プロファイルの Microsoft Defender 設定。 | ManagedClusterSecurityProfileDefender |
| imageCleaner | セキュリティ プロファイルのイメージ クリーナー設定。 | ManagedClusterSecurityProfileImageCleaner |
| nodeRestriction | セキュリティプロファイルのノード制限設定。 | ManagedClusterSecurityProfileNodeRestriction |
| workloadIdentity | セキュリティ プロファイルのワークロード ID 設定。 ワークロード ID を使用すると、Kubernetes アプリケーションは Azure AD を使用して Azure クラウド リソースに安全にアクセスできます。 詳細については、https://aka.ms/aks/wiを参照してください。 | ManagedClusterSecurityProfileWorkloadIdentity |
ManagedClusterSecurityProfileDefender
| Name | Description | Value |
|---|---|---|
| logAnalyticsWorkspaceResourceId | Microsoft Defender に関連付ける Log Analytics ワークスペースのリソース ID。 Microsoft Defender が有効になっている場合、このフィールドは必須であり、有効なワークスペース リソース ID である必要があります。 Microsoft Defender が無効になっている場合は、フィールドを空のままにします。 | 文字列 |
| securityMonitoring | セキュリティ プロファイルのクラウド設定に対する Microsoft Defender 脅威検出。 | ManagedClusterSecurityProfileDefenderSecurityMonitoring |
ManagedClusterSecurityProfileDefenderSecurityMonitoring
| Name | Description | Value |
|---|---|---|
| enabled | Defender 脅威検出を有効にするかどうか | bool |
ManagedClusterSecurityProfileImageCleaner
| Name | Description | Value |
|---|---|---|
| enabled | AKS クラスターでイメージ クリーナーを有効にするかどうか。 | bool |
| intervalHours | イメージ クリーナーのスキャン間隔 (時間単位)。 | int |
ManagedClusterSecurityProfileNodeRestriction
| Name | Description | Value |
|---|---|---|
| enabled | ノード制限を有効にするかどうか | bool |
ManagedClusterSecurityProfileWorkloadIdentity
| Name | Description | Value |
|---|---|---|
| enabled | ワークロード ID を有効にするかどうか。 | bool |
ManagedClusterServicePrincipalProfile
| Name | Description | Value |
|---|---|---|
| clientId | サービス プリンシパルの ID。 | string (必須) |
| シークレット | プレーン テキストでサービス プリンシパルに関連付けられているシークレット パスワード。 | string Constraints: 機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。 |
ManagedClusterSKU
| Name | Description | Value |
|---|---|---|
| name | マネージド クラスター SKU の名前。 | 'Base' |
| レベル | 指定しない場合、既定値は "Free" です。 詳細については、 AKS 価格レベル を参照してください。 | 'Free' 'Standard' |
ManagedClusterStorageProfile
| Name | Description | Value |
|---|---|---|
| blobCSIDriver | ストレージ プロファイルの AzureBlob CSI ドライバー設定。 | ManagedClusterStorageProfileBlobCSIDriver |
| diskCSIDriver | ストレージ プロファイルの AzureDisk CSI ドライバー設定。 | ManagedClusterStorageProfileDiskCSIDriver |
| fileCSIDriver | ストレージ プロファイルの AzureFile CSI ドライバー設定。 | ManagedClusterStorageProfileFileCSIDriver |
| snapshotController | ストレージ プロファイルのスナップショット コントローラーの設定。 | ManagedClusterStorageProfileSnapshotController |
ManagedClusterStorageProfileBlobCSIDriver
| Name | Description | Value |
|---|---|---|
| enabled | AzureBlob CSI ドライバーを有効にするかどうか。 既定値は false です。 | bool |
ManagedClusterStorageProfileDiskCSIDriver
| Name | Description | Value |
|---|---|---|
| enabled | AzureDisk CSI ドライバーを有効にするかどうか。 これは既定値は true です。 | bool |
| バージョン | AzureDisk CSI ドライバーのバージョン。 既定値は v1 です。 | 文字列 |
ManagedClusterStorageProfileFileCSIDriver
| Name | Description | Value |
|---|---|---|
| enabled | AzureFile CSI ドライバーを有効にするかどうか。 これは既定値は true です。 | bool |
ManagedClusterStorageProfileSnapshotController
| Name | Description | Value |
|---|---|---|
| enabled | スナップショット コントローラーを有効にするかどうかを指定します。 これは既定値は true です。 | bool |
ManagedClusterWindowsProfile
| Name | Description | Value |
|---|---|---|
| adminPassword | 管理者アカウントのパスワードを指定します。 最小長: 8 文字 最大長: 123 文字 複雑さの要件: 以下の 4 つの条件のうち 3 つ を満たす必要があります 文字が小さい 上の文字を含む 数字を含む 特殊文字を持つ (Regex match [\W_]) 許可されていない値: "abc@123"、"P@$$w 0rd"、"P@ssw0rd"、"P@ssword123"、"Pa$$word"、"pass@word1"、"Password!"、"Password1"、"Password22"、"iloveyou!" |
文字列 |
| 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' |
ManagedClusterWorkloadAutoScalerProfile
| Name | Description | Value |
|---|---|---|
| keda | ワークロード 自動スケーラー プロファイルの KEDA (Kubernetes イベント ドリブン自動スケーリング) 設定。 | ManagedClusterWorkloadAutoScalerProfileKeda |
| verticalPodAutoscaler | ManagedClusterWorkloadAutoScalerProfileVerticalPodAutoscaler |
ManagedClusterWorkloadAutoScalerProfileKeda
| Name | Description | Value |
|---|---|---|
| enabled | KEDA を有効にするかどうか。 | bool (必須) |
ManagedClusterWorkloadAutoScalerProfileVerticalPodAutoscaler
| Name | Description | Value |
|---|---|---|
| controlledValues | どのリソース値オートスケーラーが変更されるかを制御します。 既定値は RequestsAndLimits です。 | 'RequestsAndLimits' 'RequestsOnly' (必須) |
| enabled | VPA を有効にするかどうか。 既定値は false です。 | bool (必須) |
| updateMode | 各更新モード レベルは、下位レベルのスーパーセットです。 Off<Initial<Recreate<=Auto。たとえば、UpdateMode が Initial の場合、VPA は VerticalPodAutoscaler カスタム リソースの推奨リソースを (UpdateMode Off から) 設定し、ポッドの作成時に (Initial から) リソースも割り当てることを意味します。 既定値は [オフ] です。 | 'Auto' 'Initial' 'Off' 「再作成」(必須) |
ManagedServiceIdentityUserAssignedIdentitiesValue
| Name | Description | Value |
|---|
PortRange
| Name | Description | Value |
|---|---|---|
| portEnd | 範囲に含まれる最大ポート。 範囲は 1 から 65535 で、portStart 以上である必要があります。 | int Constraints: 最小値 = 1 最大値 = 65535 |
| portStart | 範囲に含まれる最小ポート。 範囲は 1 から 65535 で、portEnd 以下である必要があります。 | int Constraints: 最小値 = 1 最大値 = 65535 |
| プロトコル | ポートのネットワーク プロトコル。 | 'TCP' 'UDP' |
PowerState
| Name | Description | Value |
|---|---|---|
| コード | クラスターが実行中か停止かを示します | 'Running' 'Stopped' |
PrivateLinkResource
| Name | Description | Value |
|---|---|---|
| groupId | リソースのグループ ID。 | 文字列 |
| id | プライベート リンク リソースの ID。 | 文字列 |
| name | プライベート リンク リソースの名前。 | 文字列 |
| requiredMembers | リソースの RequiredMembers | string[] |
| 型 | リソースの種類。 | 文字列 |
ResourceReference
| Name | Description | Value |
|---|---|---|
| id | 完全修飾 Azure リソース ID。 | 文字列 |
ServiceMeshProfile
| Name | Description | Value |
|---|---|---|
| istio | Istio サービス メッシュの構成。 | IstioServiceMesh |
| mode | サービス メッシュのモード。 | 'Disabled' 'Istio' (必須) |
SysctlConfig
| Name | Description | Value |
|---|---|---|
| fsAioMaxNr | sysctl setting fs.aio-max-nr. | int |
| fsFileMax | sysctl 設定 fs.file-max. | int |
| fsInotifyMaxUserWatches | sysctl setting fs.inotify.max_user_watches. | int |
| fsNrOpen | Sysctl 設定fs.nr_open。 | int |
| kernelThreadsMax | sysctl setting 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 setting 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 setting vm.max_map_count. | int |
| vmSwappiness | sysctl setting vm.swappiness. | int |
| vmVfsCachePressure | Sysctl 設定vm.vfs_cache_pressure。 | int |
TrackedResourceTags
| Name | Description | Value |
|---|
UpgradeOverrideSettings
| Name | Description | Value |
|---|---|---|
| controlPlaneOverrides | クラスターのコントロール プレーンをアップグレードするときのアップグレードオーバーライドの一覧。 | 次のいずれかを含む文字列配列: 'IgnoreKubernetesDeprecations' |
| until | オーバーライドが有効になるまで。 これはアップグレードの開始時刻にのみ一致し、アップグレードの進行に応じて until の有効期限が切れた場合でも、アップグレードの開始時に有効性は変わらないことに注意してください。 このフィールドは既定では設定されていません。 オーバーライドを有効にするには、この値を設定する必要があります。 |
文字列 |
UserAssignedIdentity
| Name | Description | Value |
|---|---|---|
| clientId | ユーザー割り当て ID のクライアント ID。 | 文字列 |
| objectId | ユーザー割り当て ID のオブジェクト ID。 | 文字列 |
| resourceId | ユーザー割り当て ID のリソース ID。 | 文字列 |
WindowsGmsaProfile
| Name | Description | Value |
|---|---|---|
| dnsServer | Windows gMSA の DNS サーバーを指定します。 マネージド クラスターの作成に使用する vnet 内の DNS サーバーを構成している場合は、これを空に設定します。 |
文字列 |
| enabled | マネージド クラスターで Windows gMSA を有効にするかどうかを指定します。 | bool |
| rootDomainName | Windows gMSA のルート ドメイン名を指定します。 マネージド クラスターの作成に使用する vnet 内の DNS サーバーを構成している場合は、これを空に設定します。 |
文字列 |
使用例
Azure 検証済みモジュール
次の Azure 検証済みモジュール を使用して、このリソースの種類をデプロイできます。
| Module | Description |
|---|---|
| Azure Kubernetes Service (AKS) マネージド クラスター | Azure Kubernetes Service (AKS) マネージド クラスター用の AVM リソース モジュール |
Azure クイック スタートのサンプル
次 Azure クイック スタート テンプレート、このリソースの種類をデプロイするための Bicep サンプルが含まれています。
| Bicep ファイル | Description |
|---|---|
| NAT ゲートウェイと Application Gateway を使用して AKS クラスターを |
このサンプルでは、送信接続用の NAT ゲートウェイと受信接続用の Application Gateway を使用して AKS クラスターをデプロイする方法を示します。 |
| Application Gateway イングレス コントローラー を使用して AKS クラスターを |
このサンプルでは、Application Gateway、Application Gateway イングレス コントローラー、Azure Container Registry、Log Analytics、Key Vault を使用して AKS クラスターをデプロイする方法を示します |
| Azure コンテナー サービス (AKS) | Azure Linux コンテナー ホストを使用して Azure Container Service (AKS) でマネージド クラスターをデプロイする |
| Azure コンテナー サービス (AKS) | Azure Container Service (AKS) を使用してマネージド クラスターをデプロイする |
| Helm を使用して Azure Container Service (AKS) を |
Helm を使用して Azure Container Service (AKS) を使用してマネージド クラスターをデプロイする |
| Azure Kubernetes Service (AKS) | Azure Kubernetes Service (AKS) を使用してマネージド Kubernetes クラスターをデプロイします |
| Azure Machine Learning のエンド ツー エンドのセキュリティで保護されたセットアップ を |
この Bicep テンプレートのセットは、セキュリティで保護されたセットアップで Azure Machine Learning をエンド ツー エンドで設定する方法を示しています。 この参照実装には、ワークスペース、コンピューティング クラスター、コンピューティング インスタンス、接続されたプライベート AKS クラスターが含まれます。 |
| Azure Machine Learning のエンド ツー エンドのセキュリティで保護されたセットアップ (レガシ) を |
この Bicep テンプレートのセットは、セキュリティで保護されたセットアップで Azure Machine Learning をエンド ツー エンドで設定する方法を示しています。 この参照実装には、ワークスペース、コンピューティング クラスター、コンピューティング インスタンス、接続されたプライベート AKS クラスターが含まれます。 |
| プライベート AKS クラスター を作成する |
このサンプルでは、ジャンプボックス仮想マシンと共に仮想ネットワークにプライベート AKS クラスターを作成する方法を示します。 |
| Prometheus で AKS を作成し、privae リンクを使用して Grafana | これにより、Azure grafana、AKS が作成され、オープンソースの監視およびアラート ツールキットである Prometheus が Azure Kubernetes Service (AKS) クラスターにインストールされます。 次に、Azure Managed Grafana のマネージド プライベート エンドポイントを使用してこの Prometheus サーバーに接続し、Grafana ダッシュボードに Prometheus データを表示します |
ARM テンプレート リソース定義
managedClusters リソースの種類は、次を対象とする操作と共にデプロイできます。
各 API バージョンで変更されたプロパティの一覧については、変更ログの
リソースの形式
Microsoft.ContainerService/managedClusters リソースを作成するには、次の JSON をテンプレートに追加します。
{
"type": "Microsoft.ContainerService/managedClusters",
"apiVersion": "2023-02-02-preview",
"name": "string",
"extendedLocation": {
"name": "string",
"type": "string"
},
"identity": {
"type": "string",
"userAssignedIdentities": {
"{customized property}": {
}
}
},
"location": "string",
"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" ],
"capacityReservationGroupID": "string",
"count": "int",
"creationData": {
"sourceResourceId": "string"
},
"enableAutoScaling": "bool",
"enableCustomCATrust": "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",
"messageOfTheDay": "string",
"minCount": "int",
"mode": "string",
"name": "string",
"networkProfile": {
"allowedHostPorts": [
{
"portEnd": "int",
"portStart": "int",
"protocol": "string"
}
],
"applicationSecurityGroups": [ "string" ],
"nodePublicIPTags": [
{
"ipTagType": "string",
"tag": "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": "int",
"tags": {
"{customized property}": "string"
},
"type": "string",
"upgradeSettings": {
"maxSurge": "string"
},
"vmSize": "string",
"vnetSubnetID": "string",
"windowsProfile": {
"disableOutboundNat": "bool"
},
"workloadRuntime": "string"
}
],
"apiServerAccessProfile": {
"authorizedIPRanges": [ "string" ],
"disableRunCommand": "bool",
"enablePrivateCluster": "bool",
"enablePrivateClusterPublicFQDN": "bool",
"enableVnetIntegration": "bool",
"privateDNSZone": "string",
"subnetId": "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": {
"nodeOSUpgradeChannel": "string",
"upgradeChannel": "string"
},
"azureMonitorProfile": {
"metrics": {
"enabled": "bool",
"kubeStateMetrics": {
"metricAnnotationsAllowList": "string",
"metricLabelsAllowlist": "string"
}
}
},
"creationData": {
"sourceResourceId": "string"
},
"disableLocalAccounts": "bool",
"diskEncryptionSetID": "string",
"dnsPrefix": "string",
"enableNamespaceResources": "bool",
"enablePodSecurityPolicy": "bool",
"enableRBAC": "bool",
"fqdnSubdomain": "string",
"guardrailsProfile": {
"excludedNamespaces": [ "string" ],
"level": "string",
"version": "string"
},
"httpProxyConfig": {
"httpProxy": "string",
"httpsProxy": "string",
"noProxy": [ "string" ],
"trustedCa": "string"
},
"identityProfile": {
"{customized property}": {
"clientId": "string",
"objectId": "string",
"resourceId": "string"
}
},
"ingressProfile": {
"webAppRouting": {
"dnsZoneResourceId": "string",
"enabled": "bool"
}
},
"kubernetesVersion": "string",
"linuxProfile": {
"adminUsername": "string",
"ssh": {
"publicKeys": [
{
"keyData": "string"
}
]
}
},
"networkProfile": {
"dnsServiceIP": "string",
"dockerBridgeCidr": "string",
"ipFamilies": [ "string" ],
"kubeProxyConfig": {
"enabled": "bool",
"ipvsConfig": {
"scheduler": "string",
"tcpFinTimeoutSeconds": "int",
"tcpTimeoutSeconds": "int",
"udpTimeoutSeconds": "int"
},
"mode": "string"
},
"loadBalancerProfile": {
"allocatedOutboundPorts": "int",
"backendPoolType": "string",
"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"
}
},
"networkDataplane": "string",
"networkMode": "string",
"networkPlugin": "string",
"networkPluginMode": "string",
"networkPolicy": "string",
"outboundType": "string",
"podCidr": "string",
"podCidrs": [ "string" ],
"serviceCidr": "string",
"serviceCidrs": [ "string" ]
},
"nodeResourceGroup": "string",
"nodeResourceGroupProfile": {
"restrictionLevel": "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"
},
"customCATrustCertificates": [ {} ],
"defender": {
"logAnalyticsWorkspaceResourceId": "string",
"securityMonitoring": {
"enabled": "bool"
}
},
"imageCleaner": {
"enabled": "bool",
"intervalHours": "int"
},
"nodeRestriction": {
"enabled": "bool"
},
"workloadIdentity": {
"enabled": "bool"
}
},
"serviceMeshProfile": {
"istio": {
"components": {
"ingressGateways": [
{
"enabled": "bool",
"mode": "string"
}
]
}
},
"mode": "string"
},
"servicePrincipalProfile": {
"clientId": "string",
"secret": "string"
},
"storageProfile": {
"blobCSIDriver": {
"enabled": "bool"
},
"diskCSIDriver": {
"enabled": "bool",
"version": "string"
},
"fileCSIDriver": {
"enabled": "bool"
},
"snapshotController": {
"enabled": "bool"
}
},
"upgradeSettings": {
"overrideSettings": {
"controlPlaneOverrides": [ "string" ],
"until": "string"
}
},
"windowsProfile": {
"adminPassword": "string",
"adminUsername": "string",
"enableCSIProxy": "bool",
"gmsaProfile": {
"dnsServer": "string",
"enabled": "bool",
"rootDomainName": "string"
},
"licenseType": "string"
},
"workloadAutoScalerProfile": {
"keda": {
"enabled": "bool"
},
"verticalPodAutoscaler": {
"controlledValues": "string",
"enabled": "bool",
"updateMode": "string"
}
}
},
"sku": {
"name": "string",
"tier": "string"
},
"tags": {
"{customized property}": "string"
}
}
プロパティ値
Microsoft.ContainerService/managedClusters
| Name | Description | Value |
|---|---|---|
| apiVersion | API のバージョン | '2023-02-02-preview' |
| extendedLocation | 仮想マシンの拡張された場所。 | ExtendedLocation |
| ID | マネージド クラスターの ID (構成されている場合)。 | ManagedClusterIdentity |
| 位置 | リソースが存在する地理的な場所 | string (必須) |
| name | リソース名 | string Constraints: 最小長 = 1 最大長 = 63 パターン = ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-_a-zA-Z0-9]{0,61}[a-zA-Z0-9]$ (必須) |
| properties | マネージド クラスターのプロパティ。 | ManagedClusterProperties |
| sku | マネージド クラスター SKU。 | ManagedClusterSKU |
| tags | リソース タグ | タグ名と値のディクショナリ。 テンプレート の |
| 型 | リソースの種類 | 'Microsoft.ContainerService/managedClusters' |
AgentPoolNetworkProfile
| Name | Description | Value |
|---|---|---|
| allowedHostPorts | アクセスが許可されているポート範囲。 指定した範囲は重複できます。 | PortRange[] |
| applicationSecurityGroups | エージェント プールの作成時に関連付けるアプリケーション セキュリティ グループの ID。 | string[] |
| nodePublicIPTags | インスタンス レベルのパブリック IP の IP タグ。 | IPTag[] |
AgentPoolUpgradeSettings
| Name | Description | Value |
|---|---|---|
| maxSurge | これは、整数 (例: '5') またはパーセンテージ (例: '50%') に設定できます。 パーセンテージを指定すると、アップグレード時のエージェント・プール・サイズの合計に対するパーセンテージになります。 パーセンテージの場合、小数部のノードは切り上げられます。 指定しない場合、既定値は 1 です。 ベスト プラクティスを含む詳細については、「/azure/aks/upgrade-cluster#customize-node-surge-upgrade」を参照してください。 | 文字列 |
AgentPoolWindowsProfile
| Name | Description | Value |
|---|---|---|
| disableOutboundNat | 既定値は false です。 送信 NAT を無効にできるのは、クラスターの outboundType が NAT ゲートウェイであり、Windows エージェント プールでノード パブリック IP が有効になっていない場合のみです。 | bool |
AzureKeyVaultKms
| Name | Description | Value |
|---|---|---|
| enabled | 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されている場合は、フィールドを空のままにします。 |
文字列 |
ClusterUpgradeSettings
| Name | Description | Value |
|---|---|---|
| overrideSettings | オーバーライドの設定。 | UpgradeOverrideSettings |
ContainerServiceLinuxProfile
| Name | Description | Value |
|---|---|---|
| adminUsername | Linux VM に使用する管理者ユーザー名。 | string Constraints: パターン = ^[A-Za-z][-A-Za-z0-9_]*$ (必須) |
| ssh | Azure で実行されている Linux ベースの VM の SSH 構成。 | ContainerServiceSshConfiguration (必須) |
ContainerServiceNetworkProfile
| Name | Description | Value |
|---|---|---|
| dnsServiceIP | Kubernetes DNS サービスに割り当てられた IP アドレス。 これは、serviceCidr で指定された Kubernetes サービス アドレス範囲内にある必要があります。 | string Constraints: パターン = ^(?:(?: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 Constraints: パターン = ^([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' |
| kubeProxyConfig | kube-proxy の構成のカスタマイズを保持します。 定義されていない値は、kube-proxy の既定の動作を使用します。 https://v<バージョン>.docs.kubernetes.io/docs/reference/command-line-tools-reference/kube-proxy/ を参照してください。 <version> は <バージョン>-<minor バージョン> 文字列で表されます。 Kubernetes バージョン 1.23 は '1-23' になります。 | ContainerServiceNetworkProfileKubeProxyConfig |
| loadBalancerProfile | クラスター ロード バランサーのプロファイル。 | ManagedClusterLoadBalancerProfile |
| loadBalancerSku | 既定値は 'standard' です。 ロード バランサー SKU の違いの詳細については、Azure Load Balancer SKU に関するページを参照してください。 | 'basic' 'standard' |
| natGatewayProfile | クラスター NAT ゲートウェイのプロファイル。 | ManagedClusterNATGatewayProfile |
| networkDataplane | Kubernetes クラスターで使用されるネットワーク データプレーン。 | 'azure' 'cilium' |
| networkMode | networkPlugin が 'azure' 以外の場合は、これを指定できません。 | 'bridge' 'transparent' |
| networkPlugin | Kubernetes ネットワークの構築に使用されるネットワーク プラグイン。 | 'azure' 'kubenet' 'none' |
| networkPluginMode | Kubernetes ネットワークの構築に使用されるネットワーク プラグイン モード。 | 'Overlay' |
| networkPolicy | Kubernetes ネットワークの構築に使用されるネットワーク ポリシー。 | 'azure' 'calico' 'cilium' |
| outboundType | これはクラスター作成時にのみ設定でき、後で変更することはできません。 詳細については、 エグレス送信の種類を参照してください。 | 'loadBalancer' 'managedNATGateway' 'userAssignedNATGateway' 'userDefinedRouting' |
| podCidr | kubenet の使用時にポッド IP を割り当てる CIDR 表記 IP 範囲。 | string Constraints: パターン = ^([0-9]{1,3}\.){3}[0-9]{1,3}(\/([0-9]|[1-2][0-9]|3[0-2]))?$ |
| podCidrs | 単一スタック ネットワークでは、1 つの IPv4 CIDR が必要です。 デュアルスタック ネットワークでは、2 つの CIDR (各 IP ファミリ (IPv4/IPv6) に 1 つ) が必要です。 | string[] |
| serviceCidr | サービス クラスター IP を割り当てる CIDR 表記 IP 範囲。 サブネット IP 範囲と重複しないようにする必要があります。 | string Constraints: パターン = ^([0-9]{1,3}\.){3}[0-9]{1,3}(\/([0-9]|[1-2][0-9]|3[0-2]))?$ |
| serviceCidrs | 単一スタック ネットワークでは、1 つの IPv4 CIDR が必要です。 デュアルスタック ネットワークでは、2 つの CIDR (各 IP ファミリ (IPv4/IPv6) に 1 つ) が必要です。 サブネット IP 範囲と重複しないようにする必要があります。 | string[] |
ContainerServiceNetworkProfileKubeProxyConfig
| Name | Description | Value |
|---|---|---|
| enabled | クラスター上の kube-proxy で有効にするかどうかを指定します ('kubeProxyConfig' が存在しない場合、kube-proxy は既定でこれらのカスタマイズなしで AKS で有効になります)。 | bool |
| ipvsConfig | IPVS の構成のカスタマイズを保持します。 'mode' が 'IPVS' に設定されている場合にのみ指定できます。 | ContainerServiceNetworkProfileKubeProxyConfigIpvsConfig |
| mode | 使用するプロキシ モード ('IPTABLES' または 'IPVS') を指定する | 'IPTABLES' 'IPVS' |
ContainerServiceNetworkProfileKubeProxyConfigIpvsConfig
| Name | Description | Value |
|---|---|---|
| scheduler | IPVS スケジューラの詳細については、 http://www.linuxvirtualserver.org/docs/scheduling.htmlを参照してください。 | 'LeastConnection' 'RoundRobin' |
| tcpFinTimeoutSeconds | FIN を受信した後の IPVS TCP セッションに使用されるタイムアウト値 (秒単位)。 正の整数値である必要があります。 | int |
| tcpTimeoutSeconds | アイドル状態の IPVS TCP セッションに使用されるタイムアウト値 (秒単位)。 正の整数値である必要があります。 | int |
| udpTimeoutSeconds | IPVS UDP パケットに使用されるタイムアウト値 (秒単位)。 正の整数値である必要があります。 | int |
ContainerServiceSshConfiguration
| Name | Description | Value |
|---|---|---|
| publicKeys | Linux ベースの VM での認証に使用される SSH 公開キーの一覧。 最大 1 つのキーを指定できます。 | ContainerServiceSshPublicKey[] (必須) |
ContainerServiceSshPublicKey
| Name | Description | Value |
|---|---|---|
| keyData | SSH 経由で VM で認証するために使用される証明書公開キー。 証明書は、ヘッダーの有無にかかわらず PEM 形式である必要があります。 | string (必須) |
CreationData
| Name | Description | Value |
|---|---|---|
| sourceResourceId | これは、ターゲット オブジェクトの作成に使用するソース オブジェクトの ARM ID です。 | 文字列 |
ExtendedLocation
| Name | Description | Value |
|---|---|---|
| name | 拡張された場所の名前。 | 文字列 |
| 型 | 拡張された場所の種類。 | 'EdgeZone' |
GuardrailsProfile
| Name | Description | Value |
|---|---|---|
| excludedNamespaces | ガードレール チェックから除外される名前空間の一覧 | string[] |
| レベル | 使用するガードレール レベル。 既定では、AKS が systemExcludedNamespaces 経由で除外する名前空間を除くすべての名前空間に対して Guardrails が有効になっています | 'Enforcement' 'Off' '警告' (必須) |
| バージョン | 使用する制約のバージョン | string (必須) |
IPTag
| Name | Description | Value |
|---|---|---|
| ipTagType | IP タグの種類。 例: RoutingPreference。 | 文字列 |
| タグ | パブリック IP に関連付けられている IP タグの値。 例: インターネット。 | 文字列 |
IstioComponents
| Name | Description | Value |
|---|---|---|
| ingressGateways | Istio イングレス ゲートウェイ。 | IstioIngressGateway[] |
IstioIngressGateway
| Name | Description | Value |
|---|---|---|
| enabled | イングレス ゲートウェイを有効にするかどうか。 | bool (必須) |
| mode | イングレス ゲートウェイのモード。 | 'External' 'Internal' (必須) |
IstioServiceMesh
| Name | Description | Value |
|---|---|---|
| components | Istio コンポーネントの構成。 | IstioComponents |
KubeletConfig
| Name | Description | Value |
|---|---|---|
| allowedUnsafeSysctls | 安全でない sysctl または安全でない sysctl パターンの許可されたリスト ( *で終わる)。 |
string[] |
| containerLogMaxFiles | コンテナーに存在できるコンテナー ログ ファイルの最大数。 数値は 2 ≥する必要があります。 | int Constraints: 最小値 = 2 |
| containerLogMaxSizeMB | ローテーション前のコンテナー ログ ファイルの最大サイズ (10Mi など)。 | int |
| cpuCfsQuota | 既定値は true です。 | bool |
| cpuCfsQuotaPeriod | 既定値は '100 ミリ秒' です。 有効な値は、省略可能な分数と単位サフィックスを持つ 10 進数のシーケンスです。 例: '300ms'、'2h45m'。 サポートされるユニットは、'ns'、'us'、'ms'、's'、'm'、および 'h' です。 | 文字列 |
| cpuManagerPolicy | 既定値は 'none' です。 詳細については、 Kubernetes CPU 管理ポリシーを 参照してください。 使用できる値は 'none' と 'static' です。 | 文字列 |
| failSwapOn | true に設定すると、ノードでスワップが有効になっている場合、Kubelet の起動に失敗します。 | bool |
| imageGcHighThreshold | イメージ ガベージ コレクションを無効にするには、100 に設定します。 既定値は 85% | int |
| imageGcLowThreshold | imageGcHighThreshold より高く設定することはできません。 既定値は 80% | int |
| podMaxPids | ポッドあたりのプロセスの最大数。 | int |
| topologyManagerPolicy | 詳細については、「 Kubernetes Topology Manager」を参照してください。 既定値は 'none' です。 使用できる値は、'none'、'best-effort'、'restricted'、および 'single-numa-node' です。 | 文字列 |
LinuxOSConfig
| Name | Description | Value |
|---|---|---|
| swapFileSizeMB | 各ノードに作成されるスワップ ファイルのサイズ (MB)。 | int |
| sysctls | Linux エージェント ノードの Sysctl 設定。 | SysctlConfig |
| transparentHugePageDefrag | 有効な値は、'always'、'defer'、'defer+madvise'、'madvise' および 'never' です。 既定値は 'madvise' です。 詳細については、「Transparent Hugepages」を参照してください。 | 文字列 |
| transparentHugePageEnabled | 有効な値は、'always'、'madvise'、および 'never' です。 既定値は "always" です。 詳細については、「Transparent Hugepages」を参照してください。 | 文字列 |
ManagedClusterAADProfile
| Name | Description | Value |
|---|---|---|
| adminGroupObjectIDs | クラスターの管理者ロールを持つ AAD グループ オブジェクト ID の一覧。 | string[] |
| clientAppID | (非推奨)クライアント AAD アプリケーション ID。 詳細については、https://aka.ms/aks/aad-legacyを参照してください。 | 文字列 |
| enableAzureRBAC | Kubernetes 承認に対して Azure RBAC を有効にするかどうかを指定します。 | bool |
| マネージ | マネージド AAD を有効にするかどうか。 | bool |
| serverAppID | (非推奨)サーバー AAD アプリケーション ID。 詳細については、https://aka.ms/aks/aad-legacyを参照してください。 | 文字列 |
| serverAppSecret | (非推奨)サーバー AAD アプリケーション シークレット。 詳細については、https://aka.ms/aks/aad-legacyを参照してください。 | 文字列 |
| tenantID | 認証に使用する AAD テナント ID。 指定しない場合は、デプロイ サブスクリプションのテナントを使用します。 | 文字列 |
ManagedClusterAddonProfile
| Name | Description | Value |
|---|---|---|
| config | アドオンを構成するためのキーと値のペア。 | ManagedClusterAddonProfileConfig |
| enabled | アドオンが有効かどうか。 | bool (必須) |
ManagedClusterAddonProfileConfig
| Name | Description | Value |
|---|
ManagedClusterAgentPoolProfile
| Name | Description | Value |
|---|---|---|
| availabilityZones | ノードに使用する可用性ゾーンの一覧。 これは、AgentPoolType プロパティが 'VirtualMachineScaleSets' の場合にのみ指定できます。 | string[] |
| capacityReservationGroupID | AKS は、指定されたエージェント プールを容量予約グループに関連付けます。 | 文字列 |
| count | Docker コンテナーをホストするエージェント (VM) の数。 使用できる値は、ユーザー プールの場合は 0 から 1000 (含む) の範囲、システム プールの場合は 1 から 1000 (含む) の範囲である必要があります。 既定値は 1 です。 | int |
| creationData | スナップショットを使用してノード プールを作成またはアップグレードする場合に、ソース スナップショット ID を指定するために使用する CreationData。 | CreationData |
| enableAutoScaling | 自動スケーラーを有効にするかどうか | bool |
| enableCustomCATrust | true に設定すると、AKS は機能が有効になっていることを示すラベルをノードに追加し、ホスト サービスと共にデーモンセットをデプロイして、base64 でエンコードされた証明書のユーザー指定リストからノード信頼ストアにカスタム証明機関を同期します。 既定値は false です。 | bool |
| enableEncryptionAtHost | これは、特定の VM サイズと特定の Azure リージョンでのみサポートされます。 詳細については、「/azure/aks/enable-host-encryption」を参照してください。 | bool |
| enableFIPS | 詳細については 、FIPS 対応ノード プールの追加 を参照してください。 | bool |
| enableNodePublicIP | シナリオによっては、ノード プール内のノードが独自の専用パブリック IP アドレスを受け取る必要がある場合があります。 一般的なシナリオは、ホップを最小限に抑えるために、コンソールがクラウド仮想マシンに直接接続する必要があるゲーム ワークロードです。 詳細については、 ノードごとのパブリック IP の割り当てを参照してください。 既定値は false です。 | bool |
| enableUltraSSD | UltraSSD を有効にするかどうか | bool |
| gpuInstanceProfile | サポートされている GPU VM SKU の GPU MIG インスタンス プロファイルを指定するために使用される GPUInstanceProfile。 | 'MIG1g' 'MIG2g' 'MIG3g' 'MIG4g' 'MIG7g' |
| hostGroupID | 形式は /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}です。 詳細については、 Azure 専用ホストに関するページを参照してください。 | 文字列 |
| kubeletConfig | エージェント プール ノード上の Kubelet 構成。 | KubeletConfig |
| kubeletDiskType | emptyDir ボリューム、コンテナー ランタイム データ ルート、および Kubelet エフェメラル ストレージの配置を決定します。 | 'OS' 'Temporary' |
| linuxOSConfig | Linux エージェント ノードの OS 構成。 | LinuxOSConfig |
| maxCount | 自動スケーリングのノードの最大数 | int |
| maxPods | ノードで実行できるポッドの最大数。 | int |
| messageOfTheDay | デコード後に /etc/motd に書き込まれる base64 でエンコードされた文字列。 これにより、Linux ノードに対するその日のメッセージをカスタマイズできます。 Windows ノードには指定しないでください。 静的文字列である必要があります (つまり、生で出力され、スクリプトとして実行されません)。 | 文字列 |
| minCount | 自動スケーリング用のノードの最小数 | int |
| mode | クラスターには、常に少なくとも 1 つの "システム" エージェント プールが必要です。 エージェント プールの制限とベスト プラクティスの詳細については、/azure/aks/use-system-pools を参照してください。 | 'System' 'User' |
| name | Windows エージェント プール名は 6 文字以下にする必要があります。 | string Constraints: パターン = ^[a-z][a-z0-9]{0,11}$ (必須) |
| networkProfile | エージェント プールのネットワーク関連の設定。 | AgentPoolNetworkProfile |
| nodeLabels | エージェント プール内のすべてのノードにわたって保持されるノード ラベル。 | ManagedClusterAgentPoolProfilePropertiesNodeLabels |
| nodePublicIPPrefixID | これは、/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName} の形式です。 | 文字列 |
| nodeTaints | ノード プールの作成とスケーリング中に新しいノードに追加されたテイント。 たとえば、key=value:NoSchedule です。 | string[] |
| orchestratorVersion | パッチ バージョン <major.minor.patch> と <major.minor> の両方がサポートされています。 <major.minor>を指定すると、サポートされている最新のパッチ バージョンが自動的に選択されます。 エージェント プールを同じ <major.minor> を作成した後に更新しても、新しいパッチ バージョンが使用可能な場合でもアップグレードはトリガーされません。 ベスト プラクティスとして、AKS クラスター内のすべてのノード プールを同じ Kubernetes バージョンにアップグレードする必要があります。 ノード プールのバージョンには、コントロール プレーンと同じメジャー バージョンが必要です。 ノード プールのマイナー バージョンは、コントロール プレーン バージョンの 2 つのマイナー バージョン内にある必要があります。 ノード プールのバージョンをコントロール プレーンのバージョンより大きくすることはできません。 詳細については、 ノード・プールのアップグレードを参照してください。 | 文字列 |
| osDiskSizeGB | マスター/エージェント プール内のすべてのマシンのディスク サイズを指定するために使用する OS ディスク サイズ (GB)。 0 を指定すると、指定された vmSize に従って既定の osDisk サイズが適用されます。 | int Constraints: 最小値 = 0 最大値 = 2048 |
| osDiskType | VM でサポートされていて、要求された OSDiskSizeGB より大きいキャッシュ ディスクがある場合、既定値は "エフェメラル" です。 それ以外の場合、既定値は 'Managed' です。 作成後に変更できない場合があります。 詳細については、「エフェメラル OS を参照してください。 | 'Ephemeral' 'Managed' |
| osSKU | エージェント プールで使用される OS SKU を指定します。 指定しない場合、既定値は OSType=Linux の場合は Ubuntu、OSType=Windows の場合は Windows2019 です。 また、Windows 2019 が非推奨になった後、既定の Windows OSSKU が Windows2022 に変更されます。 | 'CBLMariner' 'Mariner' 'Ubuntu' 'Windows2019' 'Windows2022' |
| osType | オペレーティング システムの種類。 既定値は Linux です。 | 'Linux' 'Windows' |
| podSubnetID | 省略すると、ポッド IP はノード サブネットに静的に割り当てられます (詳細については、vnetSubnetID を参照してください)。 これは、/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} の形式です。 | 文字列 |
| powerState | エージェント プールが最初に作成されるときは、最初に実行中です。 エージェント プールは、このフィールドを [停止済み] に設定することで停止できます。 停止したエージェント プールは、すべての VM を停止し、課金料金は発生しません。 エージェント プールは、実行中でプロビジョニング状態が成功した場合にのみ停止できます | PowerState |
| proximityPlacementGroupID | 近接通信配置グループの ID。 | 文字列 |
| scaleDownMode | これは、クラスターオートスケーラーの動作にも影響します。 指定しない場合は、既定で Delete に設定されます。 | 'Deallocate' 'Delete' |
| scaleSetEvictionPolicy | scaleSetPriority が 'Spot' でない限り、これは指定できません。 指定しない場合、既定値は 'Delete' です。 | 'Deallocate' 'Delete' |
| scaleSetPriority | 仮想マシン スケール セットの優先順位。 指定しない場合、既定値は 'Regular' です。 | 'Regular' 'Spot' |
| spotMaxPrice | 指定できる値は、0 より大きい任意の 10 進値またはオンデマンド価格を支払う意欲を示す -1 です。 スポット価格の詳細については、スポット VM の価格に関するページを参照してください。 | int |
| tags | エージェント プールの仮想マシン スケール セットに保持されるタグ。 | ManagedClusterAgentPoolProfilePropertiesTags |
| 型 | エージェント プールの種類。 | 'AvailabilitySet' 'VirtualMachineScaleSets' |
| upgradeSettings | エージェント プールをアップグレードするための設定 | AgentPoolUpgradeSettings |
| vmSize | VM サイズの可用性はリージョンによって異なります。 ノードに十分なコンピューティング リソース (メモリ、cpu など) が含まれている場合、ポッドが正常に実行されない可能性があります。 制限付き VM サイズの詳細については、/azure/aks/quotas-skus-regions を参照してください。 | 文字列 |
| vnetSubnetID | これが指定されていない場合は、VNET とサブネットが生成されて使用されます。 podSubnetID が指定されていない場合、これはノードとポッドに適用され、それ以外の場合はノードのみに適用されます。 これは、/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} の形式です。 | 文字列 |
| windowsProfile | Windows エージェント プールの特定のプロファイル。 | AgentPoolWindowsProfile |
| workloadRuntime | ノードが実行できるワークロードの種類を決定します。 | 'KataMshvVmIsolation' 'OCIContainer' 'WasmWasi' |
ManagedClusterAgentPoolProfilePropertiesNodeLabels
| Name | Description | Value |
|---|
ManagedClusterAgentPoolProfilePropertiesTags
| Name | Description | Value |
|---|
ManagedClusterAPIServerAccessProfile
| Name | Description | Value |
|---|---|---|
| authorizedIPRanges | IP 範囲は CIDR 形式で指定されます (例: 137.117.106.88/29)。 この機能は、ノードあたりのパブリック IP を使用するクラスター、または Basic Load Balancer を使用しているクラスターとは互換性がありません。 詳細については、 API サーバーの承認済み IP 範囲を参照してください。 | string[] |
| disableRunCommand | クラスターの実行コマンドを無効にするかどうかを指定します。 | bool |
| enablePrivateCluster | 詳細については、「 プライベート AKS クラスターの作成」を参照してください。 | bool |
| enablePrivateClusterPublicFQDN | プライベート クラスター用に追加のパブリック FQDN を作成するかどうか。 | bool |
| enableVnetIntegration | クラスターの apiserver vnet 統合を有効にするかどうか。 | bool |
| privateDNSZone | 既定値は System です。 詳細については、 プライベート DNS ゾーンの構成に関するページを参照してください。 使用できる値は 'system' と 'none' です。 | 文字列 |
| subnetId | 1 の場合に必要です。 BYO Vnet を使用して新しいクラスターを作成する。2. 既存のクラスターを更新して apiserver vnet 統合を有効にする。 | 文字列 |
ManagedClusterAutoUpgradeProfile
| Name | Description | Value |
|---|---|---|
| nodeOSUpgradeChannel | 既定値はアンマネージドですが、GA で NodeImage または SecurityPatch に変更される可能性があります。 | 'NodeImage' 'None' 'SecurityPatch' 'Unmanaged' |
| upgradeChannel | 詳細については、 AKS クラスターの自動アップグレード チャネルの設定を参照してください。 | 'node-image' 'none' 'patch' 'rapid' 'stable' |
ManagedClusterAzureMonitorProfile
| Name | Description | Value |
|---|---|---|
| メトリクス | prometheus サービス アドオンのメトリック プロファイル | ManagedClusterAzureMonitorProfileMetrics |
ManagedClusterAzureMonitorProfileKubeStateMetrics
| Name | Description | Value |
|---|---|---|
| metricAnnotationsAllowList | リソースのラベル メトリックで使用される追加の Kubernetes ラベル キーのコンマ区切りの一覧。 | 文字列 |
| metricLabelsAllowlist | リソースのラベル メトリックで使用される Kubernetes 注釈キーのコンマ区切りの一覧。 | 文字列 |
ManagedClusterAzureMonitorProfileMetrics
| Name | Description | Value |
|---|---|---|
| enabled | Prometheus コレクターを有効にするかどうか | bool (必須) |
| kubeStateMetrics | コンテナー サービス クラスターの prometheus アドオン プロファイルの Kube 状態メトリック | ManagedClusterAzureMonitorProfileKubeStateMetrics |
ManagedClusterHttpProxyConfig
| Name | Description | Value |
|---|---|---|
| httpProxy | 使用する HTTP プロキシ サーバー エンドポイント。 | 文字列 |
| httpsProxy | 使用する HTTPS プロキシ サーバー エンドポイント。 | 文字列 |
| noProxy | プロキシを経由しないエンドポイント。 | string[] |
| trustedCa | プロキシ サーバーへの接続に使用する代替 CA 証明書。 | 文字列 |
ManagedClusterIdentity
| Name | Description | Value |
|---|---|---|
| 型 | 詳細については、 AKS でのマネージド ID の使用に関する説明を参照してください。 | 'None' 'SystemAssigned' 'UserAssigned' |
| userAssignedIdentities | キーは、"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}" という形式の ARM リソース ID である必要があります。 | ManagedClusterIdentityUserAssignedIdentities |
ManagedClusterIdentityUserAssignedIdentities
| Name | Description | Value |
|---|
ManagedClusterIngressProfile
| Name | Description | Value |
|---|---|---|
| webAppRouting | イングレス プロファイルの Web アプリ ルーティング設定。 | ManagedClusterIngressProfileWebAppRouting |
ManagedClusterIngressProfileWebAppRouting
| Name | Description | Value |
|---|---|---|
| dnsZoneResourceId | Web アプリに関連付ける DNS ゾーンのリソース ID。 Web アプリ ルーティングが有効になっている場合にのみ使用されます。 | 文字列 |
| enabled | Web アプリのルーティングを有効にするかどうかを指定します。 | bool |
ManagedClusterLoadBalancerProfile
| Name | Description | Value |
|---|---|---|
| allocatedOutboundPorts | VM ごとに割り当てられた SNAT ポートの必要な数。 使用できる値は、0 ~ 64000 (含む) の範囲です。 既定値は 0 で、Azure でポートが動的に割り当てられます。 | int Constraints: 最小値 = 0 最大値 = 64000 |
| backendPoolType | マネージド受信ロード バランサー BackendPool の種類。 | 'NodeIP' 'NodeIPConfiguration' |
| effectiveOutboundIPs | クラスター ロード バランサーの有効な送信 IP リソース。 | ResourceReference[] |
| enableMultipleStandardLoadBalancers | AKS クラスターごとに複数の Standard ロード バランサーを有効にするかどうか。 | bool |
| idleTimeoutInMinutes | 必要な送信フローのアイドル タイムアウト (分単位)。 使用できる値の範囲は、4 ~ 120 (両端を含む) です。 既定値は 30 分です。 | int Constraints: 最小値 = 4 最大値 = 120 |
| managedOutboundIPs | クラスター ロード バランサーに必要なマネージド送信 IP。 | ManagedClusterLoadBalancerProfileManagedOutboundIPs |
| outboundIPPrefixes | クラスター ロード バランサーに必要な送信 IP プレフィックス リソース。 | ManagedClusterLoadBalancerProfileOutboundIPPrefixes |
| outboundIPs | クラスター ロード バランサーに必要な送信 IP リソース。 | ManagedClusterLoadBalancerProfileOutboundIPs |
ManagedClusterLoadBalancerProfileManagedOutboundIPs
| Name | Description | Value |
|---|---|---|
| count | クラスター ロード バランサー用に Azure によって作成/管理される IPv4 送信 IP の目的の数。 使用できる値は、1 ~ 100 (両端を含む) の範囲である必要があります。 既定値は 1 です。 | int Constraints: 最小値 = 1 最大値 = 100 |
| countIPv6 | クラスター ロード バランサー用に Azure によって作成/管理される IPv6 送信 IP の目的の数。 使用できる値は、1 ~ 100 (両端を含む) の範囲である必要があります。 既定値は、単一スタックの場合は 0、デュアル スタックの場合は 1 です。 | int Constraints: 最小値 = 0 最大値 = 100 |
ManagedClusterLoadBalancerProfileOutboundIPPrefixes
| Name | Description | Value |
|---|---|---|
| publicIPPrefixes | パブリック IP プレフィックス リソースの一覧。 | ResourceReference[] |
ManagedClusterLoadBalancerProfileOutboundIPs
| Name | Description | Value |
|---|---|---|
| publicIPs | パブリック IP リソースの一覧。 | ResourceReference[] |
ManagedClusterManagedOutboundIPProfile
| Name | Description | Value |
|---|---|---|
| count | Azure によって作成/管理される送信 IP の目的の数。 使用できる値は、1 ~ 16 (両端を含む) の範囲である必要があります。 既定値は 1 です。 | int Constraints: 最小値 = 1 最大値 = 16 |
ManagedClusterNATGatewayProfile
| Name | Description | Value |
|---|---|---|
| effectiveOutboundIPs | クラスター NAT ゲートウェイの有効な送信 IP リソース。 | ResourceReference[] |
| idleTimeoutInMinutes | 必要な送信フローのアイドル タイムアウト (分単位)。 使用できる値の範囲は、4 ~ 120 (両端を含む) です。 既定値は 4 分です。 | int Constraints: 最小値 = 4 最大値 = 120 |
| managedOutboundIPProfile | クラスター NAT ゲートウェイのマネージド送信 IP リソースのプロファイル。 | ManagedClusterManagedOutboundIPProfile |
ManagedClusterNodeResourceGroupProfile
| Name | Description | Value |
|---|---|---|
| restrictionLevel | クラスターのノード リソース グループに適用される制限レベル | 'ReadOnly' 'Unrestricted' |
ManagedClusterOidcIssuerProfile
| Name | Description | Value |
|---|---|---|
| enabled | OIDC 発行者が有効かどうか。 | bool |
ManagedClusterPodIdentity
| Name | Description | Value |
|---|---|---|
| bindingSelector | AzureIdentityBinding リソースに使用するバインド セレクター。 | 文字列 |
| ID | ユーザー割り当て ID の詳細。 | UserAssignedIdentity (必須) |
| name | ポッド ID の名前。 | string (必須) |
| 名前空間 | ポッド ID の名前空間。 | string (必須) |
ManagedClusterPodIdentityException
| Name | Description | Value |
|---|---|---|
| name | ポッド ID 例外の名前。 | string (必須) |
| 名前空間 | ポッド ID 例外の名前空間。 | string (必須) |
| podLabels | 一致するポッド ラベル。 | ManagedClusterPodIdentityExceptionPodLabels (必須) |
ManagedClusterPodIdentityExceptionPodLabels
| Name | Description | Value |
|---|
ManagedClusterPodIdentityProfile
| Name | Description | Value |
|---|---|---|
| allowNetworkPluginKubenet | AAD ポッド ID のセキュリティ関連の性質と IP スプーフィングのリスクにより、Kubenet での実行は既定で無効になっています。 詳細については、 AAD ポッド ID での Kubenet ネットワーク プラグインの使用 を参照してください。 | bool |
| enabled | ポッド ID アドオンが有効かどうか。 | bool |
| userAssignedIdentities | クラスターで使用するポッド ID。 | ManagedClusterPodIdentity[] |
| userAssignedIdentityExceptions | 許可するポッド ID の例外。 | ManagedClusterPodIdentityException[] |
ManagedClusterProperties
| Name | Description | Value |
|---|---|---|
| aadProfile | Azure Active Directory の構成。 | ManagedClusterAADProfile |
| addonProfiles | マネージド クラスター アドオンのプロファイル。 | ManagedClusterPropertiesAddonProfiles |
| agentPoolProfiles | エージェント プールのプロパティ。 | ManagedClusterAgentPoolProfile[] |
| apiServerAccessProfile | マネージド クラスター API サーバーのアクセス プロファイル。 | ManagedClusterAPIServerAccessProfile |
| autoScalerProfile | 有効な場合にクラスター オートスケーラーに適用されるパラメーター | ManagedClusterPropertiesAutoScalerProfile |
| autoUpgradeProfile | 自動アップグレードの構成。 | ManagedClusterAutoUpgradeProfile |
| azureMonitorProfile | コンテナー サービス クラスターの Prometheus アドオン プロファイル | ManagedClusterAzureMonitorProfile |
| creationData | クラスターがスナップショットを使用して作成またはアップグレードされる場合に、ソース スナップショット ID を指定するために使用される CreationData。 | CreationData |
| disableLocalAccounts | true に設定すると、このクラスターで静的資格情報の取得が無効になります。 これは、AAD が有効になっているマネージド クラスターでのみ使用する必要があります。 詳細については、 ローカル アカウントの無効化に関するページを参照してください。 | bool |
| diskEncryptionSetID | "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/diskEncryptionSets/{encryptionSetName}" の形式です。 | 文字列 |
| dnsPrefix | これは、マネージド クラスターが作成された後は更新できません。 | 文字列 |
| enableNamespaceResources | 既定値は false です。 マネージド クラスターの作成と更新時に有効または無効にすることができます。 ARM リソースとしての名前空間の詳細については、 https://aka.ms/NamespaceARMResource を参照してください。 | bool |
| enablePodSecurityPolicy | (非推奨)Kubernetes ポッドのセキュリティ ポリシー (プレビュー) を有効にするかどうかを指定します。 PodSecurityPolicy は Kubernetes v1.21 で非推奨となり、v1.25 の Kubernetes から削除されました。 詳細については、 https://aka.ms/k8s/psp と https://aka.ms/aks/pspを参照してください。 | bool |
| enableRBAC | Kubernetes Role-Based アクセス制御を有効にするかどうかを指定します。 | bool |
| fqdnSubdomain | これは、マネージド クラスターが作成された後は更新できません。 | 文字列 |
| guardrailsProfile | ガードレール プロファイルは、特定のクラスターのすべてのガードレール情報を保持します。 | GuardrailsProfile |
| httpProxyConfig | HTTP プロキシ サーバーを使用してクラスターをプロビジョニングするための構成。 | ManagedClusterHttpProxyConfig |
| identityProfile | クラスターに関連付けられている ID。 | ManagedClusterPropertiesIdentityProfile |
| ingressProfile | マネージド クラスターのイングレス プロファイル。 | ManagedClusterIngressProfile |
| kubernetesVersion | サポートされている 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 | エージェント プール ノードを含むリソース グループの名前。 | 文字列 |
| nodeResourceGroupProfile | ノード リソース グループ構成プロファイル。 | ManagedClusterNodeResourceGroupProfile |
| oidcIssuerProfile | マネージド クラスターの OIDC 発行者プロファイル。 | ManagedClusterOidcIssuerProfile |
| podIdentityProfile | AAD ポッド ID の統合の詳細については、AAD ポッド ID の使用に関するページを参照してください。 | ManagedClusterPodIdentityProfile |
| privateLinkResources | クラスターに関連付けられているプライベート リンク リソース。 | PrivateLinkResource[] |
| publicNetworkAccess | AKS のパブリック ネットワーク アクセスを許可または拒否する | 'Disabled' 'Enabled' 'SecuredByPerimeter' |
| securityProfile | マネージド クラスターのセキュリティ プロファイル。 | ManagedClusterSecurityProfile |
| serviceMeshProfile | マネージド クラスターのサービス メッシュ プロファイル。 | ServiceMeshProfile |
| servicePrincipalProfile | Azure API の操作に使用するクラスターのサービス プリンシパル ID に関する情報。 | ManagedClusterServicePrincipalProfile |
| storageProfile | マネージド クラスターのストレージ プロファイル。 | ManagedClusterStorageProfile |
| upgradeSettings | クラスターをアップグレードするための設定。 | ClusterUpgradeSettings |
| windowsProfile | マネージド クラスター内の Windows VM のプロファイル。 | ManagedClusterWindowsProfile |
| workloadAutoScalerProfile | マネージド クラスターのワークロード 自動スケーラー プロファイル。 | ManagedClusterWorkloadAutoScalerProfile |
ManagedClusterPropertiesAddonProfiles
| Name | Description | Value |
|---|
ManagedClusterPropertiesAutoScalerProfile
| Name | Description | Value |
|---|---|---|
| balance-similar-node-groups | 有効な値は 'true' と 'false' です | 文字列 |
| expander | 指定しない場合、既定値は 'random' です。 詳細については、「 expanders を参照してください。 | 'least-waste' 'most-pods' '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 スケジューラがすべてのポッドをスケジュールする前に CA を動作させたくないバースト/バッチ スケールなどのシナリオでは、特定の期間になる前にスケジュールされていないポッドを無視するように CA に指示できます。 既定値は '0s' です。 値は整数の後に単位 (秒の場合は 's'、分の場合は '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 です。 | 文字列 |
| skip-nodes-with-system-pods | 既定値は true です。 | 文字列 |
ManagedClusterPropertiesIdentityProfile
| Name | Description | Value |
|---|
ManagedClusterSecurityProfile
| Name | Description | Value |
|---|---|---|
| azureKeyVaultKms | セキュリティ プロファイルの Azure Key Vault キー管理サービス の設定。 | AzureKeyVaultKms |
| customCATrustCertificates | カスタム CA 信頼機能が有効になっているノードの信頼ストアに追加される、最大 10 個の base64 でエンコードされた CA の一覧。 詳細については、「カスタム CA 信頼証明書」を参照してください。 | any[] |
| defender | セキュリティ プロファイルの Microsoft Defender 設定。 | ManagedClusterSecurityProfileDefender |
| imageCleaner | セキュリティ プロファイルのイメージ クリーナー設定。 | ManagedClusterSecurityProfileImageCleaner |
| nodeRestriction | セキュリティプロファイルのノード制限設定。 | ManagedClusterSecurityProfileNodeRestriction |
| workloadIdentity | セキュリティ プロファイルのワークロード ID 設定。 ワークロード ID を使用すると、Kubernetes アプリケーションは Azure AD を使用して Azure クラウド リソースに安全にアクセスできます。 詳細については、https://aka.ms/aks/wiを参照してください。 | ManagedClusterSecurityProfileWorkloadIdentity |
ManagedClusterSecurityProfileDefender
| Name | Description | Value |
|---|---|---|
| logAnalyticsWorkspaceResourceId | Microsoft Defender に関連付ける Log Analytics ワークスペースのリソース ID。 Microsoft Defender が有効になっている場合、このフィールドは必須であり、有効なワークスペース リソース ID である必要があります。 Microsoft Defender が無効になっている場合は、フィールドを空のままにします。 | 文字列 |
| securityMonitoring | セキュリティ プロファイルのクラウド設定に対する Microsoft Defender 脅威検出。 | ManagedClusterSecurityProfileDefenderSecurityMonitoring |
ManagedClusterSecurityProfileDefenderSecurityMonitoring
| Name | Description | Value |
|---|---|---|
| enabled | Defender 脅威検出を有効にするかどうか | bool |
ManagedClusterSecurityProfileImageCleaner
| Name | Description | Value |
|---|---|---|
| enabled | AKS クラスターでイメージ クリーナーを有効にするかどうか。 | bool |
| intervalHours | イメージ クリーナーのスキャン間隔 (時間単位)。 | int |
ManagedClusterSecurityProfileNodeRestriction
| Name | Description | Value |
|---|---|---|
| enabled | ノード制限を有効にするかどうか | bool |
ManagedClusterSecurityProfileWorkloadIdentity
| Name | Description | Value |
|---|---|---|
| enabled | ワークロード ID を有効にするかどうか。 | bool |
ManagedClusterServicePrincipalProfile
| Name | Description | Value |
|---|---|---|
| clientId | サービス プリンシパルの ID。 | string (必須) |
| シークレット | プレーン テキストでサービス プリンシパルに関連付けられているシークレット パスワード。 | string Constraints: 機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。 |
ManagedClusterSKU
| Name | Description | Value |
|---|---|---|
| name | マネージド クラスター SKU の名前。 | 'Base' |
| レベル | 指定しない場合、既定値は "Free" です。 詳細については、 AKS 価格レベル を参照してください。 | 'Free' 'Standard' |
ManagedClusterStorageProfile
| Name | Description | Value |
|---|---|---|
| blobCSIDriver | ストレージ プロファイルの AzureBlob CSI ドライバー設定。 | ManagedClusterStorageProfileBlobCSIDriver |
| diskCSIDriver | ストレージ プロファイルの AzureDisk CSI ドライバー設定。 | ManagedClusterStorageProfileDiskCSIDriver |
| fileCSIDriver | ストレージ プロファイルの AzureFile CSI ドライバー設定。 | ManagedClusterStorageProfileFileCSIDriver |
| snapshotController | ストレージ プロファイルのスナップショット コントローラーの設定。 | ManagedClusterStorageProfileSnapshotController |
ManagedClusterStorageProfileBlobCSIDriver
| Name | Description | Value |
|---|---|---|
| enabled | AzureBlob CSI ドライバーを有効にするかどうか。 既定値は false です。 | bool |
ManagedClusterStorageProfileDiskCSIDriver
| Name | Description | Value |
|---|---|---|
| enabled | AzureDisk CSI ドライバーを有効にするかどうか。 これは既定値は true です。 | bool |
| バージョン | AzureDisk CSI ドライバーのバージョン。 既定値は v1 です。 | 文字列 |
ManagedClusterStorageProfileFileCSIDriver
| Name | Description | Value |
|---|---|---|
| enabled | AzureFile CSI ドライバーを有効にするかどうか。 これは既定値は true です。 | bool |
ManagedClusterStorageProfileSnapshotController
| Name | Description | Value |
|---|---|---|
| enabled | スナップショット コントローラーを有効にするかどうかを指定します。 これは既定値は true です。 | bool |
ManagedClusterWindowsProfile
| Name | Description | Value |
|---|---|---|
| adminPassword | 管理者アカウントのパスワードを指定します。 最小長: 8 文字 最大長: 123 文字 複雑さの要件: 以下の 4 つの条件のうち 3 つ を満たす必要があります 文字が小さい 上の文字を含む 数字を含む 特殊文字を持つ (Regex match [\W_]) 許可されていない値: "abc@123"、"P@$$w 0rd"、"P@ssw0rd"、"P@ssword123"、"Pa$$word"、"pass@word1"、"Password!"、"Password1"、"Password22"、"iloveyou!" |
文字列 |
| 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' |
ManagedClusterWorkloadAutoScalerProfile
| Name | Description | Value |
|---|---|---|
| keda | ワークロード 自動スケーラー プロファイルの KEDA (Kubernetes イベント ドリブン自動スケーリング) 設定。 | ManagedClusterWorkloadAutoScalerProfileKeda |
| verticalPodAutoscaler | ManagedClusterWorkloadAutoScalerProfileVerticalPodAutoscaler |
ManagedClusterWorkloadAutoScalerProfileKeda
| Name | Description | Value |
|---|---|---|
| enabled | KEDA を有効にするかどうか。 | bool (必須) |
ManagedClusterWorkloadAutoScalerProfileVerticalPodAutoscaler
| Name | Description | Value |
|---|---|---|
| controlledValues | どのリソース値オートスケーラーが変更されるかを制御します。 既定値は RequestsAndLimits です。 | 'RequestsAndLimits' 'RequestsOnly' (必須) |
| enabled | VPA を有効にするかどうか。 既定値は false です。 | bool (必須) |
| updateMode | 各更新モード レベルは、下位レベルのスーパーセットです。 Off<Initial<Recreate<=Auto。たとえば、UpdateMode が Initial の場合、VPA は VerticalPodAutoscaler カスタム リソースの推奨リソースを (UpdateMode Off から) 設定し、ポッドの作成時に (Initial から) リソースも割り当てることを意味します。 既定値は [オフ] です。 | 'Auto' 'Initial' 'Off' 「再作成」(必須) |
ManagedServiceIdentityUserAssignedIdentitiesValue
| Name | Description | Value |
|---|
PortRange
| Name | Description | Value |
|---|---|---|
| portEnd | 範囲に含まれる最大ポート。 範囲は 1 から 65535 で、portStart 以上である必要があります。 | int Constraints: 最小値 = 1 最大値 = 65535 |
| portStart | 範囲に含まれる最小ポート。 範囲は 1 から 65535 で、portEnd 以下である必要があります。 | int Constraints: 最小値 = 1 最大値 = 65535 |
| プロトコル | ポートのネットワーク プロトコル。 | 'TCP' 'UDP' |
PowerState
| Name | Description | Value |
|---|---|---|
| コード | クラスターが実行中か停止かを示します | 'Running' 'Stopped' |
PrivateLinkResource
| Name | Description | Value |
|---|---|---|
| groupId | リソースのグループ ID。 | 文字列 |
| id | プライベート リンク リソースの ID。 | 文字列 |
| name | プライベート リンク リソースの名前。 | 文字列 |
| requiredMembers | リソースの RequiredMembers | string[] |
| 型 | リソースの種類。 | 文字列 |
ResourceReference
| Name | Description | Value |
|---|---|---|
| id | 完全修飾 Azure リソース ID。 | 文字列 |
ServiceMeshProfile
| Name | Description | Value |
|---|---|---|
| istio | Istio サービス メッシュの構成。 | IstioServiceMesh |
| mode | サービス メッシュのモード。 | 'Disabled' 'Istio' (必須) |
SysctlConfig
| Name | Description | Value |
|---|---|---|
| fsAioMaxNr | sysctl setting fs.aio-max-nr. | int |
| fsFileMax | sysctl 設定 fs.file-max. | int |
| fsInotifyMaxUserWatches | sysctl setting fs.inotify.max_user_watches. | int |
| fsNrOpen | Sysctl 設定fs.nr_open。 | int |
| kernelThreadsMax | sysctl setting 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 setting 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 setting vm.max_map_count. | int |
| vmSwappiness | sysctl setting vm.swappiness. | int |
| vmVfsCachePressure | Sysctl 設定vm.vfs_cache_pressure。 | int |
TrackedResourceTags
| Name | Description | Value |
|---|
UpgradeOverrideSettings
| Name | Description | Value |
|---|---|---|
| controlPlaneOverrides | クラスターのコントロール プレーンをアップグレードするときのアップグレードオーバーライドの一覧。 | 次のいずれかを含む文字列配列: 'IgnoreKubernetesDeprecations' |
| until | オーバーライドが有効になるまで。 これはアップグレードの開始時刻にのみ一致し、アップグレードの進行に応じて until の有効期限が切れた場合でも、アップグレードの開始時に有効性は変わらないことに注意してください。 このフィールドは既定では設定されていません。 オーバーライドを有効にするには、この値を設定する必要があります。 |
文字列 |
UserAssignedIdentity
| Name | Description | Value |
|---|---|---|
| clientId | ユーザー割り当て ID のクライアント ID。 | 文字列 |
| objectId | ユーザー割り当て ID のオブジェクト ID。 | 文字列 |
| resourceId | ユーザー割り当て ID のリソース ID。 | 文字列 |
WindowsGmsaProfile
| Name | Description | Value |
|---|---|---|
| dnsServer | Windows gMSA の DNS サーバーを指定します。 マネージド クラスターの作成に使用する vnet 内の DNS サーバーを構成している場合は、これを空に設定します。 |
文字列 |
| enabled | マネージド クラスターで Windows gMSA を有効にするかどうかを指定します。 | bool |
| rootDomainName | Windows gMSA のルート ドメイン名を指定します。 マネージド クラスターの作成に使用する vnet 内の DNS サーバーを構成している場合は、これを空に設定します。 |
文字列 |
使用例
Azure クイックスタート テンプレート
このリソースの種類 デプロイする Azure クイック スタート テンプレート 次に示します。
| Template | Description |
|---|---|
| NAT ゲートウェイと Application Gateway を使用して AKS クラスターを |
このサンプルでは、送信接続用の NAT ゲートウェイと受信接続用の Application Gateway を使用して AKS クラスターをデプロイする方法を示します。 |
| Application Gateway イングレス コントローラー を使用して AKS クラスターを |
このサンプルでは、Application Gateway、Application Gateway イングレス コントローラー、Azure Container Registry、Log Analytics、Key Vault を使用して AKS クラスターをデプロイする方法を示します |
|
Azure コンテナー サービス (AKS) |
Azure Linux コンテナー ホストを使用して Azure Container Service (AKS) でマネージド クラスターをデプロイする |
|
Azure コンテナー サービス (AKS) |
Azure Container Service (AKS) を使用してマネージド クラスターをデプロイする |
| Helm を使用して Azure Container Service (AKS) を |
Helm を使用して Azure Container Service (AKS) を使用してマネージド クラスターをデプロイする |
|
Azure Kubernetes Service (AKS) |
Azure Kubernetes Service (AKS) を使用してマネージド Kubernetes クラスターをデプロイします |
| Azure Machine Learning のエンド ツー エンドのセキュリティで保護されたセットアップ を |
この Bicep テンプレートのセットは、セキュリティで保護されたセットアップで Azure Machine Learning をエンド ツー エンドで設定する方法を示しています。 この参照実装には、ワークスペース、コンピューティング クラスター、コンピューティング インスタンス、接続されたプライベート AKS クラスターが含まれます。 |
| Azure Machine Learning のエンド ツー エンドのセキュリティで保護されたセットアップ (レガシ) を |
この Bicep テンプレートのセットは、セキュリティで保護されたセットアップで Azure Machine Learning をエンド ツー エンドで設定する方法を示しています。 この参照実装には、ワークスペース、コンピューティング クラスター、コンピューティング インスタンス、接続されたプライベート AKS クラスターが含まれます。 |
| Azure Container Service (AKS) で Jenkins を使用して CI/CD を |
コンテナーを使用すると、アプリケーションを継続的にビルドしてデプロイすることが非常に簡単になります。 Azure Container Service で Kubernetes を使用してこれらのコンテナーのデプロイを調整することで、コンテナーのレプリケート可能で管理しやすいクラスターを実現できます。 コンテナー イメージとオーケストレーションを生成するように継続的ビルドを設定することで、デプロイの速度と信頼性を向上させることができます。 |
| プライベート AKS クラスター を作成する |
このサンプルでは、ジャンプボックス仮想マシンと共に仮想ネットワークにプライベート AKS クラスターを作成する方法を示します。 |
| パブリック DNS ゾーン を使用してプライベート AKS クラスターを作成する |
このサンプルでは、パブリック DNS ゾーンを使用してプライベート AKS クラスターをデプロイする方法を示します。 |
|
Prometheus で AKS を作成し、privae リンクを使用して Grafana |
これにより、Azure grafana、AKS が作成され、オープンソースの監視およびアラート ツールキットである Prometheus が Azure Kubernetes Service (AKS) クラスターにインストールされます。 次に、Azure Managed Grafana のマネージド プライベート エンドポイントを使用してこの Prometheus サーバーに接続し、Grafana ダッシュボードに Prometheus データを表示します |
|
マネージド Kubernetes クラスター (AKS) をデプロイする |
この ARM テンプレートは、高度なネットワーク機能を持つ AKS インスタンスを既存の仮想ネットワークにデプロイする方法を示しています。 さらに、選択したサービス プリンシパルには、AKS クラスターを含むサブネットに対するネットワーク共同作成者ロールが割り当てられます。 |
|
AAD (AKS) を使用してマネージド Kubernetes クラスターをデプロイする |
この ARM テンプレートは、既存の仮想ネットワークと Azure AD Integeration への高度なネットワーク機能を備えた AKS インスタンスのデプロイを示しています。 さらに、選択したサービス プリンシパルには、AKS クラスターを含むサブネットに対するネットワーク共同作成者ロールが割り当てられます。 |
|
Azure ML 用の AKS クラスターをデプロイする |
このテンプレートを使用すると、Azure ML にアタッチできる、前もって準拠している AKS クラスターをデプロイできます |
| Azure Gateway の |
Blob Storage によってサポートされる S3 準拠ストレージ API を提供する完全プライベート min.io Azure Gateway デプロイ |
Terraform (AzAPI プロバイダー) リソース定義
managedClusters リソースの種類は、次を対象とする操作と共にデプロイできます。
各 API バージョンで変更されたプロパティの一覧については、変更ログの
リソースの形式
Microsoft.ContainerService/managedClusters リソースを作成するには、次の Terraform をテンプレートに追加します。
resource "azapi_resource" "symbolicname" {
type = "Microsoft.ContainerService/managedClusters@2023-02-02-preview"
name = "string"
parent_id = "string"
identity {
type = "string"
identity_ids = [
"string"
]
}
location = "string"
tags = {
{customized property} = "string"
}
body = {
extendedLocation = {
name = "string"
type = "string"
}
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"
]
capacityReservationGroupID = "string"
count = int
creationData = {
sourceResourceId = "string"
}
enableAutoScaling = bool
enableCustomCATrust = 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
messageOfTheDay = "string"
minCount = int
mode = "string"
name = "string"
networkProfile = {
allowedHostPorts = [
{
portEnd = int
portStart = int
protocol = "string"
}
]
applicationSecurityGroups = [
"string"
]
nodePublicIPTags = [
{
ipTagType = "string"
tag = "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 = int
tags = {
{customized property} = "string"
}
type = "string"
upgradeSettings = {
maxSurge = "string"
}
vmSize = "string"
vnetSubnetID = "string"
windowsProfile = {
disableOutboundNat = bool
}
workloadRuntime = "string"
}
]
apiServerAccessProfile = {
authorizedIPRanges = [
"string"
]
disableRunCommand = bool
enablePrivateCluster = bool
enablePrivateClusterPublicFQDN = bool
enableVnetIntegration = bool
privateDNSZone = "string"
subnetId = "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 = {
nodeOSUpgradeChannel = "string"
upgradeChannel = "string"
}
azureMonitorProfile = {
metrics = {
enabled = bool
kubeStateMetrics = {
metricAnnotationsAllowList = "string"
metricLabelsAllowlist = "string"
}
}
}
creationData = {
sourceResourceId = "string"
}
disableLocalAccounts = bool
diskEncryptionSetID = "string"
dnsPrefix = "string"
enableNamespaceResources = bool
enablePodSecurityPolicy = bool
enableRBAC = bool
fqdnSubdomain = "string"
guardrailsProfile = {
excludedNamespaces = [
"string"
]
level = "string"
version = "string"
}
httpProxyConfig = {
httpProxy = "string"
httpsProxy = "string"
noProxy = [
"string"
]
trustedCa = "string"
}
identityProfile = {
{customized property} = {
clientId = "string"
objectId = "string"
resourceId = "string"
}
}
ingressProfile = {
webAppRouting = {
dnsZoneResourceId = "string"
enabled = bool
}
}
kubernetesVersion = "string"
linuxProfile = {
adminUsername = "string"
ssh = {
publicKeys = [
{
keyData = "string"
}
]
}
}
networkProfile = {
dnsServiceIP = "string"
dockerBridgeCidr = "string"
ipFamilies = [
"string"
]
kubeProxyConfig = {
enabled = bool
ipvsConfig = {
scheduler = "string"
tcpFinTimeoutSeconds = int
tcpTimeoutSeconds = int
udpTimeoutSeconds = int
}
mode = "string"
}
loadBalancerProfile = {
allocatedOutboundPorts = int
backendPoolType = "string"
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
}
}
networkDataplane = "string"
networkMode = "string"
networkPlugin = "string"
networkPluginMode = "string"
networkPolicy = "string"
outboundType = "string"
podCidr = "string"
podCidrs = [
"string"
]
serviceCidr = "string"
serviceCidrs = [
"string"
]
}
nodeResourceGroup = "string"
nodeResourceGroupProfile = {
restrictionLevel = "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"
}
customCATrustCertificates = [
?
]
defender = {
logAnalyticsWorkspaceResourceId = "string"
securityMonitoring = {
enabled = bool
}
}
imageCleaner = {
enabled = bool
intervalHours = int
}
nodeRestriction = {
enabled = bool
}
workloadIdentity = {
enabled = bool
}
}
serviceMeshProfile = {
istio = {
components = {
ingressGateways = [
{
enabled = bool
mode = "string"
}
]
}
}
mode = "string"
}
servicePrincipalProfile = {
clientId = "string"
secret = "string"
}
storageProfile = {
blobCSIDriver = {
enabled = bool
}
diskCSIDriver = {
enabled = bool
version = "string"
}
fileCSIDriver = {
enabled = bool
}
snapshotController = {
enabled = bool
}
}
upgradeSettings = {
overrideSettings = {
controlPlaneOverrides = [
"string"
]
until = "string"
}
}
windowsProfile = {
adminPassword = "string"
adminUsername = "string"
enableCSIProxy = bool
gmsaProfile = {
dnsServer = "string"
enabled = bool
rootDomainName = "string"
}
licenseType = "string"
}
workloadAutoScalerProfile = {
keda = {
enabled = bool
}
verticalPodAutoscaler = {
controlledValues = "string"
enabled = bool
updateMode = "string"
}
}
}
sku = {
name = "string"
tier = "string"
}
}
}
プロパティ値
Microsoft.ContainerService/managedClusters
| Name | Description | Value |
|---|---|---|
| extendedLocation | 仮想マシンの拡張された場所。 | ExtendedLocation |
| ID | マネージド クラスターの ID (構成されている場合)。 | ManagedClusterIdentity |
| 位置 | リソースが存在する地理的な場所 | string (必須) |
| name | リソース名 | string Constraints: 最小長 = 1 最大長 = 63 パターン = ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-_a-zA-Z0-9]{0,61}[a-zA-Z0-9]$ (必須) |
| parent_id | この拡張リソースを適用するリソースの ID。 | string (必須) |
| properties | マネージド クラスターのプロパティ。 | ManagedClusterProperties |
| sku | マネージド クラスター SKU。 | ManagedClusterSKU |
| tags | リソース タグ | タグ名と値のディクショナリ。 |
| 型 | リソースの種類 | "Microsoft.ContainerService/managedClusters@2023-02-02-preview" |
AgentPoolNetworkProfile
| Name | Description | Value |
|---|---|---|
| allowedHostPorts | アクセスが許可されているポート範囲。 指定した範囲は重複できます。 | PortRange[] |
| applicationSecurityGroups | エージェント プールの作成時に関連付けるアプリケーション セキュリティ グループの ID。 | string[] |
| nodePublicIPTags | インスタンス レベルのパブリック IP の IP タグ。 | IPTag[] |
AgentPoolUpgradeSettings
| Name | Description | Value |
|---|---|---|
| maxSurge | これは、整数 (例: '5') またはパーセンテージ (例: '50%') に設定できます。 パーセンテージを指定すると、アップグレード時のエージェント・プール・サイズの合計に対するパーセンテージになります。 パーセンテージの場合、小数部のノードは切り上げられます。 指定しない場合、既定値は 1 です。 ベスト プラクティスを含む詳細については、「/azure/aks/upgrade-cluster#customize-node-surge-upgrade」を参照してください。 | 文字列 |
AgentPoolWindowsProfile
| Name | Description | Value |
|---|---|---|
| disableOutboundNat | 既定値は false です。 送信 NAT を無効にできるのは、クラスターの outboundType が NAT ゲートウェイであり、Windows エージェント プールでノード パブリック IP が有効になっていない場合のみです。 | bool |
AzureKeyVaultKms
| Name | Description | Value |
|---|---|---|
| enabled | 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されている場合は、フィールドを空のままにします。 |
文字列 |
ClusterUpgradeSettings
| Name | Description | Value |
|---|---|---|
| overrideSettings | オーバーライドの設定。 | UpgradeOverrideSettings |
ContainerServiceLinuxProfile
| Name | Description | Value |
|---|---|---|
| adminUsername | Linux VM に使用する管理者ユーザー名。 | string Constraints: パターン = ^[A-Za-z][-A-Za-z0-9_]*$ (必須) |
| ssh | Azure で実行されている Linux ベースの VM の SSH 構成。 | ContainerServiceSshConfiguration (必須) |
ContainerServiceNetworkProfile
| Name | Description | Value |
|---|---|---|
| dnsServiceIP | Kubernetes DNS サービスに割り当てられた IP アドレス。 これは、serviceCidr で指定された Kubernetes サービス アドレス範囲内にある必要があります。 | string Constraints: パターン = ^(?:(?: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 Constraints: パターン = ^([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' |
| kubeProxyConfig | kube-proxy の構成のカスタマイズを保持します。 定義されていない値は、kube-proxy の既定の動作を使用します。 https://v<バージョン>.docs.kubernetes.io/docs/reference/command-line-tools-reference/kube-proxy/ を参照してください。 <version> は <バージョン>-<minor バージョン> 文字列で表されます。 Kubernetes バージョン 1.23 は '1-23' になります。 | ContainerServiceNetworkProfileKubeProxyConfig |
| loadBalancerProfile | クラスター ロード バランサーのプロファイル。 | ManagedClusterLoadBalancerProfile |
| loadBalancerSku | 既定値は 'standard' です。 ロード バランサー SKU の違いの詳細については、Azure Load Balancer SKU に関するページを参照してください。 | 'basic' 'standard' |
| natGatewayProfile | クラスター NAT ゲートウェイのプロファイル。 | ManagedClusterNATGatewayProfile |
| networkDataplane | Kubernetes クラスターで使用されるネットワーク データプレーン。 | 'azure' 'cilium' |
| networkMode | networkPlugin が 'azure' 以外の場合は、これを指定できません。 | 'bridge' 'transparent' |
| networkPlugin | Kubernetes ネットワークの構築に使用されるネットワーク プラグイン。 | 'azure' 'kubenet' 'none' |
| networkPluginMode | Kubernetes ネットワークの構築に使用されるネットワーク プラグイン モード。 | 'Overlay' |
| networkPolicy | Kubernetes ネットワークの構築に使用されるネットワーク ポリシー。 | 'azure' 'calico' 'cilium' |
| outboundType | これはクラスター作成時にのみ設定でき、後で変更することはできません。 詳細については、 エグレス送信の種類を参照してください。 | 'loadBalancer' 'managedNATGateway' 'userAssignedNATGateway' 'userDefinedRouting' |
| podCidr | kubenet の使用時にポッド IP を割り当てる CIDR 表記 IP 範囲。 | string Constraints: パターン = ^([0-9]{1,3}\.){3}[0-9]{1,3}(\/([0-9]|[1-2][0-9]|3[0-2]))?$ |
| podCidrs | 単一スタック ネットワークでは、1 つの IPv4 CIDR が必要です。 デュアルスタック ネットワークでは、2 つの CIDR (各 IP ファミリ (IPv4/IPv6) に 1 つ) が必要です。 | string[] |
| serviceCidr | サービス クラスター IP を割り当てる CIDR 表記 IP 範囲。 サブネット IP 範囲と重複しないようにする必要があります。 | string Constraints: パターン = ^([0-9]{1,3}\.){3}[0-9]{1,3}(\/([0-9]|[1-2][0-9]|3[0-2]))?$ |
| serviceCidrs | 単一スタック ネットワークでは、1 つの IPv4 CIDR が必要です。 デュアルスタック ネットワークでは、2 つの CIDR (各 IP ファミリ (IPv4/IPv6) に 1 つ) が必要です。 サブネット IP 範囲と重複しないようにする必要があります。 | string[] |
ContainerServiceNetworkProfileKubeProxyConfig
| Name | Description | Value |
|---|---|---|
| enabled | クラスター上の kube-proxy で有効にするかどうかを指定します ('kubeProxyConfig' が存在しない場合、kube-proxy は既定でこれらのカスタマイズなしで AKS で有効になります)。 | bool |
| ipvsConfig | IPVS の構成のカスタマイズを保持します。 'mode' が 'IPVS' に設定されている場合にのみ指定できます。 | ContainerServiceNetworkProfileKubeProxyConfigIpvsConfig |
| mode | 使用するプロキシ モード ('IPTABLES' または 'IPVS') を指定する | 'IPTABLES' 'IPVS' |
ContainerServiceNetworkProfileKubeProxyConfigIpvsConfig
| Name | Description | Value |
|---|---|---|
| scheduler | IPVS スケジューラの詳細については、 http://www.linuxvirtualserver.org/docs/scheduling.htmlを参照してください。 | 'LeastConnection' 'RoundRobin' |
| tcpFinTimeoutSeconds | FIN を受信した後の IPVS TCP セッションに使用されるタイムアウト値 (秒単位)。 正の整数値である必要があります。 | int |
| tcpTimeoutSeconds | アイドル状態の IPVS TCP セッションに使用されるタイムアウト値 (秒単位)。 正の整数値である必要があります。 | int |
| udpTimeoutSeconds | IPVS UDP パケットに使用されるタイムアウト値 (秒単位)。 正の整数値である必要があります。 | int |
ContainerServiceSshConfiguration
| Name | Description | Value |
|---|---|---|
| publicKeys | Linux ベースの VM での認証に使用される SSH 公開キーの一覧。 最大 1 つのキーを指定できます。 | ContainerServiceSshPublicKey[] (必須) |
ContainerServiceSshPublicKey
| Name | Description | Value |
|---|---|---|
| keyData | SSH 経由で VM で認証するために使用される証明書公開キー。 証明書は、ヘッダーの有無にかかわらず PEM 形式である必要があります。 | string (必須) |
CreationData
| Name | Description | Value |
|---|---|---|
| sourceResourceId | これは、ターゲット オブジェクトの作成に使用するソース オブジェクトの ARM ID です。 | 文字列 |
ExtendedLocation
| Name | Description | Value |
|---|---|---|
| name | 拡張された場所の名前。 | 文字列 |
| 型 | 拡張された場所の種類。 | 'EdgeZone' |
GuardrailsProfile
| Name | Description | Value |
|---|---|---|
| excludedNamespaces | ガードレール チェックから除外される名前空間の一覧 | string[] |
| レベル | 使用するガードレール レベル。 既定では、AKS が systemExcludedNamespaces 経由で除外する名前空間を除くすべての名前空間に対して Guardrails が有効になっています | 'Enforcement' 'Off' '警告' (必須) |
| バージョン | 使用する制約のバージョン | string (必須) |
IPTag
| Name | Description | Value |
|---|---|---|
| ipTagType | IP タグの種類。 例: RoutingPreference。 | 文字列 |
| タグ | パブリック IP に関連付けられている IP タグの値。 例: インターネット。 | 文字列 |
IstioComponents
| Name | Description | Value |
|---|---|---|
| ingressGateways | Istio イングレス ゲートウェイ。 | IstioIngressGateway[] |
IstioIngressGateway
| Name | Description | Value |
|---|---|---|
| enabled | イングレス ゲートウェイを有効にするかどうか。 | bool (必須) |
| mode | イングレス ゲートウェイのモード。 | 'External' 'Internal' (必須) |
IstioServiceMesh
| Name | Description | Value |
|---|---|---|
| components | Istio コンポーネントの構成。 | IstioComponents |
KubeletConfig
| Name | Description | Value |
|---|---|---|
| allowedUnsafeSysctls | 安全でない sysctl または安全でない sysctl パターンの許可されたリスト ( *で終わる)。 |
string[] |
| containerLogMaxFiles | コンテナーに存在できるコンテナー ログ ファイルの最大数。 数値は 2 ≥する必要があります。 | int Constraints: 最小値 = 2 |
| containerLogMaxSizeMB | ローテーション前のコンテナー ログ ファイルの最大サイズ (10Mi など)。 | int |
| cpuCfsQuota | 既定値は true です。 | bool |
| cpuCfsQuotaPeriod | 既定値は '100 ミリ秒' です。 有効な値は、省略可能な分数と単位サフィックスを持つ 10 進数のシーケンスです。 例: '300ms'、'2h45m'。 サポートされるユニットは、'ns'、'us'、'ms'、's'、'm'、および 'h' です。 | 文字列 |
| cpuManagerPolicy | 既定値は 'none' です。 詳細については、 Kubernetes CPU 管理ポリシーを 参照してください。 使用できる値は 'none' と 'static' です。 | 文字列 |
| failSwapOn | true に設定すると、ノードでスワップが有効になっている場合、Kubelet の起動に失敗します。 | bool |
| imageGcHighThreshold | イメージ ガベージ コレクションを無効にするには、100 に設定します。 既定値は 85% | int |
| imageGcLowThreshold | imageGcHighThreshold より高く設定することはできません。 既定値は 80% | int |
| podMaxPids | ポッドあたりのプロセスの最大数。 | int |
| topologyManagerPolicy | 詳細については、「 Kubernetes Topology Manager」を参照してください。 既定値は 'none' です。 使用できる値は、'none'、'best-effort'、'restricted'、および 'single-numa-node' です。 | 文字列 |
LinuxOSConfig
| Name | Description | Value |
|---|---|---|
| swapFileSizeMB | 各ノードに作成されるスワップ ファイルのサイズ (MB)。 | int |
| sysctls | Linux エージェント ノードの Sysctl 設定。 | SysctlConfig |
| transparentHugePageDefrag | 有効な値は、'always'、'defer'、'defer+madvise'、'madvise' および 'never' です。 既定値は 'madvise' です。 詳細については、「Transparent Hugepages」を参照してください。 | 文字列 |
| transparentHugePageEnabled | 有効な値は、'always'、'madvise'、および 'never' です。 既定値は "always" です。 詳細については、「Transparent Hugepages」を参照してください。 | 文字列 |
ManagedClusterAADProfile
| Name | Description | Value |
|---|---|---|
| adminGroupObjectIDs | クラスターの管理者ロールを持つ AAD グループ オブジェクト ID の一覧。 | string[] |
| clientAppID | (非推奨)クライアント AAD アプリケーション ID。 詳細については、https://aka.ms/aks/aad-legacyを参照してください。 | 文字列 |
| enableAzureRBAC | Kubernetes 承認に対して Azure RBAC を有効にするかどうかを指定します。 | bool |
| マネージ | マネージド AAD を有効にするかどうか。 | bool |
| serverAppID | (非推奨)サーバー AAD アプリケーション ID。 詳細については、https://aka.ms/aks/aad-legacyを参照してください。 | 文字列 |
| serverAppSecret | (非推奨)サーバー AAD アプリケーション シークレット。 詳細については、https://aka.ms/aks/aad-legacyを参照してください。 | 文字列 |
| tenantID | 認証に使用する AAD テナント ID。 指定しない場合は、デプロイ サブスクリプションのテナントを使用します。 | 文字列 |
ManagedClusterAddonProfile
| Name | Description | Value |
|---|---|---|
| config | アドオンを構成するためのキーと値のペア。 | ManagedClusterAddonProfileConfig |
| enabled | アドオンが有効かどうか。 | bool (必須) |
ManagedClusterAddonProfileConfig
| Name | Description | Value |
|---|
ManagedClusterAgentPoolProfile
| Name | Description | Value |
|---|---|---|
| availabilityZones | ノードに使用する可用性ゾーンの一覧。 これは、AgentPoolType プロパティが 'VirtualMachineScaleSets' の場合にのみ指定できます。 | string[] |
| capacityReservationGroupID | AKS は、指定されたエージェント プールを容量予約グループに関連付けます。 | 文字列 |
| count | Docker コンテナーをホストするエージェント (VM) の数。 使用できる値は、ユーザー プールの場合は 0 から 1000 (含む) の範囲、システム プールの場合は 1 から 1000 (含む) の範囲である必要があります。 既定値は 1 です。 | int |
| creationData | スナップショットを使用してノード プールを作成またはアップグレードする場合に、ソース スナップショット ID を指定するために使用する CreationData。 | CreationData |
| enableAutoScaling | 自動スケーラーを有効にするかどうか | bool |
| enableCustomCATrust | true に設定すると、AKS は機能が有効になっていることを示すラベルをノードに追加し、ホスト サービスと共にデーモンセットをデプロイして、base64 でエンコードされた証明書のユーザー指定リストからノード信頼ストアにカスタム証明機関を同期します。 既定値は false です。 | bool |
| enableEncryptionAtHost | これは、特定の VM サイズと特定の Azure リージョンでのみサポートされます。 詳細については、「/azure/aks/enable-host-encryption」を参照してください。 | bool |
| enableFIPS | 詳細については 、FIPS 対応ノード プールの追加 を参照してください。 | bool |
| enableNodePublicIP | シナリオによっては、ノード プール内のノードが独自の専用パブリック IP アドレスを受け取る必要がある場合があります。 一般的なシナリオは、ホップを最小限に抑えるために、コンソールがクラウド仮想マシンに直接接続する必要があるゲーム ワークロードです。 詳細については、 ノードごとのパブリック IP の割り当てを参照してください。 既定値は false です。 | bool |
| enableUltraSSD | UltraSSD を有効にするかどうか | bool |
| gpuInstanceProfile | サポートされている GPU VM SKU の GPU MIG インスタンス プロファイルを指定するために使用される GPUInstanceProfile。 | 'MIG1g' 'MIG2g' 'MIG3g' 'MIG4g' 'MIG7g' |
| hostGroupID | 形式は /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}です。 詳細については、 Azure 専用ホストに関するページを参照してください。 | 文字列 |
| kubeletConfig | エージェント プール ノード上の Kubelet 構成。 | KubeletConfig |
| kubeletDiskType | emptyDir ボリューム、コンテナー ランタイム データ ルート、および Kubelet エフェメラル ストレージの配置を決定します。 | 'OS' 'Temporary' |
| linuxOSConfig | Linux エージェント ノードの OS 構成。 | LinuxOSConfig |
| maxCount | 自動スケーリングのノードの最大数 | int |
| maxPods | ノードで実行できるポッドの最大数。 | int |
| messageOfTheDay | デコード後に /etc/motd に書き込まれる base64 でエンコードされた文字列。 これにより、Linux ノードに対するその日のメッセージをカスタマイズできます。 Windows ノードには指定しないでください。 静的文字列である必要があります (つまり、生で出力され、スクリプトとして実行されません)。 | 文字列 |
| minCount | 自動スケーリング用のノードの最小数 | int |
| mode | クラスターには、常に少なくとも 1 つの "システム" エージェント プールが必要です。 エージェント プールの制限とベスト プラクティスの詳細については、/azure/aks/use-system-pools を参照してください。 | 'System' 'User' |
| name | Windows エージェント プール名は 6 文字以下にする必要があります。 | string Constraints: パターン = ^[a-z][a-z0-9]{0,11}$ (必須) |
| networkProfile | エージェント プールのネットワーク関連の設定。 | AgentPoolNetworkProfile |
| nodeLabels | エージェント プール内のすべてのノードにわたって保持されるノード ラベル。 | ManagedClusterAgentPoolProfilePropertiesNodeLabels |
| nodePublicIPPrefixID | これは、/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName} の形式です。 | 文字列 |
| nodeTaints | ノード プールの作成とスケーリング中に新しいノードに追加されたテイント。 たとえば、key=value:NoSchedule です。 | string[] |
| orchestratorVersion | パッチ バージョン <major.minor.patch> と <major.minor> の両方がサポートされています。 <major.minor>を指定すると、サポートされている最新のパッチ バージョンが自動的に選択されます。 エージェント プールを同じ <major.minor> を作成した後に更新しても、新しいパッチ バージョンが使用可能な場合でもアップグレードはトリガーされません。 ベスト プラクティスとして、AKS クラスター内のすべてのノード プールを同じ Kubernetes バージョンにアップグレードする必要があります。 ノード プールのバージョンには、コントロール プレーンと同じメジャー バージョンが必要です。 ノード プールのマイナー バージョンは、コントロール プレーン バージョンの 2 つのマイナー バージョン内にある必要があります。 ノード プールのバージョンをコントロール プレーンのバージョンより大きくすることはできません。 詳細については、 ノード・プールのアップグレードを参照してください。 | 文字列 |
| osDiskSizeGB | マスター/エージェント プール内のすべてのマシンのディスク サイズを指定するために使用する OS ディスク サイズ (GB)。 0 を指定すると、指定された vmSize に従って既定の osDisk サイズが適用されます。 | int Constraints: 最小値 = 0 最大値 = 2048 |
| osDiskType | VM でサポートされていて、要求された OSDiskSizeGB より大きいキャッシュ ディスクがある場合、既定値は "エフェメラル" です。 それ以外の場合、既定値は 'Managed' です。 作成後に変更できない場合があります。 詳細については、「エフェメラル OS を参照してください。 | 'Ephemeral' 'Managed' |
| osSKU | エージェント プールで使用される OS SKU を指定します。 指定しない場合、既定値は OSType=Linux の場合は Ubuntu、OSType=Windows の場合は Windows2019 です。 また、Windows 2019 が非推奨になった後、既定の Windows OSSKU が Windows2022 に変更されます。 | 'CBLMariner' 'Mariner' 'Ubuntu' 'Windows2019' 'Windows2022' |
| osType | オペレーティング システムの種類。 既定値は Linux です。 | 'Linux' 'Windows' |
| podSubnetID | 省略すると、ポッド IP はノード サブネットに静的に割り当てられます (詳細については、vnetSubnetID を参照してください)。 これは、/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} の形式です。 | 文字列 |
| powerState | エージェント プールが最初に作成されるときは、最初に実行中です。 エージェント プールは、このフィールドを [停止済み] に設定することで停止できます。 停止したエージェント プールは、すべての VM を停止し、課金料金は発生しません。 エージェント プールは、実行中でプロビジョニング状態が成功した場合にのみ停止できます | PowerState |
| proximityPlacementGroupID | 近接通信配置グループの ID。 | 文字列 |
| scaleDownMode | これは、クラスターオートスケーラーの動作にも影響します。 指定しない場合は、既定で Delete に設定されます。 | 'Deallocate' 'Delete' |
| scaleSetEvictionPolicy | scaleSetPriority が 'Spot' でない限り、これは指定できません。 指定しない場合、既定値は 'Delete' です。 | 'Deallocate' 'Delete' |
| scaleSetPriority | 仮想マシン スケール セットの優先順位。 指定しない場合、既定値は 'Regular' です。 | 'Regular' 'Spot' |
| spotMaxPrice | 指定できる値は、0 より大きい任意の 10 進値またはオンデマンド価格を支払う意欲を示す -1 です。 スポット価格の詳細については、スポット VM の価格に関するページを参照してください。 | int |
| tags | エージェント プールの仮想マシン スケール セットに保持されるタグ。 | ManagedClusterAgentPoolProfilePropertiesTags |
| 型 | エージェント プールの種類。 | 'AvailabilitySet' 'VirtualMachineScaleSets' |
| upgradeSettings | エージェント プールをアップグレードするための設定 | AgentPoolUpgradeSettings |
| vmSize | VM サイズの可用性はリージョンによって異なります。 ノードに十分なコンピューティング リソース (メモリ、cpu など) が含まれている場合、ポッドが正常に実行されない可能性があります。 制限付き VM サイズの詳細については、/azure/aks/quotas-skus-regions を参照してください。 | 文字列 |
| vnetSubnetID | これが指定されていない場合は、VNET とサブネットが生成されて使用されます。 podSubnetID が指定されていない場合、これはノードとポッドに適用され、それ以外の場合はノードのみに適用されます。 これは、/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} の形式です。 | 文字列 |
| windowsProfile | Windows エージェント プールの特定のプロファイル。 | AgentPoolWindowsProfile |
| workloadRuntime | ノードが実行できるワークロードの種類を決定します。 | 'KataMshvVmIsolation' 'OCIContainer' 'WasmWasi' |
ManagedClusterAgentPoolProfilePropertiesNodeLabels
| Name | Description | Value |
|---|
ManagedClusterAgentPoolProfilePropertiesTags
| Name | Description | Value |
|---|
ManagedClusterAPIServerAccessProfile
| Name | Description | Value |
|---|---|---|
| authorizedIPRanges | IP 範囲は CIDR 形式で指定されます (例: 137.117.106.88/29)。 この機能は、ノードあたりのパブリック IP を使用するクラスター、または Basic Load Balancer を使用しているクラスターとは互換性がありません。 詳細については、 API サーバーの承認済み IP 範囲を参照してください。 | string[] |
| disableRunCommand | クラスターの実行コマンドを無効にするかどうかを指定します。 | bool |
| enablePrivateCluster | 詳細については、「 プライベート AKS クラスターの作成」を参照してください。 | bool |
| enablePrivateClusterPublicFQDN | プライベート クラスター用に追加のパブリック FQDN を作成するかどうか。 | bool |
| enableVnetIntegration | クラスターの apiserver vnet 統合を有効にするかどうか。 | bool |
| privateDNSZone | 既定値は System です。 詳細については、 プライベート DNS ゾーンの構成に関するページを参照してください。 使用できる値は 'system' と 'none' です。 | 文字列 |
| subnetId | 1 の場合に必要です。 BYO Vnet を使用して新しいクラスターを作成する。2. 既存のクラスターを更新して apiserver vnet 統合を有効にする。 | 文字列 |
ManagedClusterAutoUpgradeProfile
| Name | Description | Value |
|---|---|---|
| nodeOSUpgradeChannel | 既定値はアンマネージドですが、GA で NodeImage または SecurityPatch に変更される可能性があります。 | 'NodeImage' 'None' 'SecurityPatch' 'Unmanaged' |
| upgradeChannel | 詳細については、 AKS クラスターの自動アップグレード チャネルの設定を参照してください。 | 'node-image' 'none' 'patch' 'rapid' 'stable' |
ManagedClusterAzureMonitorProfile
| Name | Description | Value |
|---|---|---|
| メトリクス | prometheus サービス アドオンのメトリック プロファイル | ManagedClusterAzureMonitorProfileMetrics |
ManagedClusterAzureMonitorProfileKubeStateMetrics
| Name | Description | Value |
|---|---|---|
| metricAnnotationsAllowList | リソースのラベル メトリックで使用される追加の Kubernetes ラベル キーのコンマ区切りの一覧。 | 文字列 |
| metricLabelsAllowlist | リソースのラベル メトリックで使用される Kubernetes 注釈キーのコンマ区切りの一覧。 | 文字列 |
ManagedClusterAzureMonitorProfileMetrics
| Name | Description | Value |
|---|---|---|
| enabled | Prometheus コレクターを有効にするかどうか | bool (必須) |
| kubeStateMetrics | コンテナー サービス クラスターの prometheus アドオン プロファイルの Kube 状態メトリック | ManagedClusterAzureMonitorProfileKubeStateMetrics |
ManagedClusterHttpProxyConfig
| Name | Description | Value |
|---|---|---|
| httpProxy | 使用する HTTP プロキシ サーバー エンドポイント。 | 文字列 |
| httpsProxy | 使用する HTTPS プロキシ サーバー エンドポイント。 | 文字列 |
| noProxy | プロキシを経由しないエンドポイント。 | string[] |
| trustedCa | プロキシ サーバーへの接続に使用する代替 CA 証明書。 | 文字列 |
ManagedClusterIdentity
| Name | Description | Value |
|---|---|---|
| 型 | 詳細については、 AKS でのマネージド ID の使用に関する説明を参照してください。 | 'None' 'SystemAssigned' 'UserAssigned' |
| userAssignedIdentities | キーは、"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}" という形式の ARM リソース ID である必要があります。 | ManagedClusterIdentityUserAssignedIdentities |
ManagedClusterIdentityUserAssignedIdentities
| Name | Description | Value |
|---|
ManagedClusterIngressProfile
| Name | Description | Value |
|---|---|---|
| webAppRouting | イングレス プロファイルの Web アプリ ルーティング設定。 | ManagedClusterIngressProfileWebAppRouting |
ManagedClusterIngressProfileWebAppRouting
| Name | Description | Value |
|---|---|---|
| dnsZoneResourceId | Web アプリに関連付ける DNS ゾーンのリソース ID。 Web アプリ ルーティングが有効になっている場合にのみ使用されます。 | 文字列 |
| enabled | Web アプリのルーティングを有効にするかどうかを指定します。 | bool |
ManagedClusterLoadBalancerProfile
| Name | Description | Value |
|---|---|---|
| allocatedOutboundPorts | VM ごとに割り当てられた SNAT ポートの必要な数。 使用できる値は、0 ~ 64000 (含む) の範囲です。 既定値は 0 で、Azure でポートが動的に割り当てられます。 | int Constraints: 最小値 = 0 最大値 = 64000 |
| backendPoolType | マネージド受信ロード バランサー BackendPool の種類。 | 'NodeIP' 'NodeIPConfiguration' |
| effectiveOutboundIPs | クラスター ロード バランサーの有効な送信 IP リソース。 | ResourceReference[] |
| enableMultipleStandardLoadBalancers | AKS クラスターごとに複数の Standard ロード バランサーを有効にするかどうか。 | bool |
| idleTimeoutInMinutes | 必要な送信フローのアイドル タイムアウト (分単位)。 使用できる値の範囲は、4 ~ 120 (両端を含む) です。 既定値は 30 分です。 | int Constraints: 最小値 = 4 最大値 = 120 |
| managedOutboundIPs | クラスター ロード バランサーに必要なマネージド送信 IP。 | ManagedClusterLoadBalancerProfileManagedOutboundIPs |
| outboundIPPrefixes | クラスター ロード バランサーに必要な送信 IP プレフィックス リソース。 | ManagedClusterLoadBalancerProfileOutboundIPPrefixes |
| outboundIPs | クラスター ロード バランサーに必要な送信 IP リソース。 | ManagedClusterLoadBalancerProfileOutboundIPs |
ManagedClusterLoadBalancerProfileManagedOutboundIPs
| Name | Description | Value |
|---|---|---|
| count | クラスター ロード バランサー用に Azure によって作成/管理される IPv4 送信 IP の目的の数。 使用できる値は、1 ~ 100 (両端を含む) の範囲である必要があります。 既定値は 1 です。 | int Constraints: 最小値 = 1 最大値 = 100 |
| countIPv6 | クラスター ロード バランサー用に Azure によって作成/管理される IPv6 送信 IP の目的の数。 使用できる値は、1 ~ 100 (両端を含む) の範囲である必要があります。 既定値は、単一スタックの場合は 0、デュアル スタックの場合は 1 です。 | int Constraints: 最小値 = 0 最大値 = 100 |
ManagedClusterLoadBalancerProfileOutboundIPPrefixes
| Name | Description | Value |
|---|---|---|
| publicIPPrefixes | パブリック IP プレフィックス リソースの一覧。 | ResourceReference[] |
ManagedClusterLoadBalancerProfileOutboundIPs
| Name | Description | Value |
|---|---|---|
| publicIPs | パブリック IP リソースの一覧。 | ResourceReference[] |
ManagedClusterManagedOutboundIPProfile
| Name | Description | Value |
|---|---|---|
| count | Azure によって作成/管理される送信 IP の目的の数。 使用できる値は、1 ~ 16 (両端を含む) の範囲である必要があります。 既定値は 1 です。 | int Constraints: 最小値 = 1 最大値 = 16 |
ManagedClusterNATGatewayProfile
| Name | Description | Value |
|---|---|---|
| effectiveOutboundIPs | クラスター NAT ゲートウェイの有効な送信 IP リソース。 | ResourceReference[] |
| idleTimeoutInMinutes | 必要な送信フローのアイドル タイムアウト (分単位)。 使用できる値の範囲は、4 ~ 120 (両端を含む) です。 既定値は 4 分です。 | int Constraints: 最小値 = 4 最大値 = 120 |
| managedOutboundIPProfile | クラスター NAT ゲートウェイのマネージド送信 IP リソースのプロファイル。 | ManagedClusterManagedOutboundIPProfile |
ManagedClusterNodeResourceGroupProfile
| Name | Description | Value |
|---|---|---|
| restrictionLevel | クラスターのノード リソース グループに適用される制限レベル | 'ReadOnly' 'Unrestricted' |
ManagedClusterOidcIssuerProfile
| Name | Description | Value |
|---|---|---|
| enabled | OIDC 発行者が有効かどうか。 | bool |
ManagedClusterPodIdentity
| Name | Description | Value |
|---|---|---|
| bindingSelector | AzureIdentityBinding リソースに使用するバインド セレクター。 | 文字列 |
| ID | ユーザー割り当て ID の詳細。 | UserAssignedIdentity (必須) |
| name | ポッド ID の名前。 | string (必須) |
| 名前空間 | ポッド ID の名前空間。 | string (必須) |
ManagedClusterPodIdentityException
| Name | Description | Value |
|---|---|---|
| name | ポッド ID 例外の名前。 | string (必須) |
| 名前空間 | ポッド ID 例外の名前空間。 | string (必須) |
| podLabels | 一致するポッド ラベル。 | ManagedClusterPodIdentityExceptionPodLabels (必須) |
ManagedClusterPodIdentityExceptionPodLabels
| Name | Description | Value |
|---|
ManagedClusterPodIdentityProfile
| Name | Description | Value |
|---|---|---|
| allowNetworkPluginKubenet | AAD ポッド ID のセキュリティ関連の性質と IP スプーフィングのリスクにより、Kubenet での実行は既定で無効になっています。 詳細については、 AAD ポッド ID での Kubenet ネットワーク プラグインの使用 を参照してください。 | bool |
| enabled | ポッド ID アドオンが有効かどうか。 | bool |
| userAssignedIdentities | クラスターで使用するポッド ID。 | ManagedClusterPodIdentity[] |
| userAssignedIdentityExceptions | 許可するポッド ID の例外。 | ManagedClusterPodIdentityException[] |
ManagedClusterProperties
| Name | Description | Value |
|---|---|---|
| aadProfile | Azure Active Directory の構成。 | ManagedClusterAADProfile |
| addonProfiles | マネージド クラスター アドオンのプロファイル。 | ManagedClusterPropertiesAddonProfiles |
| agentPoolProfiles | エージェント プールのプロパティ。 | ManagedClusterAgentPoolProfile[] |
| apiServerAccessProfile | マネージド クラスター API サーバーのアクセス プロファイル。 | ManagedClusterAPIServerAccessProfile |
| autoScalerProfile | 有効な場合にクラスター オートスケーラーに適用されるパラメーター | ManagedClusterPropertiesAutoScalerProfile |
| autoUpgradeProfile | 自動アップグレードの構成。 | ManagedClusterAutoUpgradeProfile |
| azureMonitorProfile | コンテナー サービス クラスターの Prometheus アドオン プロファイル | ManagedClusterAzureMonitorProfile |
| creationData | クラスターがスナップショットを使用して作成またはアップグレードされる場合に、ソース スナップショット ID を指定するために使用される CreationData。 | CreationData |
| disableLocalAccounts | true に設定すると、このクラスターで静的資格情報の取得が無効になります。 これは、AAD が有効になっているマネージド クラスターでのみ使用する必要があります。 詳細については、 ローカル アカウントの無効化に関するページを参照してください。 | bool |
| diskEncryptionSetID | "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/diskEncryptionSets/{encryptionSetName}" の形式です。 | 文字列 |
| dnsPrefix | これは、マネージド クラスターが作成された後は更新できません。 | 文字列 |
| enableNamespaceResources | 既定値は false です。 マネージド クラスターの作成と更新時に有効または無効にすることができます。 ARM リソースとしての名前空間の詳細については、 https://aka.ms/NamespaceARMResource を参照してください。 | bool |
| enablePodSecurityPolicy | (非推奨)Kubernetes ポッドのセキュリティ ポリシー (プレビュー) を有効にするかどうかを指定します。 PodSecurityPolicy は Kubernetes v1.21 で非推奨となり、v1.25 の Kubernetes から削除されました。 詳細については、 https://aka.ms/k8s/psp と https://aka.ms/aks/pspを参照してください。 | bool |
| enableRBAC | Kubernetes Role-Based アクセス制御を有効にするかどうかを指定します。 | bool |
| fqdnSubdomain | これは、マネージド クラスターが作成された後は更新できません。 | 文字列 |
| guardrailsProfile | ガードレール プロファイルは、特定のクラスターのすべてのガードレール情報を保持します。 | GuardrailsProfile |
| httpProxyConfig | HTTP プロキシ サーバーを使用してクラスターをプロビジョニングするための構成。 | ManagedClusterHttpProxyConfig |
| identityProfile | クラスターに関連付けられている ID。 | ManagedClusterPropertiesIdentityProfile |
| ingressProfile | マネージド クラスターのイングレス プロファイル。 | ManagedClusterIngressProfile |
| kubernetesVersion | サポートされている 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 | エージェント プール ノードを含むリソース グループの名前。 | 文字列 |
| nodeResourceGroupProfile | ノード リソース グループ構成プロファイル。 | ManagedClusterNodeResourceGroupProfile |
| oidcIssuerProfile | マネージド クラスターの OIDC 発行者プロファイル。 | ManagedClusterOidcIssuerProfile |
| podIdentityProfile | AAD ポッド ID の統合の詳細については、AAD ポッド ID の使用に関するページを参照してください。 | ManagedClusterPodIdentityProfile |
| privateLinkResources | クラスターに関連付けられているプライベート リンク リソース。 | PrivateLinkResource[] |
| publicNetworkAccess | AKS のパブリック ネットワーク アクセスを許可または拒否する | 'Disabled' 'Enabled' 'SecuredByPerimeter' |
| securityProfile | マネージド クラスターのセキュリティ プロファイル。 | ManagedClusterSecurityProfile |
| serviceMeshProfile | マネージド クラスターのサービス メッシュ プロファイル。 | ServiceMeshProfile |
| servicePrincipalProfile | Azure API の操作に使用するクラスターのサービス プリンシパル ID に関する情報。 | ManagedClusterServicePrincipalProfile |
| storageProfile | マネージド クラスターのストレージ プロファイル。 | ManagedClusterStorageProfile |
| upgradeSettings | クラスターをアップグレードするための設定。 | ClusterUpgradeSettings |
| windowsProfile | マネージド クラスター内の Windows VM のプロファイル。 | ManagedClusterWindowsProfile |
| workloadAutoScalerProfile | マネージド クラスターのワークロード 自動スケーラー プロファイル。 | ManagedClusterWorkloadAutoScalerProfile |
ManagedClusterPropertiesAddonProfiles
| Name | Description | Value |
|---|
ManagedClusterPropertiesAutoScalerProfile
| Name | Description | Value |
|---|---|---|
| balance-similar-node-groups | 有効な値は 'true' と 'false' です | 文字列 |
| expander | 指定しない場合、既定値は 'random' です。 詳細については、「 expanders を参照してください。 | 'least-waste' 'most-pods' '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 スケジューラがすべてのポッドをスケジュールする前に CA を動作させたくないバースト/バッチ スケールなどのシナリオでは、特定の期間になる前にスケジュールされていないポッドを無視するように CA に指示できます。 既定値は '0s' です。 値は整数の後に単位 (秒の場合は 's'、分の場合は '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 です。 | 文字列 |
| skip-nodes-with-system-pods | 既定値は true です。 | 文字列 |
ManagedClusterPropertiesIdentityProfile
| Name | Description | Value |
|---|
ManagedClusterSecurityProfile
| Name | Description | Value |
|---|---|---|
| azureKeyVaultKms | セキュリティ プロファイルの Azure Key Vault キー管理サービス の設定。 | AzureKeyVaultKms |
| customCATrustCertificates | カスタム CA 信頼機能が有効になっているノードの信頼ストアに追加される、最大 10 個の base64 でエンコードされた CA の一覧。 詳細については、「カスタム CA 信頼証明書」を参照してください。 | any[] |
| defender | セキュリティ プロファイルの Microsoft Defender 設定。 | ManagedClusterSecurityProfileDefender |
| imageCleaner | セキュリティ プロファイルのイメージ クリーナー設定。 | ManagedClusterSecurityProfileImageCleaner |
| nodeRestriction | セキュリティプロファイルのノード制限設定。 | ManagedClusterSecurityProfileNodeRestriction |
| workloadIdentity | セキュリティ プロファイルのワークロード ID 設定。 ワークロード ID を使用すると、Kubernetes アプリケーションは Azure AD を使用して Azure クラウド リソースに安全にアクセスできます。 詳細については、https://aka.ms/aks/wiを参照してください。 | ManagedClusterSecurityProfileWorkloadIdentity |
ManagedClusterSecurityProfileDefender
| Name | Description | Value |
|---|---|---|
| logAnalyticsWorkspaceResourceId | Microsoft Defender に関連付ける Log Analytics ワークスペースのリソース ID。 Microsoft Defender が有効になっている場合、このフィールドは必須であり、有効なワークスペース リソース ID である必要があります。 Microsoft Defender が無効になっている場合は、フィールドを空のままにします。 | 文字列 |
| securityMonitoring | セキュリティ プロファイルのクラウド設定に対する Microsoft Defender 脅威検出。 | ManagedClusterSecurityProfileDefenderSecurityMonitoring |
ManagedClusterSecurityProfileDefenderSecurityMonitoring
| Name | Description | Value |
|---|---|---|
| enabled | Defender 脅威検出を有効にするかどうか | bool |
ManagedClusterSecurityProfileImageCleaner
| Name | Description | Value |
|---|---|---|
| enabled | AKS クラスターでイメージ クリーナーを有効にするかどうか。 | bool |
| intervalHours | イメージ クリーナーのスキャン間隔 (時間単位)。 | int |
ManagedClusterSecurityProfileNodeRestriction
| Name | Description | Value |
|---|---|---|
| enabled | ノード制限を有効にするかどうか | bool |
ManagedClusterSecurityProfileWorkloadIdentity
| Name | Description | Value |
|---|---|---|
| enabled | ワークロード ID を有効にするかどうか。 | bool |
ManagedClusterServicePrincipalProfile
| Name | Description | Value |
|---|---|---|
| clientId | サービス プリンシパルの ID。 | string (必須) |
| シークレット | プレーン テキストでサービス プリンシパルに関連付けられているシークレット パスワード。 | string Constraints: 機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。 |
ManagedClusterSKU
| Name | Description | Value |
|---|---|---|
| name | マネージド クラスター SKU の名前。 | 'Base' |
| レベル | 指定しない場合、既定値は "Free" です。 詳細については、 AKS 価格レベル を参照してください。 | 'Free' 'Standard' |
ManagedClusterStorageProfile
| Name | Description | Value |
|---|---|---|
| blobCSIDriver | ストレージ プロファイルの AzureBlob CSI ドライバー設定。 | ManagedClusterStorageProfileBlobCSIDriver |
| diskCSIDriver | ストレージ プロファイルの AzureDisk CSI ドライバー設定。 | ManagedClusterStorageProfileDiskCSIDriver |
| fileCSIDriver | ストレージ プロファイルの AzureFile CSI ドライバー設定。 | ManagedClusterStorageProfileFileCSIDriver |
| snapshotController | ストレージ プロファイルのスナップショット コントローラーの設定。 | ManagedClusterStorageProfileSnapshotController |
ManagedClusterStorageProfileBlobCSIDriver
| Name | Description | Value |
|---|---|---|
| enabled | AzureBlob CSI ドライバーを有効にするかどうか。 既定値は false です。 | bool |
ManagedClusterStorageProfileDiskCSIDriver
| Name | Description | Value |
|---|---|---|
| enabled | AzureDisk CSI ドライバーを有効にするかどうか。 これは既定値は true です。 | bool |
| バージョン | AzureDisk CSI ドライバーのバージョン。 既定値は v1 です。 | 文字列 |
ManagedClusterStorageProfileFileCSIDriver
| Name | Description | Value |
|---|---|---|
| enabled | AzureFile CSI ドライバーを有効にするかどうか。 これは既定値は true です。 | bool |
ManagedClusterStorageProfileSnapshotController
| Name | Description | Value |
|---|---|---|
| enabled | スナップショット コントローラーを有効にするかどうかを指定します。 これは既定値は true です。 | bool |
ManagedClusterWindowsProfile
| Name | Description | Value |
|---|---|---|
| adminPassword | 管理者アカウントのパスワードを指定します。 最小長: 8 文字 最大長: 123 文字 複雑さの要件: 以下の 4 つの条件のうち 3 つ を満たす必要があります 文字が小さい 上の文字を含む 数字を含む 特殊文字を持つ (Regex match [\W_]) 許可されていない値: "abc@123"、"P@$$w 0rd"、"P@ssw0rd"、"P@ssword123"、"Pa$$word"、"pass@word1"、"Password!"、"Password1"、"Password22"、"iloveyou!" |
文字列 |
| 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' |
ManagedClusterWorkloadAutoScalerProfile
| Name | Description | Value |
|---|---|---|
| keda | ワークロード 自動スケーラー プロファイルの KEDA (Kubernetes イベント ドリブン自動スケーリング) 設定。 | ManagedClusterWorkloadAutoScalerProfileKeda |
| verticalPodAutoscaler | ManagedClusterWorkloadAutoScalerProfileVerticalPodAutoscaler |
ManagedClusterWorkloadAutoScalerProfileKeda
| Name | Description | Value |
|---|---|---|
| enabled | KEDA を有効にするかどうか。 | bool (必須) |
ManagedClusterWorkloadAutoScalerProfileVerticalPodAutoscaler
| Name | Description | Value |
|---|---|---|
| controlledValues | どのリソース値オートスケーラーが変更されるかを制御します。 既定値は RequestsAndLimits です。 | 'RequestsAndLimits' 'RequestsOnly' (必須) |
| enabled | VPA を有効にするかどうか。 既定値は false です。 | bool (必須) |
| updateMode | 各更新モード レベルは、下位レベルのスーパーセットです。 Off<Initial<Recreate<=Auto。たとえば、UpdateMode が Initial の場合、VPA は VerticalPodAutoscaler カスタム リソースの推奨リソースを (UpdateMode Off から) 設定し、ポッドの作成時に (Initial から) リソースも割り当てることを意味します。 既定値は [オフ] です。 | 'Auto' 'Initial' 'Off' 「再作成」(必須) |
ManagedServiceIdentityUserAssignedIdentitiesValue
| Name | Description | Value |
|---|
PortRange
| Name | Description | Value |
|---|---|---|
| portEnd | 範囲に含まれる最大ポート。 範囲は 1 から 65535 で、portStart 以上である必要があります。 | int Constraints: 最小値 = 1 最大値 = 65535 |
| portStart | 範囲に含まれる最小ポート。 範囲は 1 から 65535 で、portEnd 以下である必要があります。 | int Constraints: 最小値 = 1 最大値 = 65535 |
| プロトコル | ポートのネットワーク プロトコル。 | 'TCP' 'UDP' |
PowerState
| Name | Description | Value |
|---|---|---|
| コード | クラスターが実行中か停止かを示します | 'Running' 'Stopped' |
PrivateLinkResource
| Name | Description | Value |
|---|---|---|
| groupId | リソースのグループ ID。 | 文字列 |
| id | プライベート リンク リソースの ID。 | 文字列 |
| name | プライベート リンク リソースの名前。 | 文字列 |
| requiredMembers | リソースの RequiredMembers | string[] |
| 型 | リソースの種類。 | 文字列 |
ResourceReference
| Name | Description | Value |
|---|---|---|
| id | 完全修飾 Azure リソース ID。 | 文字列 |
ServiceMeshProfile
| Name | Description | Value |
|---|---|---|
| istio | Istio サービス メッシュの構成。 | IstioServiceMesh |
| mode | サービス メッシュのモード。 | 'Disabled' 'Istio' (必須) |
SysctlConfig
| Name | Description | Value |
|---|---|---|
| fsAioMaxNr | sysctl setting fs.aio-max-nr. | int |
| fsFileMax | sysctl 設定 fs.file-max. | int |
| fsInotifyMaxUserWatches | sysctl setting fs.inotify.max_user_watches. | int |
| fsNrOpen | Sysctl 設定fs.nr_open。 | int |
| kernelThreadsMax | sysctl setting 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 setting 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 setting vm.max_map_count. | int |
| vmSwappiness | sysctl setting vm.swappiness. | int |
| vmVfsCachePressure | Sysctl 設定vm.vfs_cache_pressure。 | int |
TrackedResourceTags
| Name | Description | Value |
|---|
UpgradeOverrideSettings
| Name | Description | Value |
|---|---|---|
| controlPlaneOverrides | クラスターのコントロール プレーンをアップグレードするときのアップグレードオーバーライドの一覧。 | 次のいずれかを含む文字列配列: 'IgnoreKubernetesDeprecations' |
| until | オーバーライドが有効になるまで。 これはアップグレードの開始時刻にのみ一致し、アップグレードの進行に応じて until の有効期限が切れた場合でも、アップグレードの開始時に有効性は変わらないことに注意してください。 このフィールドは既定では設定されていません。 オーバーライドを有効にするには、この値を設定する必要があります。 |
文字列 |
UserAssignedIdentity
| Name | Description | Value |
|---|---|---|
| clientId | ユーザー割り当て ID のクライアント ID。 | 文字列 |
| objectId | ユーザー割り当て ID のオブジェクト ID。 | 文字列 |
| resourceId | ユーザー割り当て ID のリソース ID。 | 文字列 |
WindowsGmsaProfile
| Name | Description | Value |
|---|---|---|
| dnsServer | Windows gMSA の DNS サーバーを指定します。 マネージド クラスターの作成に使用する vnet 内の DNS サーバーを構成している場合は、これを空に設定します。 |
文字列 |
| enabled | マネージド クラスターで Windows gMSA を有効にするかどうかを指定します。 | bool |
| rootDomainName | Windows gMSA のルート ドメイン名を指定します。 マネージド クラスターの作成に使用する vnet 内の DNS サーバーを構成している場合は、これを空に設定します。 |
文字列 |
使用例
Terraformサンプル
マネージド Kubernetes クラスター (AKS/Azure Kubernetes Service とも呼ばれます) をデプロイする基本的な例。
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 = "westeurope"
}
resource "azapi_resource" "resourceGroup" {
type = "Microsoft.Resources/resourceGroups@2020-06-01"
name = var.resource_name
location = var.location
schema_validation_enabled = false
response_export_values = ["*"]
}
resource "azapi_resource" "managedCluster" {
type = "Microsoft.ContainerService/managedClusters@2023-04-02-preview"
parent_id = azapi_resource.resourceGroup.id
name = var.resource_name
location = var.location
identity {
type = "SystemAssigned"
identity_ids = []
}
body = {
properties = {
agentPoolProfiles = [
{
count = 1
mode = "System"
name = "default"
vmSize = "Standard_DS2_v2"
},
]
dnsPrefix = var.resource_name
}
}
schema_validation_enabled = false
response_export_values = ["*"]
}
Azure 検証済みモジュール
次の Azure 検証済みモジュール を使用して、このリソースの種類をデプロイできます。
| Module | Description |
|---|---|
| AKS マネージド クラスター | AKS マネージド クラスター用の AVM リソース モジュール |