Avvio rapido: creare una risorsa di Gestione flotta Kubernetes di Azure e aggiungere cluster di membri usando l'interfaccia della riga di comando di Azure

Articolo
10/15/2024

Introduzione a Gestione flotta Kubernetes di Azure (Flotta) usando l'interfaccia della riga di comando di Azure per creare una risorsa Flotta e successivamente connettere cluster del Servizio Azure Kubernetes (AKS) come cluster di membri.

Prerequisiti

Se non si ha una sottoscrizione di Azure, creare un account Azure gratuito prima di iniziare.

Leggere la panoramica concettuale di questa funzionalità, che fornisce una spiegazione delle flotta e dei cluster di membri a cui si fa riferimento in questo documento.
Leggere la panoramica concettuale dei tipi diflotta, che fornisce un confronto tra diverse opzioni di configurazione della flotta.
Un account Azure con una sottoscrizione attiva. Creare un account gratuitamente.
Identità (utente o entità servizio) che può essere usata per accedere all'interfaccia della riga di comando di Azure. Questa identità deve avere le autorizzazioni seguenti per i tipi di risorse Flotta e Servizio Azure Kubernetes per completare i passaggi elencati in questa guido avvio rapido:
- 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
Installare o aggiornare l'interfaccia della riga di comando di Azure alla versione 2.53.1 o successiva.
Installare l'estensione dell'interfaccia della riga di comando di Azure flotta usando il comando az extension add e assicurarsi che la versione sia almeno 1.0.0.
```
az extension add --name fleet
```

Impostare le seguenti variabili di ambiente:

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

Installare kubectl e kubelogin usando il comando az aks install-cli.
```
az aks install-cli
```
I cluster del Servizio Azure Kubernetes da aggiungere come cluster di membri alla risorsa Flotta devono trovarsi nelle versioni supportate del servizio Azure Kubernetes. Altre informazioni sui criteri di supporto della versione del Servizio Azure Kubernetes sono disponibili qui.

Creare un gruppo di risorse

Un gruppo di risorse di Azure è un gruppo logico in cui le risorse di Azure vengono distribuite e gestite. Quando si crea un gruppo di risorse, viene richiesto di specificare una posizione. Questa posizione è la posizione di archiviazione dei metadati del gruppo di risorse e dove le risorse vengono eseguite in Azure se non si specifica un altro percorso durante la creazione della risorsa.

Impostare la sottoscrizione di Azure e creare un gruppo di risorse usando il comando az group create.

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

L'esempio di output seguente è simile alla corretta creazione del gruppo di risorse:

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

Creare una risorsa Flotta

È possibile creare una risorsa Flotta per raggruppare in un secondo momento i cluster del Servizio Azure Kubernetes come cluster di membri. Quando viene creata tramite l'interfaccia della riga di comando di Azure, per impostazione predefinita, questa risorsa abilita il raggruppamento e l'orchestrazione degli aggiornamenti dei cluster di membri. Se l'hub Flotta è abilitato, sono abilitate altre funzionalità di anteprima, ad esempio la propagazione degli oggetti Kubernetes nei cluster di membri e il bilanciamento del carico del servizio L4 tra più cluster di membri. Per altre informazioni, vedere la panoramica concettuale dei tipi di flotta, che fornisce un confronto tra diverse configurazioni della flotta.

Importante

Dopo aver creato una risorsa Flotta di Kubernetes, è possibile aggiornare una risorsa Flotta di Kubernetes senza un cluster di hub a uno con un cluster di hub. Per le risorse della flotta Kubernetes con un cluster di hub, una volta selezionata, non è possibile modificare la selezione privata o pubblica.

Risorsa della flotta Kubernetes senza cluster di hub
Risorsa flotta Kubernetes con cluster di hub

Se si desidera usare Flotta solo per l'orchestrazione degli aggiornamenti, ovvero l'esperienza predefinita durante la creazione di una nuova risorsa Flotta tramite l'interfaccia della riga di comando di Azure, è possibile creare una risorsa Flotta senza il cluster di hub usando il comando az fleet create.

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

L'output dovrebbe essere simile all'esempio di output seguente:

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

Se si desidera usare Flotta per la propagazione degli oggetti Kubernetes e il bilanciamento del carico multi-cluster oltre all'orchestrazione degli aggiornamenti, è necessario creare la risorsa Flotta con il cluster di hub abilitato specificando il parametro --enable-hubcon il comando az fleet create.

