Bagikan melalui


Agent Pools - Upgrade Node Image Version

Meningkatkan versi gambar simpul dari kumpulan agen ke yang terbaru.
Meningkatkan versi gambar simpul dari kumpulan agen menerapkan pembaruan OS dan runtime terbaru ke simpul. AKS menyediakan satu gambar baru per minggu dengan pembaruan terbaru. Untuk detail selengkapnya tentang versi gambar simpul, lihat: https://docs.microsoft.com/azure/aks/node-image-upgrade

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/agentPools/{agentPoolName}/upgradeNodeImageVersion?api-version=2025-03-01

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
agentPoolName
path True

string

minLength: 1
maxLength: 12
pattern: ^[a-z][a-z0-9]{0,11}$

Nama kumpulan agen.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nama grup sumber daya. Nama tidak sensitif terhadap penggunaan huruf besar atau kecil.

resourceName
path True

string

minLength: 1
maxLength: 63
pattern: ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-_a-zA-Z0-9]{0,61}[a-zA-Z0-9]$

Nama sumber daya kluster terkelola.

subscriptionId
path True

string (uuid)

ID langganan target. Nilainya harus sebuah UUID.

api-version
query True

string

minLength: 1

Versi API yang digunakan untuk operasi ini.

Respons

Nama Jenis Deskripsi
200 OK

OKE

202 Accepted

AgentPool

Diterima

Header

Azure-AsyncOperation: string

Other Status Codes

CloudError

Respons kesalahan yang menjelaskan mengapa operasi gagal.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama Deskripsi
user_impersonation meniru akun pengguna Anda

Contoh

Upgrade Agent Pool Node Image Version

Permintaan sampel

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1/upgradeNodeImageVersion?api-version=2025-03-01

Respon sampel

Azure-AsyncOperation: https://management.azure.com/providers/Microsoft.ContainerService/locations/westus/operations/00000000-0000-0000-0000-000000000000?api-version=2018-07-31
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
  "name": "agentpool1",
  "properties": {
    "provisioningState": "UpgradingNodeImageVersion",
    "count": 3,
    "vmSize": "Standard_DS1_v2",
    "maxPods": 110,
    "osType": "Linux",
    "orchestratorVersion": "1.9.6",
    "currentOrchestratorVersion": "1.9.6",
    "nodeImageVersion": "AKSUbuntu-1604-2020.03.11",
    "upgradeSettings": {
      "maxSurge": "33%"
    }
  }
}

Definisi

Nama Deskripsi
AgentPool

Kumpulan Agen.

AgentPoolMode

Mode kumpulan agen.

AgentPoolNetworkProfile

Pengaturan jaringan kumpulan agen.

AgentPoolSecurityProfile

Pengaturan keamanan kumpulan agen.

AgentPoolType

Jenis Kumpulan Agen.

AgentPoolUpgradeSettings

Pengaturan untuk memutakhirkan agentpool

AgentPoolWindowsProfile

Profil spesifik kumpulan agen Windows.

CloudError

Respons kesalahan dari layanan Kontainer.

CloudErrorBody

Respons kesalahan dari layanan Kontainer.

code

Memberi tahu apakah kluster Sedang Berjalan atau Dihentikan

CreationData

Data yang digunakan saat membuat sumber daya target dari sumber daya sumber.

GPUDriver

Apakah akan menginstal driver GPU. Jika tidak ditentukan, defaultnya adalah Instal.

GPUInstanceProfile

GPUInstanceProfile yang akan digunakan untuk menentukan profil instans GPU MIG untuk SKU VM GPU yang didukung.

GPUProfile

Pengaturan GPU untuk Kumpulan Agen.

IPTag

Berisi IPTag yang terkait dengan objek .

KubeletConfig

Konfigurasi kubelet simpul agen.

KubeletDiskType

Menentukan penempatan volume emptyDir, akar data runtime kontainer, dan penyimpanan sementara Kubelet.

LinuxOSConfig

Konfigurasi OS simpul agen Linux.

OSDiskType

Jenis disk OS yang akan digunakan untuk komputer di kumpulan agen.

OSSKU

Menentukan SKU OS yang digunakan oleh kumpulan agen. Defaultnya adalah Ubuntu jika OSType adalah Linux. Defaultnya adalah Windows2019 ketika Kubernetes <= 1.24 atau Windows2022 ketika Kubernetes >= 1.25 jika OSType adalah Windows.

OSType

Jenis sistem operasi. Defaultnya adalah Linux.

PortRange

Rentang port.

PowerState

Menjelaskan Status Daya kluster

Protocol

Protokol jaringan port.

ScaleDownMode

Menjelaskan bagaimana VM ditambahkan atau dihapus dari Kumpulan Agen. Lihat status penagihan.

ScaleSetEvictionPolicy

Kebijakan pengeluaran Set Skala Komputer Virtual.

ScaleSetPriority

Prioritas Set Skala Komputer Virtual.

