Tutorial: Memutakhirkan Kubernetes di Azure Kubernetes Service (AKS)

Sebagai bagian dari siklus hidup aplikasi dan kluster, Anda mungkin ingin meningkatkan ke versi Kubernetes terbaru yang tersedia. Anda dapat meningkatkan kluster Azure Kubernetes Service (AKS) dengan menggunakan Azure CLI, Azure PowerShell, atau portal Azure.

Dalam tutorial ini, bagian tujuh dari tujuh, Anda belajar cara:

• Identifikasi versi Kubernetes saat ini dan yang tersedia.
• Tingkatkan node Kubernetes Anda.
• Memvalidasi peningkatan yang berhasil.

Sebelum Anda mulai

Dalam tutorial sebelumnya, aplikasi dimas ke dalam gambar kontainer, dan gambar kontainer ini diunggah ke Azure Container Registry (ACR). Anda juga membuat kluster AKS. Aplikasi kemudian disebarkan ke kluster AKS. Jika Anda belum melakukan langkah-langkah ini dan ingin mengikuti, mulailah dengan Tutorial 1: Menyiapkan aplikasi untuk AKS.

• Jika Anda menggunakan Azure CLI, tutorial ini mengharuskan Anda menjalankan Azure CLI versi 2.34.1 atau yang lebih baru. Jalankan az --version untuk menemukan versinya. Jika Anda perlu memasang atau meningkatkan, lihat Pasang CLI Azure.
• Jika Anda menggunakan Azure PowerShell, tutorial ini mengharuskan Anda menjalankan Azure PowerShell versi 5.9.0 atau yang lebih baru. Jalankan Get-InstalledModule -Name Az untuk menemukan versinya. Jika Anda perlu menginstal atau meningkatkan, lihat Install modul Azure PowerShell.

Dapatkan versi kluster yang tersedia

Azure CLI

Sebelum memutakhirkan kluster, gunakan perintah az aks get-upgrades untuk memeriksa rilis Kubernetes mana yang tersedia.

az aks get-upgrades --resource-group myResourceGroup --name myAKSCluster

Dalam contoh output berikut, versi saat ini adalah 1.18.10, dan versi yang tersedia ditampilkan di bawah peningkatan.

{
  "agentPoolProfiles": null,
  "controlPlaneProfile": {
    "kubernetesVersion": "1.18.10",
    ...
    "upgrades": [
      {
        "isPreview": null,
        "kubernetesVersion": "1.19.1"
      },
      {
        "isPreview": null,
        "kubernetesVersion": "1.19.3"
      }
    ]
  },
  ...
}

Azure PowerShell

Sebelum memutakhirkan kluster, gunakan cmdlet Get-AzAksCluster untuk memeriksa versi Kubernetes mana yang Anda jalankan dan wilayah tempatnya berada.

Get-AzAksCluster -ResourceGroupName myResourceGroup -Name myAKSCluster |
  Select-Object -Property Name, KubernetesVersion, Location

Dalam contoh output berikut, versi saat ini adalah 1.19.9.

Name            KubernetesVersion       Location
----            -----------------       --------
myAKSCluster    1.19.9                  eastus

Gunakan cmdlet Get-AzAksVersion untuk memeriksa rilis peningkatan Kubernetes mana yang tersedia di wilayah tempat kluster AKS Berada.

Get-AzAksVersion -Location eastus | Where-Object OrchestratorVersion -gt 1.19.9

Versi yang tersedia ditampilkan di bawah OrchestratorVersion.

Default     IsPreview     OrchestratorType     OrchestratorVersion
-------     ---------     ----------------     -------------------
                          Kubernetes           1.20.2
                          Kubernetes           1.20.5

portal Microsoft Azure

Untuk memeriksa rilis Kubernetes mana yang tersedia untuk kluster Anda:

1. Masuk ke portal Azure.
2. Navigasi ke kluster AKS Anda.
3. Di bawah Pengaturan, pilih Konfigurasi kluster.
4. Di versi Kubernetes, pilih Tingkatkan versi. Ini akan mengarahkan Anda ke halaman baru.
5. Dalam versi Kubernetes, pilih versi untuk memeriksa peningkatan yang tersedia.

Jika peningkatan tidak tersedia, buat kluster baru dengan versi Kubernetes yang didukung dan migrasikan beban kerja Anda dari kluster yang ada ke kluster baru. Tidak didukung untuk memutakhirkan kluster ke versi Kubernetes yang lebih baru ketika tidak ada peningkatan yang tersedia.

Mutakhirkan kluster

Simpul AKS dikaitkan dengan hati-hati dan dikosongkan untuk meminimalkan potensi gangguan pada aplikasi yang berjalan. Langkah-langkah berikut dilakukan selama proses ini:

