Meningkatkan jenis kluster hub untuk sumber daya Azure Kubernetes Fleet Manager

Dalam artikel ini, Anda mempelajari cara meningkatkan sumber daya Azure Kubernetes Fleet Manager (Kubernetes Fleet) tanpa kluster hub ke sumber daya Armada Kubernetes yang memiliki kluster hub. Ketika sumber daya Armada Kubernetes dibuat tanpa kluster hub, kluster Azure Kubernetes Service (AKS) pusat tidak dibuat untuk sumber daya Armada Kubernetes. Ketika sumber daya Kubernetes Fleet dengan kluster hub dibuat, kluster AKS pusat dan terkelola dibuat untuk mengaktifkan skenario seperti orkestrasi beban kerja dan penyeimbangan beban lapisan-4.

Untuk informasi selengkapnya, lihat Memilih opsi Azure Kubernetes Fleet Manager.

Prasyarat dan batasan

Jika Anda tidak memiliki Langganan Azure, buat Akun gratis Azure sebelum memulai.

• Instal atau tingkatkan Azure CLI ke versi terbaru.
• Akun Azure dengan langganan aktif. Buat akun secara gratis.
• Anda harus memiliki sumber daya Kubernetes Fleet yang ada tanpa kluster hub. Langkah-langkah dalam artikel ini menunjukkan kepada Anda cara membuat sumber daya Armada Kubernetes tanpa kluster hub. Jika sudah memilikinya, Anda dapat melewati penyiapan awal dan memulai di Jenis kluster hub peningkatan untuk sumber daya Armada Kubernetes.
• Artikel ini juga menyertakan langkah-langkah bergabung dengan kluster anggota. Jika Anda berencana untuk mengikutinya, Anda memerlukan setidaknya satu kluster AKS.

Penting

Sumber daya Armada Kubernetes tanpa kluster hub dapat ditingkatkan ke sumber daya Armada Kubernetes dengan kluster hub. Namun, sumber daya Armada Kubernetes yang sudah memiliki kluster hub tidak dapat diturunkan ke sumber daya Armada Kubernetes tanpa kluster hub. Semua opsi konfigurasi dan pengaturan yang terkait dengan sumber daya Armada Kubernetes yang memiliki kluster hub tidak dapat diubah dan tidak dapat diubah setelah waktu pembuatan atau peningkatan. Peningkatan dari sumber daya Armada Kubernetes tanpa kluster hub ke satu dengan kluster hub hanya dapat dilakukan melalui Azure CLI. Saat ini tidak ada pengalaman portal Azure yang setara.

Penyiapan awal

Untuk memulai, buat grup sumber daya dan sumber daya Armada Kube tanpa kluster hub, dan gabungkan kluster AKS yang ada sebagai anggota. Anda harus mengulangi az fleet member create perintah untuk setiap kluster anggota individu yang ingin Anda kaitkan dengan sumber daya armada.

RG=myResourceGroup
LOCATION=eastus
FLEET=myKubernetesFleet
FLEET_MEMBER=<name-identifying-member-cluster>
SUBSCRIPTION_ID=<your-subscription-id>
CLUSTER=<your-aks-cluster-name>

# Create resource group
az group create -n $RG -l $LOCATION

# Create a hubless fleet resource 
az fleet create -g $RG -n $FLEET

# Join member cluster to hubless fleet resource
az fleet member create --name $FLEET_MEMBER --fleet-name $FLEET --resource-group $RG --member-cluster-id /subscriptions/$SUBSCRIPTION_ID/resourceGroups/$RG/providers/Microsoft.ContainerService/managedClusters/$CLUSTER

Tingkatkan jenis kluster hub untuk sumber daya Armada Kubernetes

Untuk meningkatkan jenis kluster hub untuk sumber daya Armada Kubernetes, gunakan az fleet create perintah dengan --enable-hub set bendera. Pastikan untuk menyertakan opsi konfigurasi lain yang relevan, karena sumber daya armada akan menjadi tidak dapat diubah setelah operasi ini selesai.

# Upgrade the Kubernetes fleet resource without a hub cluster to one with a hub cluster
az fleet create --name $FLEET --resource-group $RG --enable-hub 

Memvalidasi peningkatan

Setelah menjalankan az fleet create perintah untuk meningkatkan sumber daya armada, verifikasi bahwa peningkatan berhasil dengan melihat output. harus provisioningState dibaca Succeeded dan hubProfile bidang harus ada. Misalnya, lihat output berikut:

{
  ...
  "hubProfile": {
    "agentProfile": {
      "subnetId": null,
      "vmSize": null
    },
    "apiServerAccessProfile": {
      "enablePrivateCluster": false,
      "enableVnetIntegration": false,
      "subnetId": null
    },
    "dnsPrefix": "contoso-user-xxxx-xxxxxxx",
    "fqdn": "contoso-user-flth-xxxxxx-xxxxxxxx.hcp.eastus.azmk8s.io",
    "kubernetesVersion": "1.28.5",
    "portalFqdn": "contoso-user-flth-xxxxxxx-xxxxxxxx.portal.hcp.eastus.azmk8s.io"
  },
  "provisioningState": "Succeeded"
  ...
}

Bergabung kembali dengan kluster anggota

Untuk bergabung kembali dengan kluster anggota ke sumber daya armada yang baru ditingkatkan, gunakan az fleet member reconcile perintah untuk setiap kluster anggota individu.

az fleet member reconcile -g $RG -f $FLEET -n $FLEET_MEMBER

Catatan

Setiap kluster AKS yang Anda gabungkan ke sumber daya armada untuk pertama kalinya setelah peningkatan dilakukan tidak perlu direkonsiliasi menggunakan az fleet member reconcile.

Verifikasi kluster anggota berhasil bergabung

Untuk setiap kluster anggota yang Anda gabungkan kembali ke armada yang baru ditingkatkan, lihat output dan verifikasi yang provisioningState berbunyi Succeeded. Contohnya:

{
  ...
  "provisioningState": "Succeeded"
  ...
}

Memverifikasi fungsionalitas

Anda memerlukan akses ke API Kubernetes dari kluster hub. Jika Anda tidak memiliki akses, lihat Mengakses API Kubernetes dari sumber daya Armada dengan Azure Kubernetes Fleet Manager.

Untuk memverifikasi bahwa sumber daya Kubernetes Fleet yang baru ditingkatkan berfungsi dengan baik dan kluster anggota berhasil bergabung, konfirmasikan bahwa Anda dapat mengakses server API kluster hub menggunakan perintah .kubectl get memberclusters

Jika berhasil, output Anda akan terlihat mirip dengan contoh output berikut:

NAME           JOINED   AGE
aks-member-1   True     2m
aks-member-2   True     2m
aks-member-3   True     2m

Membersihkan sumber daya

Setelah selesai, Anda dapat menghapus sumber daya armada dan sumber daya terkait dengan menghapus grup sumber daya. Perlu diingat bahwa operasi ini tidak akan menghapus kluster AKS Anda jika berada di grup sumber daya yang berbeda.

az group delete -n $RG

Langkah berikutnya

Sekarang setelah sumber daya Kubernetes Fleet ditingkatkan untuk memiliki kluster hub, Anda dapat memanfaatkan fitur yang sebelumnya tidak tersedia untuk Anda. Misalnya, lihat:

Penyeimbangan beban Lapisan-4 di seluruh kluster anggota Armada