SysctlConfig

Pengaturan Sysctl untuk simpul agen Linux.

UndrainableNodeBehavior

Menentukan perilaku untuk simpul yang tidak dapat dibatalkan selama peningkatan. Penyebab paling umum dari simpul yang tidak dapat dibatalkan adalah Anggaran Gangguan Pod (PDB), tetapi masalah lain, seperti masa tenggang penghentian pod melebihi batas waktu pengurasan per node yang tersisa atau pod masih dalam keadaan berjalan, juga dapat menyebabkan simpul yang tidak dapat dibatalkan.

WorkloadRuntime

Menentukan jenis beban kerja yang dapat dijalankan simpul.

AgentPool

Kumpulan Agen.

Nama Jenis Nilai default Deskripsi
id

string

ID Sumber Daya.

name

string

Nama sumber daya yang unik dalam grup sumber daya. Nama ini dapat digunakan untuk mengakses sumber daya.

properties.availabilityZones

string[]

Daftar Zona ketersediaan yang akan digunakan untuk simpul. Ini hanya dapat ditentukan jika properti AgentPoolType adalah 'VirtualMachineScaleSets'.

properties.capacityReservationGroupID

string (arm-id)

ID sumber daya yang sepenuhnya memenuhi syarat dari Grup Reservasi Kapasitas untuk menyediakan komputer virtual dari grup Komputer Virtual yang dipesan.
AKS akan mengaitkan kumpulan agen yang ditentukan dengan Grup Reservasi Kapasitas.

properties.count

integer (int32)

Jumlah agen (VM) untuk menghosting kontainer docker. Nilai yang diizinkan harus dalam rentang 0 hingga 1000 (inklusif) untuk kumpulan pengguna dan dalam rentang 1 hingga 1000 (inklusif) untuk kumpulan sistem. Nilai defaultnya adalah 1.

properties.creationData

CreationData

CreationData yang akan digunakan untuk menentukan ID Rekam Jepret sumber jika kumpulan simpul akan dibuat/ditingkatkan menggunakan rekam jepret.

properties.currentOrchestratorVersion

string

Versi Kubernetes yang dijalankan Kumpulan Agen.
Jika orchestratorVersion adalah versi yang sepenuhnya ditentukan <major.minor.patch>, bidang ini akan sama persis dengannya. Jika orchestratorVersion <>major.minor , bidang ini akan berisi versi <> major.minor.patch lengkap yang digunakan.

properties.eTag

string

String baca-saja unik yang digunakan untuk mengimplementasikan konkurensi optimis. Nilai eTag akan berubah saat sumber daya diperbarui. Tentukan header if-match atau if-none-match dengan nilai eTag untuk permintaan berikutnya untuk mengaktifkan konkurensi optimis sesuai konvensi etag normal.

properties.enableAutoScaling

boolean

Apakah akan mengaktifkan penskala otomatis

properties.enableEncryptionAtHost

boolean

Apakah akan mengaktifkan OS berbasis host dan enkripsi drive data.
Ini hanya didukung pada ukuran VM tertentu dan di wilayah Azure tertentu. Untuk informasi selengkapnya, lihat: https://docs.microsoft.com/azure/aks/enable-host-encryption

properties.enableFIPS

boolean

Apakah akan menggunakan OS berkemampuan FIPS.
Lihat Menambahkan kumpulan simpul berkemampuan FIPS untuk detail selengkapnya.

properties.enableNodePublicIP

boolean

Apakah setiap simpul dialokasikan IP publiknya sendiri.
Beberapa skenario mungkin memerlukan simpul di kumpulan simpul untuk menerima alamat IP publik khusus mereka sendiri. Skenario umum adalah untuk beban kerja permainan, di mana konsol perlu membuat koneksi langsung ke komputer virtual cloud untuk meminimalkan lompatan. Untuk informasi selengkapnya, lihat menetapkan IP publik per simpul. Defaultnya adalah false.

properties.enableUltraSSD

boolean

Apakah akan mengaktifkan UltraSSD

properties.gpuInstanceProfile

GPUInstanceProfile

GPUInstanceProfile yang akan digunakan untuk menentukan profil instans GPU MIG untuk SKU VM GPU yang didukung.

properties.gpuProfile

GPUProfile

Pengaturan GPU untuk Kumpulan Agen.

properties.hostGroupID

string (arm-id)

ID sumber daya yang sepenuhnya memenuhi syarat dari Grup Host Khusus untuk memprovisikan komputer virtual, hanya digunakan dalam skenario pembuatan dan tidak diizinkan untuk berubah sekali diatur.
Ini adalah formulir: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}. Untuk informasi selengkapnya, lihat Host khusus Azure.

properties.kubeletConfig

KubeletConfig

Konfigurasi kubelet simpul agen.
Konfigurasi Kubelet pada simpul kumpulan agen.

properties.kubeletDiskType

KubeletDiskType

