Share via

Mulai cepat: Membuat sumber daya Azure Kubernetes Fleet Manager dan bergabung dengan kluster anggota menggunakan Azure CLI

  • Artikel

Mulai menggunakan Azure Kubernetes Fleet Manager (Fleet) dengan menggunakan Azure CLI untuk membuat sumber daya Armada dan kemudian menghubungkan kluster Azure Kubernetes Service (AKS) sebagai kluster anggota.

Prasyarat

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

  • Baca gambaran umum konseptual fitur ini, yang memberikan penjelasan tentang armada dan kluster anggota yang direferensikan dalam dokumen ini.

  • Baca gambaran umum konseptual jenis armada, yang menyediakan perbandingan opsi konfigurasi armada yang berbeda.

  • Akun Azure dengan langganan aktif. Buat akun secara gratis.

  • Identitas (pengguna atau perwakilan layanan) yang dapat digunakan untuk masuk ke Azure CLI. Identitas ini harus memiliki izin berikut pada jenis sumber daya Armada dan AKS untuk menyelesaikan langkah-langkah yang tercantum dalam mulai cepat ini:

    • Microsoft.ContainerService/fleets/read
    • Microsoft.ContainerService/fleets/write
    • Microsoft.ContainerService/fleets/members/read
    • Microsoft.ContainerService/fleets/members/write
    • Microsoft.ContainerService/fleetMemberships/read
    • Microsoft.ContainerService/fleetMemberships/write
    • Microsoft.ContainerService/managedClusters/read
    • Microsoft.ContainerService/managedClusters/write

  • Instal atau tingkatkan Azure CLI ke versi atau yang lebih 2.53.1 baru.

  • Instal ekstensi Fleet Azure CLI menggunakan az extension add perintah dan Pastikan versi Anda setidaknya 1.0.0.

    az extension add --name fleet

  • Atur variabel lingkungan berikut:

    export SUBSCRIPTION_ID=<subscription_id>
export GROUP=<your_resource_group_name>
export FLEET=<your_fleet_name>

  • Instal kubectl dan kubelogin gunakan az aks install-cli perintah .

    az aks install-cli

  • Kluster AKS yang ingin Anda gabungkan sebagai kluster anggota ke sumber daya Armada harus berada dalam versi AKS yang didukung. Pelajari selengkapnya tentang kebijakan dukungan versi AKS di sini.

Buat grup sumber daya

Grup sumber daya Azure adalah grup logis tempat sumber daya Azure disebarkan dan dikelola. Saat membuat grup sumber daya, Anda diminta untuk menentukan lokasi. Lokasi ini adalah lokasi penyimpanan metadata grup sumber daya Anda dan tempat sumber daya Anda berjalan di Azure jika Anda tidak menentukan lokasi lain selama pembuatan sumber daya.

Atur langganan Azure dan buat grup sumber daya menggunakan az group create perintah .

az account set -s ${SUBSCRIPTION_ID}
az group create --name ${GROUP} --location eastus

Contoh output berikut ini menyerupai pembuatan grup sumber daya yang berhasil:

{
  "id": "/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/fleet-demo",
  "location": "eastus",
  "managedBy": null,
  "name": "fleet-demo",
  "properties": {
    "provisioningState": "Succeeded"
  },
  "tags": null,
  "type": "Microsoft.Resources/resourceGroups"
}

Membuat sumber daya Armada

Anda dapat membuat sumber daya Armada untuk mengelompokkan kluster AKS Anda nanti sebagai kluster anggota. Saat dibuat melalui Azure CLI, secara default, sumber daya ini memungkinkan pengelompokan kluster anggota dan memperbarui orkestrasi. Jika hub Armada diaktifkan, fitur pratinjau lainnya diaktifkan, seperti penyebaran objek Kubernetes ke kluster anggota dan penyeimbangan beban layanan L4 di beberapa kluster anggota. Untuk informasi selengkapnya, lihat gambaran umum konseptual jenis armada, yang menyediakan perbandingan konfigurasi armada yang berbeda.

Penting

