Guida introduttiva: Creare un cluster automatizzato di Servizio Azure Kubernetes (AKS)

Si applica a: ✔️ AKS Automatico

Servizio Azure Kubernetes (AKS) Automatic è un'esperienza Kubernetes gestita che automatizza la configurazione e le operazioni del cluster del servizio Azure Kubernetes e incorpora le configurazioni delle procedure consigliate. Il servizio AKS Automatic include anche un [SLA per la prontezza dei pod][azure-sla] che garantisce il 99,9% delle operazioni di prontezza dei pod qualificate completate entro 5 minuti, garantendo un'infrastruttura affidabile e auto-riparante per le applicazioni. In questa guida introduttiva si apprende come:

• Distribuire un cluster del Servizio Azure Kubernetes automatico.
• Eseguire un'applicazione multi-contenitore di esempio con un gruppo di microservizi e front-end web, simulando uno scenario di vendita al dettaglio.

Prima di iniziare

• Questa guida introduttiva presuppone una comprensione di base dei concetti relativi a Kubernetes. Per altre informazioni, vedere concetti di base di Kubernetes per Servizio Azure Kubernetes (AKS).
• Automatic AKS abilita Criteri di Azure nel cluster AKS, ma è necessario preregistrare il provider di risorse Microsoft.PolicyInsights nella sottoscrizione. Per altre informazioni, vedere Azure provider di risorse e tipi.

Limitazioni

• Il sistema del pool di nodi dei cluster automatici di AKS richiede la distribuzione in aree Azure che supportano almeno tre zone di disponibilità, dischi OS effimeri e sistema operativo Azure Linux.
• È possibile creare cluster del servizio Azure Kubernetes automatico solo nelle aree in cui Integrazione rete virtuale per il server API è disponibile a livello generale.
• Il cluster automatico AKS ha lockdown del gruppo di risorse nodo preconfigurato, il che non consente modifiche al gruppo di risorse MC_, impedendo i collegamenti rete virtuale (VNet) nella zona DNS privato predefinita. Per scenari DNS tra VNet o scenari DNS personalizzati, usare BYO VNET e BYO DNS privato seguendo il documento 'Creare un cluster privato Servizio Azure Kubernetes (AKS) Automatico in una rete virtuale personalizzata'.

az group create --name myResourceGroup --location eastus

{
  "id": "/subscriptions/<guid>/resourceGroups/myResourceGroup",
  "location": "eastus",
  "managedBy": null,
  "name": "myResourceGroup",
  "properties": {
    "provisioningState": "Succeeded"
  },
  "tags": null
}

az aks create \
    --resource-group myResourceGroup \
    --name myAKSAutomaticCluster \
    --sku automatic

@description('The name of the managed cluster resource.')
param clusterName string = 'myAKSAutomaticCluster'

@description('The location of the managed cluster resource.')
param location string = resourceGroup().location

resource aks 'Microsoft.ContainerService/managedClusters@2024-03-02-preview' = {
  name: clusterName
  location: location  
  sku: {
  name: 'Automatic'
  }
  properties: {
    agentPoolProfiles: [
      {
        name: 'systempool'
        mode: 'System'
  count: 3
      }
    ]
  }
  identity: {
    type: 'SystemAssigned'
  }
}

Connettersi al cluster

Per gestire un cluster Kubernetes, usare il client da riga di comando kubernetes kubectl. kubectl è già installato se si usa Azure Cloud Shell. È possibile eseguire l'installazione kubectl in locale usando il az aks install-cli comando . I cluster automatici di AKS sono configurati con Microsoft Entra ID per il controllo degli accessi basato sui ruoli (RBAC) di Kubernetes.

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

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

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

   kubectl get nodes
   

   L'output di esempio seguente mostra come viene richiesto di accedere:

   To sign in, use a web browser to open the page https://microsoft.com/devicelogin and enter the code AAAAAAAAA to authenticate.
   

   Dopo l'accesso, l'output di esempio seguente mostra i pool di nodi di sistema gestiti. Assicurarsi che lo stato del nodo sia Pronto.

   NAME                                STATUS   ROLES   AGE     VERSION
   aks-nodepool1-12345678-vmss000000   Ready    agent   2m26s   v1.28.5
   aks-nodepool1-12345678-vmss000001   Ready    agent   2m26s   v1.28.5
   aks-nodepool1-12345678-vmss000002   Ready    agent   2m26s   v1.28.5
   