Menentukan penempatan volume emptyDir, akar data runtime kontainer, dan penyimpanan sementara Kubelet.

properties.linuxOSConfig

LinuxOSConfig

Konfigurasi OS simpul agen Linux.
Konfigurasi OS simpul agen Linux.

properties.maxCount

integer (int32)

Jumlah maksimum simpul untuk penskalaan otomatis

properties.maxPods

integer (int32)

Jumlah maksimum pod yang dapat berjalan pada simpul.

properties.messageOfTheDay

string

Pesan hari ini untuk simpul Linux, dikodekan base64.
String yang dikodekan base64 yang akan ditulis ke /etc/motd setelah decoding. Ini memungkinkan penyesuaian pesan hari itu untuk simpul Linux. Ini tidak boleh ditentukan untuk simpul Windows. Ini harus berupa string statis (yaitu, akan dicetak mentah dan tidak dijalankan sebagai skrip).

properties.minCount

integer (int32)

Jumlah minimum simpul untuk penskalaan otomatis

properties.mode

AgentPoolMode

Mode kumpulan agen.
Kluster harus memiliki setidaknya satu Kumpulan Agen 'Sistem' setiap saat. Untuk informasi tambahan tentang pembatasan dan praktik terbaik kumpulan agen, lihat: https://docs.microsoft.com/azure/aks/use-system-pools

properties.networkProfile

AgentPoolNetworkProfile

Pengaturan terkait jaringan kumpulan agen.

properties.nodeImageVersion

string

Versi gambar simpul

properties.nodeLabels

object

Label node yang akan dipertahankan di semua simpul di kumpulan agen.

properties.nodePublicIPPrefixID

string (arm-id)

ID awalan IP publik tempat simpul VM harus menggunakan IP.
Ini adalah formulir: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName}

properties.nodeTaints

string[]

Taint ditambahkan ke simpul baru selama pembuatan dan skala kumpulan simpul. Misalnya, key=value:NoSchedule.

properties.orchestratorVersion

string

Versi Kubernetes yang ditentukan oleh pengguna.
Baik versi <patch major.minor.patch> (misalnya 1.20.13) dan <major.minor> (misalnya 1.20) didukung. Ketika <major.minor> ditentukan, versi patch GA terbaru yang didukung dipilih secara otomatis. Memperbarui kluster dengan major.minor< yang sama >setelah dibuat (misalnya 1.14.x -> 1.14) tidak akan memicu peningkatan, bahkan jika versi patch yang lebih baru tersedia. Sebagai praktik terbaik, Anda harus meningkatkan semua kumpulan simpul dalam kluster AKS ke versi Kubernetes yang sama. Versi kumpulan simpul harus memiliki versi utama yang sama dengan sarana kontrol. Versi minor kumpulan simpul harus dalam dua versi minor dari versi sarana kontrol. Versi kumpulan simpul tidak boleh lebih besar dari versi sarana kontrol. Untuk informasi selengkapnya, lihat memutakhirkan kumpulan simpul.

properties.osDiskSizeGB

integer (int32)

minimum: 0
maximum: 2048

Ukuran Disk OS dalam GB yang akan digunakan untuk menentukan ukuran disk untuk setiap komputer di kumpulan master/agen. Jika Anda menentukan 0, itu akan menerapkan ukuran osDisk default sesuai dengan vmSize yang ditentukan.

properties.osDiskType

OSDiskType

Jenis disk OS yang akan digunakan untuk komputer di kumpulan agen.
Defaultnya adalah 'Ephemeral' jika VM mendukungnya dan memiliki disk cache yang lebih besar dari OSDiskSizeGB yang diminta. Jika tidak, default ke 'Terkelola'. Mungkin tidak diubah setelah pembuatan. Untuk informasi selengkapnya, lihat OS Ephemeral.

properties.osSKU

OSSKU

Menentukan SKU OS yang digunakan oleh kumpulan agen. Defaultnya adalah Ubuntu jika OSType adalah Linux. Defaultnya adalah Windows2019 ketika Kubernetes <= 1.24 atau Windows2022 ketika Kubernetes >= 1.25 jika OSType adalah Windows.

properties.osType

OSType

Linux

Jenis sistem operasi. Defaultnya adalah Linux.

properties.podSubnetID

string (arm-id)

ID subnet yang akan bergabung dengan pod saat diluncurkan.
Jika dihilangkan, IP pod secara statis ditetapkan pada subnet simpul (lihat vnetSubnetID untuk detail selengkapnya). Ini adalah formulir: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}

properties.powerState

PowerState

Apakah Kumpulan Agen sedang berjalan atau dihentikan.
Ketika Kumpulan Agen pertama kali dibuat, kumpulan tersebut awalnya Berjalan. Kumpulan Agen dapat dihentikan dengan mengatur bidang ini ke Dihentikan. Kumpulan Agen yang dihentikan menghentikan semua VM-nya dan tidak dikenakan biaya penagihan. Kumpulan Agen hanya dapat dihentikan jika sedang Berjalan dan status provisi Berhasil