1. Penjadwal Kubernetes mencegah pod tambahan dijadwalkan pada simpul yang akan ditingkatkan.
2. Pod yang berjalan pada simpul dijadwalkan pada simpul lain di kluster.
3. Simpul baru dibuat yang menjalankan komponen Kubernetes terbaru.
4. Ketika simpul baru siap dan bergabung ke kluster, penjadwal Kubernetes mulai menjalankan pod pada simpul baru.
5. Simpul lama dihapus, dan simpul berikutnya dalam kluster memulai proses cordon dan drain.

Catatan

Jika tidak ada patch yang ditentukan, kluster akan secara otomatis ditingkatkan ke patch GA terbaru versi minor yang ditentukan. Misalnya, mengatur --kubernetes-version ke 1.21 akan mengakibatkan kluster ditingkatkan ke 1.21.9.

Saat meningkatkan berdasarkan versi minor alias, hanya versi minor yang lebih tinggi yang didukung. Misalnya, meningkatkan dari 1.20.x ke 1.20 tidak akan memicu peningkatan ke patch 1.20 GA terbaru, tetapi meningkatkan ke 1.21 akan memicu peningkatan ke patch 1.21 GA terbaru.

Azure CLI

Gunakan perintah az aks upgrade untuk meningkatkan kluster AKS Anda.

az aks upgrade \
    --resource-group myResourceGroup \
    --name myAKSCluster \
    --kubernetes-version KUBERNETES_VERSION

Catatan

Anda hanya dapat memutakhirkan satu versi minor sekaligus. Misalnya, Anda dapat meningkatkan dari 1.14.x ke 1.15.x, tetapi Anda tidak dapat meningkatkan dari 1.14.x ke 1.16.x secara langsung. Untuk meningkatkan dari 1.14.x ke 1.16.x, Anda harus terlebih dahulu meningkatkan dari 1.14.x ke 1.15.x, lalu melakukan peningkatan lain dari 1.15.x ke 1.16.x.

Contoh output berikut menunjukkan hasil peningkatan ke 1.19.1. Perhatikan bahwa kubernetesVersion sekarang melaporkan 1.19.1.

{
  "agentPoolProfiles": [
    {
      "count": 3,
      "maxPods": 110,
      "name": "nodepool1",
      "osType": "Linux",
      "storageProfile": "ManagedDisks",
      "vmSize": "Standard_DS1_v2",
    }
  ],
  "dnsPrefix": "myAKSClust-myResourceGroup-19da35",
  "enableRbac": false,
  "fqdn": "myaksclust-myresourcegroup-19da35-bd54a4be.hcp.eastus.azmk8s.io",
  "id": "/subscriptions/<Subscription ID>/resourcegroups/myResourceGroup/providers/Microsoft.ContainerService/managedClusters/myAKSCluster",
  "kubernetesVersion": "1.19.1",
  "location": "eastus",
  "name": "myAKSCluster",
  "type": "Microsoft.ContainerService/ManagedClusters"
}

Azure PowerShell

Gunakan cmdlet Set-AzAksCluster untuk meningkatkan kluster AKS Anda.

Set-AzAksCluster -ResourceGroupName myResourceGroup -Name myAKSCluster -KubernetesVersion <KUBERNETES_VERSION>

Catatan

Anda hanya dapat memutakhirkan satu versi minor sekaligus. Misalnya, Anda dapat meningkatkan dari 1.14.x ke 1.15.x, tetapi Anda tidak dapat meningkatkan dari 1.14.x ke 1.16.x secara langsung. Untuk memutakhirkan dari 1.14.x ke 1.16.x, pemutakhirkan pertama dari 1.14.x ke 1.15.x, lalu lakukan pemutakhirkan lain dari 1.15.x ke 1.16.x.

Contoh output berikut menunjukkan hasil peningkatan ke 1.19.9. Perhatikan bahwa kubernetesVersion sekarang melaporkan 1.20.2.

ProvisioningState       : Succeeded
MaxAgentPools           : 100
KubernetesVersion       : 1.20.2
PrivateFQDN             :
AgentPoolProfiles       : {default}
Name                    : myAKSCluster
Type                    : Microsoft.ContainerService/ManagedClusters
Location                : eastus
Tags                    : {}

portal Microsoft Azure

Untuk meningkatkan kluster AKS Anda:

1. Di portal Azure, navigasikan ke kluster AKS Anda.
2. Di bawah Pengaturan, pilih Konfigurasi kluster.
3. Di versi Kubernetes, pilih Tingkatkan versi. Ini akan mengarahkan Anda ke halaman baru.
4. Di versi Kubernetes, pilih versi yang Anda inginkan lalu pilih Simpan.

Dibutuhkan beberapa menit untuk meningkatkan kluster, tergantung pada berapa banyak simpul yang Anda miliki.

