Creare cluster Kubernetes con Bicep
Questo articolo descrive come creare cluster Kubernetes in Locale di Azure usando Bicep. Il flusso di lavoro prevede le fasi seguenti:
- Creare una coppia di chiavi SSH
- Creare un cluster Kubernetes in Locale di Azure, versione 23H2 usando Bicep. Per impostazione predefinita, il cluster è connesso ad Azure Arc.
- Convalidare la distribuzione e connettersi al cluster.
Operazioni preliminari
Prima di iniziare, verificare di aver soddisfatto i prerequisiti seguenti:
Ottenere i dettagli seguenti dall'amministratore dell'infrastruttura locale:
- ID sottoscrizione di Azure: ID sottoscrizione di Azure che usa azure locale per la distribuzione e la registrazione.
- Nome o ID percorso personalizzato: ID di Azure Resource Manager del percorso personalizzato. 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.
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
.Scaricare e installare kubectl nel computer di sviluppo. Lo strumento da riga di comando kubernetes kubectl consente di eseguire comandi nei cluster Kubernetes. È possibile usare kubectl per distribuire applicazioni, esaminare e gestire le risorse del cluster e visualizzare i log.
Creare una coppia di chiavi SSH
Per creare una coppia di chiavi SSH (come il servizio Azure Kubernetes di Azure), seguire questa procedura:
Aprire una sessione di Cloud Shell nel browser o aprire un terminale nel computer locale.
Creare una coppia di chiavi SSH usando
az sshkey create
:az sshkey create --name <Public_SSH_Key> --resource-group <Resource_Group_Name>
In alternativa, creare una coppia di chiavi SSH locale usando
ssh-keygen
:ssh-keygen -t rsa -b 4096
È consigliabile creare una coppia di chiavi SSH in Azure, perché è possibile usarla in un secondo momento per l'accesso al nodo o la risoluzione dei problemi. Per altre informazioni sulla creazione di chiavi SSH, vedere Creare e gestire chiavi SSH per l'autenticazione in Azure e Limitare l'accesso SSH.
Scaricare e aggiornare gli script Bicep
Scarica questi due file dal repository GitHub AKSArc per la distribuzione di Bicep: main.bicep e aksarc.bicepparam. Aggiornare i parametri da aksarc.bicepparam in base alle esigenze e assicurarsi che tutti i valori predefiniti di main.bicep siano corretti.
Il tipo di risorsa Microsoft.HybridContainerService/provisionedClusterInstances è definito in main.bicep. Per personalizzare ulteriori proprietà per la creazione dei cluster, consultare provisionedClusterInstances Riferimento API.
Distribuire i modelli Bicep
Creare una distribuzione Bicep usando l'interfaccia della riga di comando di Azure:
az deployment group create --name BicepDeployment --resource-group <Resource_Group_Name> --parameters aksarc.bicepparam
Convalidare la distribuzione e connettersi al cluster
È ora possibile connettersi al cluster Kubernetes eseguendo 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.
Passaggi successivi
Creare cluster Kubernetes usando l'interfaccia della riga di comando di Azure