properties.provisioningState

string

Status penyebaran atau provisi saat ini.

properties.proximityPlacementGroupID

string (arm-id)

ID untuk Grup Penempatan Kedekatan.

properties.scaleDownMode

ScaleDownMode

Mode penurunan skala yang akan digunakan saat menskalakan Kumpulan Agen.
Ini juga berdampak pada perilaku autoscaler kluster. Jika tidak ditentukan, defaultnya adalah Hapus.

properties.scaleSetEvictionPolicy

ScaleSetEvictionPolicy

Delete

Kebijakan pengeluaran Set Skala Komputer Virtual yang akan digunakan.
Ini tidak dapat ditentukan kecuali scaleSetPriority adalah 'Spot'. Jika tidak ditentukan, defaultnya adalah 'Hapus'.

properties.scaleSetPriority

ScaleSetPriority

Regular

Prioritas Set Skala Komputer Virtual. Jika tidak ditentukan, defaultnya adalah 'Reguler'.

properties.securityProfile

AgentPoolSecurityProfile

Pengaturan keamanan kumpulan agen.

properties.spotMaxPrice

number

-1

Harga maksimum (dalam Dolar AS) yang bersedia Anda bayar untuk instans spot. Nilai yang mungkin adalah nilai desimal apa pun yang lebih besar dari nol atau -1 yang menunjukkan harga default up-to sesuai permintaan.
Nilai yang mungkin adalah nilai desimal apa pun yang lebih besar dari nol atau -1 yang menunjukkan kesediaan untuk membayar harga sesuai permintaan. Untuk detail selengkapnya tentang harga spot, lihat harga VM spot

properties.tags

object

Tag yang akan dipertahankan pada kumpulan agen set skala komputer virtual.

properties.type

AgentPoolType

Jenis Kumpulan Agen.

properties.upgradeSettings

AgentPoolUpgradeSettings

Pengaturan untuk memutakhirkan agentpool

properties.vmSize

string

Ukuran VM kumpulan agen.
Ketersediaan ukuran VM bervariasi menurut wilayah. Jika sebuah simpul berisi sumber daya komputasi (memori, cpu, dll) pod yang tidak memadai mungkin gagal berjalan dengan benar. Untuk detail selengkapnya tentang ukuran VM terbatas, lihat: https://docs.microsoft.com/azure/aks/quotas-skus-regions

properties.vnetSubnetID

string (arm-id)

ID subnet simpul kumpulan agen dan pod opsional akan bergabung pada startup.
Jika ini tidak ditentukan, VNET dan subnet akan dihasilkan dan digunakan. Jika tidak ada podSubnetID yang ditentukan, ini berlaku untuk simpul dan pod, jika tidak, pod tersebut hanya berlaku untuk simpul. Ini adalah formulir: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}

properties.windowsProfile

AgentPoolWindowsProfile

Profil spesifik kumpulan agen Windows.

properties.workloadRuntime

WorkloadRuntime

Menentukan jenis beban kerja yang dapat dijalankan simpul.

type

string

Jenis sumber daya

AgentPoolMode

Mode kumpulan agen.

Nilai Deskripsi
System

Kumpulan agen sistem terutama untuk menghosting pod sistem penting seperti CoreDNS dan metrics-server. Kumpulan agen sistem osType harus Linux. SKU VM kumpulan agen sistem harus memiliki setidaknya 2vCPU dan memori 4GB.

User

Kumpulan agen pengguna terutama untuk menghosting pod aplikasi Anda.

AgentPoolNetworkProfile

Pengaturan jaringan kumpulan agen.

Nama Jenis Deskripsi
allowedHostPorts

PortRange[]

Rentang port yang diizinkan untuk diakses. Rentang yang ditentukan diizinkan untuk tumpang tindih.

applicationSecurityGroups

string[] (arm-id)

ID grup keamanan aplikasi yang akan dikaitkan dengan kumpulan agen saat dibuat.

nodePublicIPTags

IPTag[]

IPTag IP publik tingkat instans.

AgentPoolSecurityProfile

Pengaturan keamanan kumpulan agen.

Nama Jenis Deskripsi
enableSecureBoot

boolean

Boot Aman adalah fitur Peluncuran Tepercaya yang memastikan bahwa hanya sistem operasi dan driver yang ditandatangani yang dapat melakukan booting. Untuk detail selengkapnya, lihat aka.ms/aks/trustedlaunch. Jika tidak ditentukan, defaultnya adalah false.

enableVTPM

boolean

vTPM adalah fitur Peluncuran Tepercaya untuk mengonfigurasi brankas aman khusus untuk kunci dan pengukuran yang disimpan secara lokal pada simpul. Untuk detail selengkapnya, lihat aka.ms/aks/trustedlaunch. Jika tidak ditentukan, defaultnya adalah false.

