Esercitazione - Creare un cluster del servizio Azure Kubernetes

Questa esercitazione richiede l'interfaccia della riga di comando di Azure 2.0.53 o versioni successive. Controllare la versione con az --version. Per installare o eseguire l'aggiornamento, vedere Installare l'interfaccia della riga di comando di Azure.

Questa esercitazione richiede il modulo Azure PowerShell 5.9.0 o versioni successive. Controllare la versione con Get-InstalledModule -Name Az. Per eseguire l'installazione o l'aggiornamento, vedere Installare Azure PowerShell.

Questa esercitazione richiede Azure Developer CLI 1.5.1 o versioni successive. Controllare la versione con azd version. Per eseguire l'installazione o l'aggiornamento, vedere Installare Azure Developer CLI.

• Eseguire l'installazione kubectl in locale usando il az aks install-cli comando.

  az aks install-cli
  

• Eseguire l'installazione kubectl in locale usando il Install-AzAksCliTool cmdlet.

  Install-AzAksCliTool
  

Gli ambienti azd in uno spazio di codice scaricano automaticamente tutte le dipendenze trovate in ./devcontainer/devcontainer.json. Sono incluse l'interfaccia della riga di comando di Kubernetes insieme a qualsiasi immagine del Registro Azure Container.

• Per installare kubectl in locale, usare il comando az aks install-cli.

  az aks install-cli
  

Per consentire a un cluster del servizio Azure Kubernetes di interagire con altre risorse di Azure, la piattaforma Azure crea automaticamente un'identità del cluster. In questo esempio, all'identità del cluster viene concesso il diritto di eseguire lo spostamento delle immagini dall'istanza di Registro Azure Container creata nell'esercitazione precedente. Per eseguire correttamente il comando, è necessario avere un ruolo diproprietario o amministratore dell'account Azure nella sottoscrizione di Azure.

• Creare un cluster del servizio Azure Kubernetes usando il comando az aks create. L'esempio seguente crea un cluster denominato myAKSCluster nel gruppo di risorse denominato myResourceGroup. Questo gruppo di risorse è stato creato nell'area eastus durante l'esercitazione precedente. Si continuerà a usare la variabile di ambiente, $ACRNAME, impostata nell'esercitazione precedente. Se questa variabile di ambiente non è impostata, impostarla ora sullo stesso valore usato in precedenza.

  az aks create \
      --resource-group myResourceGroup \
      --name myAKSCluster \
      --node-count 2 \
      --generate-ssh-keys \
      --attach-acr $ACRNAME
  

  Nota

  Se sono già state generate chiavi SSH, è possibile che si verifichi un errore simile a linuxProfile.ssh.publicKeys.keyData is invalid. Per continuare, ripetere il comando senza il --generate-ssh-keys parametro.

Si può ovviare alla necessità di avere un ruolo diproprietario o amministratore dell’account Azure configurando manualmente un'entità servizio per eseguire lo spostamento delle immagini dal Registro Azure Container. Per altre informazioni, vedere Autenticazione al Registro Azure Container con entità servizio o Eseguire l'autenticazione da Kubernetes con un segreto per il pull. In alternativa, per una gestione più semplice, è possibile usare un'identità gestita anziché un'entità servizio.

Per consentire a un cluster del servizio Azure Kubernetes di interagire con altre risorse di Azure, la piattaforma Azure crea automaticamente un'identità del cluster. In questo esempio, all'identità del cluster viene concesso il diritto di eseguire lo spostamento delle immagini dall'istanza di Registro Azure Container creata nell'esercitazione precedente. Per eseguire correttamente il comando, è necessario avere un ruolo diproprietario o amministratore dell'account Azure nella sottoscrizione di Azure.

• Creare un cluster del servizio Azure Kubernetes usando il New-AzAksCluster cmdlet. L'esempio seguente crea un cluster denominato myAKSCluster nel gruppo di risorse denominato myResourceGroup. Questo gruppo di risorse è stato creato nell'area eastus durante l'esercitazione precedente.

  New-AzAksCluster -ResourceGroupName myResourceGroup -Name myAKSCluster -NodeCount 2 -GenerateSshKey -AcrNameToAttach $ACRNAME
  

  Nota

  Se sono già state generate chiavi SSH, è possibile che si verifichi un errore simile a linuxProfile.ssh.publicKeys.keyData is invalid. Per continuare, ripetere il comando senza il -GenerateSshKey parametro.

Si può ovviare alla necessità di avere un ruolo diproprietario o amministratore dell’account Azure configurando manualmente un'entità servizio per eseguire lo spostamento delle immagini dal Registro Azure Container. Per altre informazioni, vedere Autenticazione al Registro Azure Container con entità servizio o Eseguire l'autenticazione da Kubernetes con un segreto per il pull. In alternativa, per una gestione più semplice, è possibile usare un'identità gestita anziché un'entità servizio.