Distribuire l'applicazione

Per distribuire l'applicazione, usare un file manifesto per creare tutti gli oggetti necessari per eseguire l'applicazione AKS Store. Un file manifesto Kubernetes definisce lo stato desiderato di un cluster, ad esempio le immagini del contenitore da eseguire. Il manifesto include le distribuzioni e i servizi Kubernetes seguenti:

• Front-store: applicazione Web per i clienti per visualizzare i prodotti ed effettuare ordini.
• Servizio prodotto: mostra le informazioni sul prodotto.
• Servizio ordini: effettua ordini.
• Rabbit MQ: coda di messaggi per una coda di ordini.

1. Creare uno spazio dei nomi aks-store-demo in cui distribuire le risorse Kubernetes.

   kubectl create ns aks-store-demo
   

2. Distribuire l'applicazione usando il comando kubectl applynello spazio dei nomi aks-store-demo. Il file YAML che definisce la distribuzione è in GitHub.

   kubectl apply -n aks-store-demo -f https://raw.githubusercontent.com/Azure-Samples/aks-store-demo/main/aks-store-ingress-quickstart.yaml
   

   L'output di esempio seguente mostra le distribuzioni e i servizi:

   statefulset.apps/rabbitmq created
   configmap/rabbitmq-enabled-plugins created
   service/rabbitmq created
   deployment.apps/order-service created
   service/order-service created
   deployment.apps/product-service created
   service/product-service created
   deployment.apps/store-front created
   service/store-front created
   ingress/store-front created
   

Testare l'applicazione

Durante l'esecuzione dell'applicazione, un servizio Kubernetes espone il front-end dell'applicazione a Internet. Il processo potrebbe richiedere alcuni minuti.

1. Controllare lo stato dei pod distribuiti usando il comando kubectl get pods. Fare in modo che tutti i pod siano Running prima di procedere. Se si tratta del primo carico di lavoro distribuito, il provisioning automatico dei nodi potrebbe richiedere alcuni minuti per creare un pool di nodi per eseguire i pod.

   kubectl get pods -n aks-store-demo
   

2. Verificare la presenza di un indirizzo IP pubblico per l'applicazione front-store. Monitorare lo stato utilizzando il comando kubectl get service con l'argomento --watch.

   kubectl get ingress store-front -n aks-store-demo --watch
   

   L'output ADDRESS per il servizio store-front inizialmente mostra vuoto:

   NAME          CLASS                                HOSTS   ADDRESS        PORTS   AGE
   store-front   webapprouting.kubernetes.azure.com   *                      80      12m
   

3. Quando INDIRIZZO passa da in sospeso a un indirizzo IP pubblico effettivo, usare CTRL-C per arrestare il processo di controllo kubectl.

   L'output di esempio seguente mostra un indirizzo IP pubblico valido assegnato al servizio:

   NAME          CLASS                                HOSTS   ADDRESS        PORTS   AGE
   store-front   webapprouting.kubernetes.azure.com   *       4.255.22.196   80      12m
   

4. Aprire un Web browser all'indirizzo IP esterno del proprio ingress per vedere l'app Azure Store in azione.

   

Eliminare il cluster

Se non si prevede di eseguire l'esercitazione AKS, pulire le risorse non necessarie per evitare addebiti Azure.

Rimuovere il gruppo di risorse, il servizio contenitore e tutte le risorse correlate usando il comando az group delete.

az group delete --name myResourceGroup --yes --no-wait

Contenuti correlati

In questo avvio rapido, è stato distribuito un cluster Kubernetes usando il Servizio Azure Kubernetes automatico e successivamente è stata distribuita una semplice applicazione multi-contenitore. Questa applicazione di esempio è solo a scopo dimostrativo e non rappresenta tutte le procedure consigliate per le applicazioni Kubernetes. Per indicazioni sulla creazione di soluzioni complete con il servizio Azure Kubernetes per la produzione, vedere Linee guida per le soluzioni del servizio Azure Kubernetes.

Per altre informazioni sul servizio Azure Kubernetes automatico, vedere Introduzione a Servizio Azure Kubernetes (AKS) Automatico