AgentPoolType

Jenis Kumpulan Agen.

Nilai Deskripsi
AvailabilitySet

Penggunaan ini sangat tidak disarankan.

VirtualMachineScaleSets

Buat Kumpulan Agen yang didukung oleh Set Skala Komputer Virtual.

AgentPoolUpgradeSettings

Pengaturan untuk memutakhirkan agentpool

Nama Jenis Deskripsi
drainTimeoutInMinutes

integer (int32)

minimum: 1
maximum: 1440

Batas waktu pengurasan untuk node
Jumlah waktu (dalam menit) untuk menunggu pengeluaran pod dan penghentian anggun per simpul. Waktu tunggu pengeluaran ini menghormati menunggu anggaran gangguan pod. Jika waktu ini terlampaui, peningkatan gagal. Jika tidak ditentukan, defaultnya adalah 30 menit.

maxSurge

string

Jumlah maksimum atau persentase simpul yang melonjak selama peningkatan.
Ini dapat diatur ke bilangan bulat (misalnya '5') atau persentase (misalnya ' 50%'). Jika persentase ditentukan, persentase dari total ukuran kumpulan agen pada saat peningkatan. Untuk persentase, simpul pecahan dibulatkan ke atas. Jika tidak ditentukan, defaultnya adalah 10%. Untuk informasi selengkapnya, termasuk praktik terbaik, lihat: https://learn.microsoft.com/en-us/azure/aks/upgrade-cluster

maxUnavailable

string

Jumlah maksimum atau persentase simpul yang secara bersamaan tidak tersedia selama peningkatan.
Ini dapat diatur ke bilangan bulat (misalnya '1') atau persentase (misalnya '5%'). Jika persentase ditentukan, persentase dari total ukuran kumpulan agen pada saat peningkatan. Untuk persentase, simpul pecahan dibulatkan ke atas. Jika tidak ditentukan, defaultnya adalah 0. Untuk informasi selengkapnya, termasuk praktik terbaik, lihat: https://learn.microsoft.com/en-us/azure/aks/upgrade-cluster

nodeSoakDurationInMinutes

integer (int32)

minimum: 0
maximum: 30

Durasi rendam untuk node
Jumlah waktu (dalam menit) untuk menunggu setelah menguras simpul dan sebelum menggantinya dan beralih ke simpul berikutnya. Jika tidak ditentukan, defaultnya adalah 0 menit.

undrainableNodeBehavior

UndrainableNodeBehavior

Menentukan perilaku untuk simpul yang tidak dapat dibatalkan selama peningkatan. Penyebab paling umum dari simpul yang tidak dapat dibatalkan adalah Anggaran Gangguan Pod (PDB), tetapi masalah lain, seperti masa tenggang penghentian pod melebihi batas waktu pengurasan per node yang tersisa atau pod masih dalam keadaan berjalan, juga dapat menyebabkan simpul yang tidak dapat dibatalkan.

AgentPoolWindowsProfile

Profil spesifik kumpulan agen Windows.

Nama Jenis Deskripsi
disableOutboundNat

boolean

Apakah akan menonaktifkan OutboundNAT di simpul windows
Nilai defaultnya adalah false. NAT keluar hanya dapat dinonaktifkan jika outboundType kluster adalah NAT Gateway dan kumpulan agen Windows tidak mengaktifkan IP publik node.

CloudError

Respons kesalahan dari layanan Kontainer.

Nama Jenis Deskripsi
error

CloudErrorBody

Detail tentang kesalahan.

CloudErrorBody

Respons kesalahan dari layanan Kontainer.

Nama Jenis Deskripsi
code

string

Pengidentifikasi untuk kesalahan. Kode invarian dan dimaksudkan untuk dikonsumsi secara terprogram.

details

CloudErrorBody[]

Daftar detail tambahan tentang kesalahan.

message

string

Pesan yang menjelaskan kesalahan, dimaksudkan agar cocok untuk ditampilkan di antarmuka pengguna.

target

string

Target kesalahan tertentu. Misalnya, nama properti dalam kesalahan.

code

Memberi tahu apakah kluster Sedang Berjalan atau Dihentikan

Nilai Deskripsi
Running

Kluster sedang berjalan.

Stopped

Kluster dihentikan.

CreationData

Data yang digunakan saat membuat sumber daya target dari sumber daya sumber.

Nama Jenis Deskripsi
sourceResourceId

string (arm-id)

Ini adalah ID ARM dari objek sumber yang akan digunakan untuk membuat objek target.

GPUDriver

Apakah akan menginstal driver GPU. Jika tidak ditentukan, defaultnya adalah Instal.

Nilai Deskripsi
Install

Pasang driver.

None

Lewati penginstalan driver.

GPUInstanceProfile

GPUInstanceProfile yang akan digunakan untuk menentukan profil instans GPU MIG untuk SKU VM GPU yang didukung.

