Guida introduttiva: Distribuire un cluster Kubernetes usando un modello di Azure Resource Manager

Si applica a: AKS locale su Azure

Questa guida introduttiva illustra come distribuire un cluster Kubernetes in Azure Kubernetes Service (AKS) Arc usando un modello di Azure Resource Manager (ARM template). Azure Arc estende le funzionalità di gestione di Azure ai cluster Kubernetes ovunque, offrendo un approccio unificato alla gestione di ambienti diversi.

Operazioni preliminari

Questo articolo presuppone una conoscenza di base dei concetti relativi a Kubernetes.

Per distribuire un modello di Resource Manager di ARM, è necessario avere l'accesso in scrittura alle risorse che si stanno distribuendo, e avere accesso a tutte le operazioni sul tipo di risorsa Microsoft.Resources/deployments. Ad esempio, per distribuire una macchina virtuale, sono necessarie le autorizzazioni Microsoft.Compute/virtualMachines/write e Microsoft.Resources/deployments/*. Per un elenco dei ruoli e delle autorizzazioni, vedere Ruoli predefiniti di Azure.

Prerequisiti

Passaggio 1: Preparare l'account Azure

  1. Accedere ad Azure: aprire il terminale o il prompt dei comandi e accedere all'account Azure usando l'interfaccia della riga di comando di Azure:

    az login

  2. Impostare la sottoscrizione: sostituire <your-subscription-id> con l'ID sottoscrizione:

    az account set --subscription "<your-subscription-id>"

Passaggio 2: Creare una coppia di chiavi SSH

Creare una coppia di chiavi SSH in Azure e archiviare il file di chiave privata per la risoluzione dei problemi e la raccolta dei log. Per istruzioni dettagliate, vedere Configurare le chiavi SSH per un cluster del servizio Azure Kubernetes per creare chiavi SSH o usare Limitare l'accesso SSH durante la creazione del cluster. Per accedere ai nodi in un secondo momento, vedere Connettersi ai nodi di lavoro Windows o Linux con SSH.

  1. Aprire una sessione di Cloud Shell nel Web browser o avviare un terminale nel computer locale.

  2. Creare una coppia di chiavi SSH usando il comando az sshkey create:

    az sshkey create --name "mySSHKey" --resource-group $<resource_group_name>

    in alternativa, usare il comando ssh-keygen:

    ssh-keygen -t rsa -b 4096

  3. Recuperare il valore della chiave pubblica da Azure o dal computer locale in /.ssh/id_rsa.pub.

Passaggio 3: Distribuire il cluster usando i modelli ARM

Per istruzioni dettagliate sulla distribuzione di un cluster AKS Arc tramite modelli ARM, vedere il repository dei modelli di distribuzione AKSArc. Il repository contiene:

  • CreateWithExistingLnet: distribuire un cluster usando una rete logica esistente.
  • CreateWithoutExistingLnet: distribuire un cluster e creare una nuova rete logica.
  • Completare le istruzioni e gli esempi di distribuzione.
  • Modelli di file di parametri.

Per distribuire il cluster, seguire le istruzioni nel file README del repository.

Passaggio 4: Connettersi al cluster

  1. Per connettersi al cluster, eseguire il comando az connectedk8s proxy . Il comando scarica ed esegue un file binario proxy nel computer client e recupera un kubeconfig file associato al cluster.

    az connectedk8s proxy --name <cluster name> -g <resource group>

    In alternativa, usare il client della riga di comando Kubernetes, kubectl. Se si usa Azure Cloud Shell, kubectl è già installato. Per installare ed eseguire kubectl localmente, eseguire az-aks-install-cli o scaricare dal sito Web Kubernetes .

    Configurare kubectl per connettersi al cluster Kubernetes usando il comando az aksarc get-credentials. Questo comando scarica le credenziali e configura l'interfaccia della riga di comando di Kubernetes per l'uso delle credenziali.

    az aksarc get-credentials --resource-group "<resource-group-name>" --name "<cluster-name>"

  2. Verificare la connessione al cluster usando il comando kubectl get. Questo comando restituisce un elenco dei nodi del cluster.

    kubectl get nodes -A --kubeconfig .\<path to kubecofig>

    L'output di esempio seguente mostra i tre nodi creati nei passaggi precedenti. Verificare che lo stato del nodo sia Ready.

    NAME                                STATUS   ROLES   AGE   VERSION
aks-agentpool-27442051-vmss000000   Ready    agent   10m   v1.27.7
aks-agentpool-27442051-vmss000001   Ready    agent   10m   v1.27.7
aks-agentpool-27442051-vmss000002   Ready    agent   11m   v1.27.7

Distribuire pool di nodi (facoltativo)

Per aggiungere altri pool di nodi al cluster usando i modelli ARM, vedere il modello ARM per distribuire/aggiornare un pool di nodi AKS Arc. Il repository include istruzioni complete per la distribuzione e la gestione dei pool di nodi.

Contenuti correlati

Panoramica di Azure Kubernetes Service (AKS) Arc.

  • Last updated on