Dela via

Snabbstart: Skapa en Azure Kubernetes Fleet Manager-resurs och ansluta medlemskluster med hjälp av Azure CLI

  • Artikel

Kom igång med Azure Kubernetes Fleet Manager (Fleet) med hjälp av Azure CLI för att skapa en fleet-resurs och senare ansluta Azure Kubernetes Service-kluster (AKS) som medlemskluster.

Förutsättningar

Om du inte har en Azure-prenumeration skapar du ett kostnadsfritt Azure-konto innan du börjar.

  • Läs den konceptuella översikten över den här funktionen, som innehåller en förklaring av flottor och medlemskluster som refereras i det här dokumentet.

  • Läs den konceptuella översikten över typer av flottor, som ger en jämförelse av olika konfigurationsalternativ för flottan.

  • Ett Azure-konto med en aktiv prenumeration. Skapa ett konto utan kostnad.

  • En identitet (användaren eller tjänstens huvudnamn) som kan användas för att logga in på Azure CLI. Den här identiteten måste ha följande behörigheter för resurstyperna Fleet och AKS för att slutföra stegen som anges i den här snabbstarten:

    • 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

  • Installera eller uppgradera Azure CLI till version 2.53.1 eller senare.

  • Installera Azure CLI-tillägget för flottan med kommandot az extension add och Kontrollera att din version är minst 1.0.0.

    az extension add --name fleet

  • Ange följande miljövariabler:

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

  • Installera kubectl och kubelogin använda az aks install-cli kommandot .

    az aks install-cli

  • De AKS-kluster som du vill ansluta som medlemskluster till fleet-resursen måste finnas i de versioner av AKS som stöds. Läs mer om stödprinciper för AKS-versioner här.

Skapa en resursgrupp

En Azure-resursgrupp är en logisk grupp där Azure-resurser distribueras och hanteras. När du skapar en resursgrupp uppmanas du att ange en plats. Den här platsen är lagringsplatsen för dina resursgruppsmetadata och där dina resurser körs i Azure om du inte anger någon annan plats när du skapar resurser.

Ange Azure-prenumerationen och skapa en resursgrupp med kommandot az group create .

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

Följande utdataexempel liknar skapandet av resursgruppen:

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

Skapa en fleet-resurs

Du kan skapa en fleet-resurs för att senare gruppera dina AKS-kluster som medlemskluster. När den här resursen skapas via Azure CLI möjliggör den som standard gruppering och uppdateringsorkestrering av medlemskluster. Om fleet-hubben är aktiverad aktiveras andra förhandsgranskningsfunktioner, till exempel Kubernetes-objektspridning till medlemskluster och L4-tjänstbelastningsutjämning över flera medlemskluster. Mer information finns i den konceptuella översikten över typer av flottor, som ger en jämförelse av olika flottkonfigurationer.

Viktigt!

När en Kubernetes Fleet-resurs har skapats är det möjligt att uppgradera en Kubernetes Fleet-resurs utan ett hubbkluster till ett med ett hubbkluster. För Kubernetes Fleet-resurser med ett hubbkluster kan det inte ändras när privat eller offentligt har valts.

Om du bara vill använda Fleet för uppdateringsorkestrering, vilket är standardupplevelsen när du skapar en ny Fleet-resurs via Azure CLI, kan du skapa en Fleet-resurs utan hubbklustret med hjälp av az fleet create kommandot .

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

Dina utdata bör se ut ungefär som följande exempelutdata:

{
  "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"
}

Ansluta till medlemskluster

Fleet stöder för närvarande anslutning till befintliga AKS-kluster som medlemskluster.

  1. Ange följande miljövariabler för medlemskluster:

    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. Anslut dina befintliga AKS-kluster till fleet-resursen med hjälp av az fleet member create kommandot .

    # 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}

    Dina utdata bör se ut ungefär som följande exempelutdata:

    {
  "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. Kontrollera att medlemskluster har anslutits till Fleet-resursen az fleet member list med hjälp av kommandot .

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

    Om det lyckas bör dina utdata se ut ungefär som i följande exempelutdata:

    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>

Nästa steg