Nilai Deskripsi
MIG1g
MIG2g
MIG3g
MIG4g
MIG7g

GPUProfile

Pengaturan GPU untuk Kumpulan Agen.

Nama Jenis Deskripsi
driver

GPUDriver

Apakah akan menginstal driver GPU. Jika tidak ditentukan, defaultnya adalah Instal.

IPTag

Berisi IPTag yang terkait dengan objek .

Nama Jenis Deskripsi
ipTagType

string

Jenis tag IP. Contoh: RoutingPreference.

tag

string

Nilai tag IP yang terkait dengan IP publik. Contoh: Internet.

KubeletConfig

Konfigurasi kubelet simpul agen.

Nama Jenis Deskripsi
allowedUnsafeSysctls

string[]

Daftar sysctl yang tidak aman atau pola sysctl yang tidak aman (berakhiran *).

containerLogMaxFiles

integer (int32)

minimum: 2

Jumlah maksimum file log kontainer yang dapat ada untuk kontainer. Angka harus ≥ 2.

containerLogMaxSizeMB

integer (int32)

Ukuran maksimum (misalnya 10Mi) file log kontainer sebelum diputar.

cpuCfsQuota

boolean

Jika pemberlakuan kuota CPU CFS diaktifkan untuk kontainer yang menentukan batas CPU.
Nilai bawaan adalah benar.

cpuCfsQuotaPeriod

string

Nilai periode kuota CPU CFS.
Defaultnya adalah '100ms.' Nilai yang valid adalah urutan angka desimal dengan pecahan opsional dan akhiran unit. Misalnya: '300ms', '2h45m'. Unit yang didukung adalah 'ns', 'us', 'ms', 's', 'm', dan 'h'.

cpuManagerPolicy

string

Kebijakan Manajer CPU yang akan digunakan.
Defaultnya adalah 'none'. Lihat Kebijakan manajemen CPU Kubernetes untuk informasi selengkapnya. Nilai yang diizinkan adalah 'none' dan 'statis'.

failSwapOn

boolean

Jika diatur ke true, itu akan membuat Kubelet gagal memulai jika pertukaran diaktifkan pada simpul.

imageGcHighThreshold

integer (int32)

Persentase penggunaan disk setelah pengumpulan sampah gambar selalu dijalankan.
Untuk menonaktifkan pengumpulan sampah gambar, atur ke 100. Defaultnya adalah 85%

imageGcLowThreshold

integer (int32)

Persentase penggunaan disk sebelum pengumpulan sampah gambar tidak pernah dijalankan.
Ini tidak dapat diatur lebih tinggi dari imageGcHighThreshold. Defaultnya adalah 80%

podMaxPids

integer (int32)

Jumlah maksimum proses per pod.

topologyManagerPolicy

string

Kebijakan Manajer Topologi yang akan digunakan.
Untuk informasi selengkapnya, lihat Manajer Topologi Kubernetes. Defaultnya adalah 'none'. Nilai yang diizinkan adalah 'none', 'best-effort', 'restricted', dan 'single-numa-node'.

KubeletDiskType

Menentukan penempatan volume emptyDir, akar data runtime kontainer, dan penyimpanan sementara Kubelet.

Nilai Deskripsi
OS

Kubelet akan menggunakan disk OS untuk datanya.

Temporary

Kubelet akan menggunakan disk sementara untuk datanya.

LinuxOSConfig

Konfigurasi OS simpul agen Linux.

Nama Jenis Deskripsi
swapFileSizeMB

integer (int32)

Ukuran dalam MB file swap yang akan dibuat pada setiap simpul.

sysctls

SysctlConfig

Pengaturan Sysctl untuk simpul agen Linux.

transparentHugePageDefrag

string

Apakah kernel harus menggunakan pemadatan memori yang agresif untuk membuat lebih banyak halaman yang tersedia.
Nilai yang valid adalah 'always', 'defer', 'defer+madvise', 'madvise' dan 'never'. Defaultnya adalah 'madvise'. Untuk informasi selengkapnya, lihat Transparent Hugepages.

transparentHugePageEnabled

string

Apakah halaman besar transparan diaktifkan.
Nilai yang valid adalah 'always', 'madvise', dan 'never'. Defaultnya adalah 'always'. Untuk informasi selengkapnya, lihat Transparent Hugepages.

OSDiskType

Jenis disk OS yang akan digunakan untuk komputer di kumpulan agen.

Nilai Deskripsi
Ephemeral

Disk OS sementara hanya disimpan di komputer host, sama seperti disk sementara. Ini memberikan latensi baca/tulis yang lebih rendah, bersama dengan penskalaan node dan peningkatan kluster yang lebih cepat.

Managed