I cluster Flotta Kubernetes con un cluster di hub supportano sia le modalità pubbliche che private per l'accesso alla rete. Per altre informazioni, vedere [Scegliere un'opzione di Gestione flotta Kubernetes di Azure](./concepts-choosing-fleet.md#network-access-modes-for-hub-cluster.

Nota

Per impostazione predefinita, le risorse Flotta Kubernetes con cluster di hub sono pubbliche e Flotta sceglierà lo SKU VM usato per il nodo hub (al momento prova "Standard_D4s_v4", "Standard_D4s_v3", "Standard_D4s_v5", "Standard_Ds3_v2", "Standard_E4as_v4" secondo quest'ordine). Se nessuna di queste opzioni è accettabile o disponibile, è possibile selezionare uno SKU VM impostando --vm-size <SKU>.

cluster di hub pubblico

Per creare una risorsa Flotta Kubernetes pubblica con un cluster di hub, usare il comando az fleet create con il flag --enable-hub impostato.

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

L'output dovrebbe essere simile all'esempio di output seguente:

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

cluster di hub privato

Quando si crea una risorsa Flotta Kubernetes in modalità di accesso privato con un cluster di hub, si applicano alcune considerazioni aggiuntive:

Flotta richiede di specificare la subnet in cui verranno posizionate le macchine virtuali del nodo del cluster dell'hub Flotta. È possibile specificare questo valore in fase di creazione impostando --agent-subnet-id <subnet>. Questo comando è diverso da quello usato per lavorare direttamente con un cluster del Servizio Azure Kubernetes privato in quanto è un argomento obbligatorio per Flotta, ma non per il servizio Azure Kubernetes.
Il prefisso dell'indirizzo della rete virtuale la cui subnet viene passata tramite --vnet-subnet-id non deve sovrapporsi all'intervallo di servizi predefinito del servizio del Servizio Azure Kubernetes di 10.0.0.0/16.
Quando si usa un cluster privato del servizio Azure Kubernetes, è possibile configurare nomi di dominio completi (FQDN) e sottodomini FQDN. Questa funzionalità non si applica al cluster di hub del tipo con modalità di accesso privato.

Creare prima di tutto una rete virtuale e una subnet per le VM del nodo del cluster di hub usando i comandi az network vnet create e az network vnet subnet create.

az network vnet create --resource-group ${GROUP} --name vnet --address-prefixes 192.168.0.0/16
az network vnet subnet create --resource-group ${GROUP} --vnet-name vnet --name subnet --address-prefixes 192.168.0.0/24

SUBNET_ID=$(az network vnet subnet show --resource-group ${GROUP} --vnet-name vnet -n subnet -o tsv --query id)

Per creare una risorsa Flotta Kubernetes in modalità di accesso privato, usare il az fleet createcomando con il flag --enable-private-cluster e specificare l'ID subnet ottenuto nel passaggio precedente all'argomento --agent-subnet-id <subnet>.

az fleet create --resource-group ${GROUP} --name ${FLEET} --enable-hub --enable-private-cluster --agent-subnet-id "${SUBNET_ID}"

Aggiungere cluster di membri

Flotta supporta attualmente l'aggiunta di cluster del Servizio Azure Kubernetes esistenti come cluster di membri.

Impostare le variabili di ambiente seguenti per i cluster di membri:

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

Aggiungere i cluster del Servizio Azure Kubernetes esistenti alla risorsa Flotta usando il comando az fleet member create.

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

L'output dovrebbe essere simile all'esempio di output seguente:

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

Verificare che i cluster di membri siano stati aggiunti correttamente alla risorsa Flotta usando il comando az fleet member list.

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

Se funziona, l'output dovrebbe essere simile all'output di esempio seguente:

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>

Passaggi successivi

API Kubernetes del cluster hub di Access Fleet.

Condividi tramite

Avvio rapido: creare una risorsa di Gestione flotta Kubernetes di Azure e aggiungere cluster di membri usando l'interfaccia della riga di comando di Azure

Prerequisiti

Creare un gruppo di risorse

Creare una risorsa Flotta

cluster di hub pubblico

cluster di hub privato

Aggiungere cluster di membri

Passaggi successivi

Risorse aggiuntive