Creare cluster Kubernetes utilizzando Bicep

Questo articolo descrive come creare cluster Kubernetes in Locale di Azure usando Bicep. Il flusso di lavoro crea una coppia di chiavi SSH e crea un cluster Kubernetes in Locale di Azure usando Bicep. Per impostazione predefinita, il cluster è connesso ad Azure Arc. Convalidare quindi la distribuzione e connettersi al cluster.

Operazioni preliminari

Prima di iniziare, verificare di aver soddisfatto i prerequisiti seguenti:

  1. Ottenere i dettagli seguenti dall'amministratore dell'infrastruttura locale:

    • ID Sottoscrizione di Azure: l'ID Sottoscrizione di Azure che utilizza Azure Locale per la distribuzione e la registrazione.
    • Nome o ID della localizzazione personalizzata: ID di Azure Resource Manager della localizzazione personalizzata. Il percorso personalizzato viene configurato durante la distribuzione del cluster locale di Azure. L'amministratore dell'infrastruttura deve fornire l'ID Resource Manager della posizione personalizzata. Questo parametro è obbligatorio per creare cluster Kubernetes. È anche possibile ottenere l'ID di Resource Manager usando az customlocation show --name "<custom location name>" --resource-group <azure resource group> --query "id" -o tsv, se l'amministratore dell'infrastruttura fornisce un nome di percorso personalizzato e un nome del gruppo di risorse.
    • Nome o ID rete logica: ID di Azure Resource Manager della rete logica locale di Azure creata seguendo questa procedura. L'amministratore deve fornire l'ID della rete logica. Questo parametro è obbligatorio per creare cluster Kubernetes. È anche possibile ottenere l'ID di Azure Resource Manager usando az stack-hci-vm network lnet show --name "<lnet name>" --resource-group <azure resource group> --query "id" -o tsv se si conosce il gruppo di risorse in cui è stata creata la rete logica.
  2. Assicurarsi di avere la versione più recente dell'interfaccia della riga di comando di Azure nel computer di sviluppo. È anche possibile aggiornare la versione dell'interfaccia della riga di comando di Azure usando az upgrade.

  3. Scaricare e installare lo strumento da riga di comando Kubernetes sul kubectl computer di sviluppo. È possibile usare az-aks-install-cli o il sito Web Kubernetes . Usare kubectl per eseguire comandi nei cluster Kubernetes, distribuire applicazioni, esaminare e gestire le risorse del cluster e visualizzare i log.

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.

Distribuire il cluster usando modelli Bicep

Per istruzioni dettagliate sulla distribuzione di un cluster del servizio Azure Kubernetes con modelli di Bicep, vedere il repository dei modelli di distribuzione del servizio Azure KubernetesArc Bicep. Il repository include:

  • 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.

Connettersi al cluster

Dopo la distribuzione, è possibile connettersi al cluster Kubernetes eseguendo il az connectedk8s proxy comando dal computer di sviluppo. È anche possibile usare kubectl per visualizzare lo stato del nodo e del pod. Seguire la stessa procedura descritta in Connettersi al cluster Kubernetes.

Distribuire pool di nodi (facoltativo)

Per aggiungere altri pool di nodi al cluster usando modelli di Bicep, vedere il modello di Bicep per distribuire/aggiornare un pool di nodi del servizio Azure Kubernetes. Il repository include istruzioni complete per la distribuzione e la gestione dei pool di nodi.

Creare cluster Kubernetes usando l'interfaccia della riga di comando di Azure.