Azure mereplikasi disk sistem operasi untuk komputer virtual ke penyimpanan Azure untuk menghindari kehilangan data jika VM perlu dipindahkan ke host lain. Karena kontainer tidak dirancang agar status lokal tetap ada, perilaku ini menawarkan nilai terbatas sambil memberikan beberapa kelemahan, termasuk provisi simpul yang lebih lambat dan latensi baca/tulis yang lebih tinggi.

OSSKU

Menentukan SKU OS yang digunakan oleh kumpulan agen. Defaultnya adalah Ubuntu jika OSType adalah Linux. Defaultnya adalah Windows2019 ketika Kubernetes <= 1.24 atau Windows2022 ketika Kubernetes >= 1.25 jika OSType adalah Windows.

Nilai Deskripsi
AzureLinux

Gunakan AzureLinux sebagai OS untuk gambar simpul. Azure Linux adalah distro Linux yang dioptimalkan kontainer yang dibangun oleh Microsoft, kunjungi https://aka.ms/azurelinux untuk informasi selengkapnya.

CBLMariner

OSSKU yang tidak digunakan lagi. Microsoft menyarankan agar penyebaran baru memilih 'AzureLinux' sebagai gantinya.

Ubuntu

Gunakan Ubuntu sebagai OS untuk gambar simpul.

Ubuntu2204

Gunakan Ubuntu2204 sebagai OS untuk gambar node, namun, Ubuntu 22.04 mungkin tidak didukung untuk semua nodepool. Untuk batasan dan versi kubernetes yang didukung, lihat lihat https://aka.ms/aks/supported-ubuntu-versions

Windows2019

Gunakan Windows2019 sebagai OS untuk gambar simpul. Tidak didukung untuk kumpulan simpul sistem. Windows2019 hanya mendukung kontainer Windows2019; ini tidak dapat menjalankan kontainer Windows2022 dan sebaliknya.

Windows2022

Gunakan Windows2022 sebagai OS untuk gambar simpul. Tidak didukung untuk kumpulan simpul sistem. Windows2022 hanya mendukung kontainer Windows2022; ini tidak dapat menjalankan kontainer Windows2019 dan sebaliknya.

OSType

Jenis sistem operasi. Defaultnya adalah Linux.

Nilai Deskripsi
Linux

Gunakan Linux.

Windows

Gunakan Windows.

PortRange

Rentang port.

Nama Jenis Deskripsi
portEnd

integer (int32)

minimum: 1
maximum: 65535

Port maksimum yang disertakan dalam rentang. Ini harus berkisar dari 1 hingga 65535, dan lebih besar dari atau sama dengan portStart.

portStart

integer (int32)

minimum: 1
maximum: 65535

Port minimum yang disertakan dalam rentang. Ini harus berkisar dari 1 hingga 65535, dan kurang dari atau sama dengan portEnd.

protocol

Protocol

Protokol jaringan port.

PowerState

Menjelaskan Status Daya kluster

Nama Jenis Deskripsi
code

code

Memberi tahu apakah kluster Sedang Berjalan atau Dihentikan

Protocol

Protokol jaringan port.

Nilai Deskripsi
TCP

Protokol TCP.

UDP

Protokol UDP.

ScaleDownMode

Menjelaskan bagaimana VM ditambahkan atau dihapus dari Kumpulan Agen. Lihat status penagihan.

Nilai Deskripsi
Deallocate

Coba mulai instans yang dibatalkan alokasinya (jika ada) selama peningkatan skala dan batalkan alokasi instans selama penurunan skala.

Delete

Buat instans baru selama peningkatan skala dan hapus instans selama penurunan skala.

ScaleSetEvictionPolicy

Kebijakan pengeluaran Set Skala Komputer Virtual.

Nilai Deskripsi
Deallocate

Simpul dalam Set Skala yang mendasar dari kumpulan simpul diatur ke status dihentikan-dibatalkan alokasinya setelah pengeluaran. Simpul dalam jumlah status yang dihentikan alokasinya terhadap kuota komputasi Anda dan dapat menyebabkan masalah dengan penskalaan atau peningkatan kluster.

Delete

Simpul di Set Skala yang mendasar dari kumpulan simpul dihapus saat dikeluarkan.

ScaleSetPriority

Prioritas Set Skala Komputer Virtual.

Nilai Deskripsi
Regular

VM reguler akan digunakan.

Spot

VM prioritas spot akan digunakan. Tidak ada SLA untuk simpul spot. Lihat spot di AKS untuk informasi selengkapnya.

SysctlConfig

Pengaturan Sysctl untuk simpul agen Linux.

Nama Jenis Deskripsi
fsAioMaxNr

integer (int32)

Pengaturan Sysctl fs.aio-max-nr.

fsFileMax

integer (int32)

Pengaturan Sysctl fs.file-max.

fsInotifyMaxUserWatches

integer (int32)

Pengaturan Sysctl fs.inotify.max_user_watches.

fsNrOpen

integer (int32)

Pengaturan Sysctl fs.nr_open.

kernelThreadsMax

integer (int32)

Pengaturan Sysctl kernel.threads-max.