Menampilkan peristiwa peningkatan

Saat Anda meningkatkan kluster, peristiwa Kubernetes berikut dapat terjadi pada node:

• Lonjakan: Buat simpul lonjakan.
• Pengurasan: Pod sedang dikeluarkan dari simpul. Setiap pod memiliki batas waktu 5 menit untuk menyelesaikan pengeluaran.
• Pembaruan: Pembaruan simpul telah berhasil atau gagal.
• Hapus: Menghapus simpul lonjakan.

Gunakan kubectl get events untuk menampilkan peristiwa di ruang nama default saat menjalankan peningkatan.

kubectl get events 

Contoh output berikut menunjukkan beberapa peristiwa di atas yang tercantum selama pemutakhiran.

...
default 2m1s Normal Drain node/aks-nodepool1-96663640-vmss000001 Draining node: [aks-nodepool1-96663640-vmss000001]
...
default 9m22s Normal Surge node/aks-nodepool1-96663640-vmss000002 Created a surge node [aks-nodepool1-96663640-vmss000002 nodepool1] for agentpool %!s(MISSING)
...

---

Memvalidasi pemutakhiran

Azure CLI

Konfirmasikan bahwa peningkatan berhasil menggunakan perintah az aks show .

az aks show --resource-group myResourceGroup --name myAKSCluster --output table

Contoh output berikut menunjukkan kluster AKS menjalankan KubernetesVersion 1.19.1:

Name          Location    ResourceGroup    KubernetesVersion    CurrentKubernetesVersion  ProvisioningState    Fqdn
------------  ----------  ---------------  -------------------  ------------------------  -------------------  ----------------------------------------------------------------
myAKSCluster  eastus      myResourceGroup  1.19.1               1.19.1                    Succeeded            myaksclust-myresourcegroup-19da35-bd54a4be.hcp.eastus.azmk8s.io

Azure PowerShell

Konfirmasikan bahwa peningkatan berhasil menggunakan cmdlet Get-AzAksCluster .

Get-AzAksCluster -ResourceGroupName myResourceGroup -Name myAKSCluster |
  Select-Object -Property Name, Location, KubernetesVersion, ProvisioningState

Contoh output berikut menunjukkan kluster AKS menjalankan KubernetesVersion 1.20.2:

Name         Location   KubernetesVersion   ProvisioningState
----         --------   -----------------   -----------------
myAKSCluster eastus     1.20.2              Succeeded

portal Microsoft Azure

Untuk mengonfirmasi bahwa peningkatan berhasil, navigasikan ke kluster AKS Anda di portal Azure. Pada halaman Gambaran Umum , pilih versi Kubernetes dan pastikan itu adalah versi terbaru yang Anda instal di langkah sebelumnya.

Menghapus kluster

Karena tutorial ini adalah bagian terakhir dari seri ini, Anda mungkin ingin menghapus kluster AKS Anda. Simpul Kubernetes berjalan pada komputer virtual Azure dan terus dikenakan biaya bahkan jika Anda tidak menggunakan kluster.

Azure CLI

Gunakan perintah az group delete untuk menghapus grup sumber daya, layanan kontainer, dan semua sumber daya terkait.

az group delete --name myResourceGroup --yes --no-wait

Azure PowerShell

GunakanRemove-AzResourceGroup cmdletuntuk menghapus grup sumber daya, layanan kontainer, dan semua sumber daya yang terkait.

Remove-AzResourceGroup -Name myResourceGroup

portal Microsoft Azure

Untuk menghapus kluster AKS Anda:

1. Di portal Azure, navigasikan ke kluster AKS Anda.
2. Pada halaman Gambaran Umum pilih Hapus.
3. Popup akan muncul yang meminta Anda untuk mengonfirmasi penghapusan kluster. Pilih Ya.

Catatan

Saat Anda menghapus kluster, perwakilan layanan Azure Active Directory (AAD) yang digunakan oleh kluster AKS tidak dihapus. Untuk langkah tentang cara menghapus perwakilan layanan, lihatPertimbangan dan penghapusan perwakilan layanan AKS. Jika Anda menggunakan identitas terkelola, identitas dikelola oleh platform dan tidak mengharuskan Anda menyediakan atau memutar rahasia apa pun.

Langkah berikutnya

Dalam tutorial ini, Anda memutakhirkan Kubernetes dalam kluster AKS. Anda mempelajari cara untuk:

• Identifikasi versi Kubernetes saat ini dan yang tersedia.
• Tingkatkan node Kubernetes Anda.
• Memvalidasi peningkatan yang berhasil.

Untuk informasi selengkapnya tentang AKS, lihat Gambaran umum AKS. Untuk panduan tentang cara membuat solusi lengkap dengan AKS, lihat panduan solusi AKS.