azd crea un pacchetto della distribuzione dei cluster con l'applicazione stessa usando il comando azd up. Questo comando è illustrato nell'esercitazione successiva.

1. Configurare kubectl per connettersi al cluster Kubernetes usando il comando az aks get-credentials. L'esempio seguente ottiene le credenziali per il cluster AKS denominato myAKSCluster in myResourceGroup.

   az aks get-credentials --resource-group myResourceGroup --name myAKSCluster
   

2. Verificare la connessione al cluster usando il comando kubectl get nodes, da cui si ottiene un elenco dei nodi del cluster.

   kubectl get nodes
   

   L'output di esempio seguente mostra un elenco dei nodi del cluster.

   NAME                                STATUS   ROLES   AGE   VERSION
   aks-nodepool1-19366578-vmss000000   Ready    agent   47h   v1.28.9
   aks-nodepool1-19366578-vmss000001   Ready    agent   47h   v1.28.9
   

1. Configurare kubectl per connettersi al cluster Kubernetes usando cmdlet Import-AzAksCredential. L'esempio seguente ottiene le credenziali per il cluster AKS denominato myAKSCluster in myResourceGroup.

   Import-AzAksCredential -ResourceGroupName myResourceGroup -Name myAKSCluster
   

2. Verificare la connessione al cluster usando il comando kubectl get nodes, da cui si ottiene un elenco dei nodi del cluster.

   kubectl get nodes
   

   L'output di esempio seguente mostra un elenco dei nodi del cluster.

   NAME                                STATUS   ROLES   AGE   VERSION
   aks-nodepool1-19366578-vmss000000   Ready    agent   47h   v1.28.9
   aks-nodepool1-19366578-vmss000001   Ready    agent   47h   v1.28.9
   

1. Configurare l'autenticazione per il cluster usando il comando azd auth login.

   azd auth login 
   

2. Seguire le istruzioni per il metodo di autenticazione.

3. Verificare la connessione al cluster usando il comando kubectl get nodes.

   kubectl get nodes
   

   L'output di esempio seguente mostra un elenco dei nodi del cluster

   NAME                                STATUS   ROLES   AGE   VERSION
   aks-nodepool1-19366578-vmss000000   Ready    agent   47h   v1.28.9
   aks-nodepool1-19366578-vmss000001   Ready    agent   47h   v1.28.9
   

Soluzione alternativa azd auth

Questa soluzione alternativa richiede l'installazione dell'interfaccia della riga di comando di Azure.

1. Aprire una finestra del terminale e accedere con l'interfaccia della riga di comando di Azure usando il comando az login con il parametro --scope impostato su https://graph.microsoft.com/.default.

   az login --scope https://graph.microsoft.com/.default
   

   Si dovrebbe essere reindirizzati a una pagina di autenticazione in una nuova scheda per creare un token di accesso al browser, come nell'esempio seguente:

   https://login.microsoftonline.com/organizations/oauth2/v2.0/authorize?clientid=<your_client_id>.
   

2. Copiare l'URL localhost della pagina Web ricevuta dopo il tentativo di accesso con azd auth login.

3. In una nuova finestra del terminale usare la seguente richiesta curl per accedere. Assicurarsi di sostituire il segnaposto <localhost> con l'URL localhost copiato nel passaggio precedente.

   curl <localhost>
   

   Un account di accesso riuscito restituisce una pagina Web HTML, come nell'esempio seguente:

   <!DOCTYPE html>
   <html>
   <head>
       <meta charset="utf-8" />
       <meta http-equiv="refresh" content="60;url=https://docs.microsoft.com/cli/azure/">
       <title>Login successfully</title>
       <style>
           body {
               font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;
           }
   
           code {
               font-family: Consolas, 'Liberation Mono', Menlo, Courier, monospace;
               display: inline-block;
               background-color: rgb(242, 242, 242);
               padding: 12px 16px;
               margin: 8px 0px;
           }
       </style>
   </head>
   <body>
       <h3>You have logged into Microsoft Azure!</h3>
       <p>You can close this window, or we will redirect you to the <a href="https://docs.microsoft.com/cli/azure/">Azure CLI documentation</a> in 1 minute.</p>
       <h3>Announcements</h3>
       <p>[Windows only] Azure CLI is collecting feedback on using the <a href="https://video2.skills-academy.com/windows/uwp/security/web-account-manager">Web Account Manager</a> (WAM) broker for the login experience.</p>
       <p>You may opt-in to use WAM by running the following commands:</p>
       <code>
           az config set core.allow_broker=true<br>
           az account clear<br>
           az login
       </code>
   </body>
   </html>
   

4. Chiudere il terminale corrente e aprire il terminale originale. Verrà visualizzato un elenco JSON delle sottoscrizioni.

5. Copiare il campo id della sottoscrizione da usare.

6. Impostare la sottoscrizione usando il comando az account set.

   az account set --subscription <subscription_id>