netCoreNetdevMaxBacklog

integer (int32)

Pengaturan Sysctl net.core.netdev_max_backlog.

netCoreOptmemMax

integer (int32)

Pengaturan Sysctl net.core.optmem_max.

netCoreRmemDefault

integer (int32)

Pengaturan Sysctl net.core.rmem_default.

netCoreRmemMax

integer (int32)

Pengaturan Sysctl net.core.rmem_max.

netCoreSomaxconn

integer (int32)

Pengaturan Sysctl net.core.somaxconn.

netCoreWmemDefault

integer (int32)

Pengaturan Sysctl net.core.wmem_default.

netCoreWmemMax

integer (int32)

Pengaturan Sysctl net.core.wmem_max.

netIpv4IpLocalPortRange

string

Pengaturan Sysctl net.ipv4.ip_local_port_range.

netIpv4NeighDefaultGcThresh1

integer (int32)

Pengaturan Sysctl net.ipv4.neigh.default.gc_thresh1.

netIpv4NeighDefaultGcThresh2

integer (int32)

Pengaturan Sysctl net.ipv4.neigh.default.gc_thresh2.

netIpv4NeighDefaultGcThresh3

integer (int32)

Pengaturan Sysctl net.ipv4.neigh.default.gc_thresh3.

netIpv4TcpFinTimeout

integer (int32)

Pengaturan Sysctl net.ipv4.tcp_fin_timeout.

netIpv4TcpKeepaliveProbes

integer (int32)

Pengaturan Sysctl net.ipv4.tcp_keepalive_probes.

netIpv4TcpKeepaliveTime

integer (int32)

Pengaturan Sysctl net.ipv4.tcp_keepalive_time.

netIpv4TcpMaxSynBacklog

integer (int32)

Pengaturan Sysctl net.ipv4.tcp_max_syn_backlog.

netIpv4TcpMaxTwBuckets

integer (int32)

Pengaturan Sysctl net.ipv4.tcp_max_tw_buckets.

netIpv4TcpTwReuse

boolean

Pengaturan Sysctl net.ipv4.tcp_tw_reuse.

netIpv4TcpkeepaliveIntvl

integer (int32)

minimum: 10
maximum: 90

Pengaturan Sysctl net.ipv4.tcp_keepalive_intvl.

netNetfilterNfConntrackBuckets

integer (int32)

minimum: 65536
maximum: 524288

Pengaturan Sysctl net.netfilter.nf_conntrack_buckets.

netNetfilterNfConntrackMax

integer (int32)

minimum: 131072
maximum: 2097152

Pengaturan Sysctl net.netfilter.nf_conntrack_max.

vmMaxMapCount

integer (int32)

Pengaturan Sysctl vm.max_map_count.

vmSwappiness

integer (int32)

Pengaturan Sysctl vm.swappiness.

vmVfsCachePressure

integer (int32)

Pengaturan Sysctl vm.vfs_cache_pressure.

UndrainableNodeBehavior

Menentukan perilaku untuk simpul yang tidak dapat dibatalkan selama peningkatan. Penyebab paling umum dari simpul yang tidak dapat dibatalkan adalah Anggaran Gangguan Pod (PDB), tetapi masalah lain, seperti masa tenggang penghentian pod melebihi batas waktu pengurasan per node yang tersisa atau pod masih dalam keadaan berjalan, juga dapat menyebabkan simpul yang tidak dapat dibatalkan.

Nilai Deskripsi
Cordon

AKS akan menghubungkan simpul yang diblokir dan menggantinya dengan node lonjakan selama peningkatan. Simpul yang diblokir akan disambungkan dan digantikan oleh node lonjakan. Simpul yang diblokir akan memiliki label 'kubernetes.azure.com/upgrade-status:Quarantined'. Simpul lonjakan akan dipertahankan untuk setiap simpul yang diblokir. Upaya terbaik akan dilakukan untuk menghapus semua simpul lonjakan lainnya. Jika ada cukup node lonjakan untuk menggantikan simpul yang diblokir, maka operasi peningkatan dan kluster terkelola akan dalam status gagal. Jika tidak, operasi peningkatan dan kluster terkelola akan dalam status dibatalkan.

Schedule

AKS akan menandai simpul yang diblokir yang dapat di-schedulable, tetapi simpul yang diblokir tidak ditingkatkan. Upaya terbaik akan dilakukan untuk menghapus semua simpul lonjakan. Operasi peningkatan dan kluster terkelola akan dalam status gagal jika ada simpul yang diblokir.

WorkloadRuntime

Menentukan jenis beban kerja yang dapat dijalankan simpul.

Nilai Deskripsi
OCIContainer

Simpul akan menggunakan Kubelet untuk menjalankan beban kerja kontainer OCI standar.

WasmWasi

Simpul akan menggunakan Krustlet untuk menjalankan beban kerja WASM menggunakan penyedia WASI (Pratinjau).