Setelah sumber daya Armada Kubernetes dibuat, dimungkinkan untuk meningkatkan sumber daya Armada Kubernetes tanpa kluster hub ke satu dengan kluster hub. Untuk sumber daya Armada Kubernetes dengan kluster hub, setelah privat atau publik dipilih, sumber daya tersebut tidak dapat diubah.

Jika Anda ingin menggunakan Armada hanya untuk memperbarui orkestrasi, yang merupakan pengalaman default saat membuat sumber daya Armada baru melalui Azure CLI, Anda dapat membuat sumber daya Armada tanpa kluster hub menggunakan az fleet create perintah .

az fleet create --resource-group ${GROUP} --name ${FLEET} --location eastus

Output Anda akan terlihat mirip dengan contoh output berikut:

{
  "etag": "...",
  "hubProfile": null,
  "id": "/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/fleet-demo/providers/Microsoft.ContainerService/fleets/fleet-demo",
  "identity": {
    "principalId": null,
    "tenantId": null,
    "type": "None",
    "userAssignedIdentities": null
  },
  "location": "eastus",
  "name": "fleet-demo",
  "provisioningState": "Succeeded",
  "resourceGroup": "fleet-demo",
  "systemData": {
    "createdAt": "2023-11-03T17:15:19.610149+00:00",
    "createdBy": "<user>",
    "createdByType": "User",
    "lastModifiedAt": "2023-11-03T17:15:19.610149+00:00",
    "lastModifiedBy": "<user>",
    "lastModifiedByType": "User"
  },
  "tags": null,
  "type": "Microsoft.ContainerService/fleets"
}

Bergabung dengan kluster anggota

Armada saat ini mendukung penggabungan kluster AKS yang ada sebagai kluster anggota.

  1. Atur variabel lingkungan berikut untuk kluster anggota:

    export MEMBER_NAME_1=aks-member-1
export MEMBER_CLUSTER_ID_1=/subscriptions/${SUBSCRIPTION_ID}/resourceGroups/${GROUP}/providers/Microsoft.ContainerService/managedClusters/${MEMBER_NAME_1}

  2. Gabungkan kluster AKS yang ada ke sumber daya Armada menggunakan az fleet member create perintah .

    # Join the first member cluster
az fleet member create --resource-group ${GROUP} --fleet-name ${FLEET} --name ${MEMBER_NAME_1} --member-cluster-id ${MEMBER_CLUSTER_ID_1}

    Output Anda akan terlihat mirip dengan contoh output berikut:

    {
  "clusterResourceId": "/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<GROUP>/providers/Microsoft.ContainerService/managedClusters/aks-member-x",
  "etag": "...",
  "id": "/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<GROUP>/providers/Microsoft.ContainerService/fleets/<FLEET>/members/aks-member-x",
  "name": "aks-member-1",
  "provisioningState": "Succeeded",
  "resourceGroup": "<GROUP>",
  "systemData": {
    "createdAt": "2022-10-04T19:04:56.455813+00:00",
    "createdBy": "<user>",
    "createdByType": "User",
    "lastModifiedAt": "2022-10-04T19:04:56.455813+00:00",
    "lastModifiedBy": "<user>",
    "lastModifiedByType": "User"
  },
  "type": "Microsoft.ContainerService/fleets/members"
}

  3. Verifikasi bahwa kluster anggota berhasil bergabung dengan sumber daya Armada menggunakan az fleet member list perintah .

    az fleet member list --resource-group ${GROUP} --fleet-name ${FLEET} -o table

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

    ClusterResourceId                                                                                                                                Name          ProvisioningState    ResourceGroup
-----------------------------------------------------------------------------------------------------------------------------------------------  ------------  -------------------  ---------------
/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<GROUP>/providers/Microsoft.ContainerService/managedClusters/aks-member-1  aks-member-1  Succeeded            <GROUP>
/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<GROUP>/providers/Microsoft.ContainerService/managedClusters/aks-member-2  aks-member-2  Succeeded            <GROUP>
/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<GROUP>/providers/Microsoft.ContainerService/managedClusters/aks-member-3  aks-member-3  Succeeded            <GROUP>

Langkah berikutnya