Guida introduttiva: Sviluppare nel servizio Azure Kubernetes (AKS) con Helm

Helm è uno strumento per la creazione di pacchetti open source che consente di installare e gestire il ciclo di vita delle applicazioni Kubernetes. Analogamente agli strumenti di gestione pacchetti Linux come APT e Yum, Helm gestisce i grafici Kubernetes, che sono pacchetti di risorse Kubernetes preconfigurati.

In questa guida introduttiva, si usa Helm per confezionare ed eseguire un'applicazione su AKS. Per informazioni sull'installazione di un'applicazione esistente con Helm, vedere Installare applicazioni esistenti con Helm nel servizio Azure Kubernetes.

Prerequisiti

• Sottoscrizione Azure. Se non si ha una sottoscrizione Azure, è possibile creare un account free.
• Interfaccia della riga di comando di Azure o Azure PowerShell installato.
• Helm v3 installato.

Creare un Registro Azure Container

È necessario archiviare le immagini del contenitore in un Registro Azure Container per eseguire l'applicazione nel cluster del servizio Azure Kubernetes usando Helm. Il nome del Registro di sistema deve essere univoco all'interno di Azure e contenere 5-50 caratteri alfanumerici. Sono consentiti solo caratteri minuscoli. Lo SKU Basic è un punto di ingresso con costi ottimali a fini di sviluppo, che assicura l'equilibrio tra spazio di archiviazione e velocità effettiva.

Creare un cluster AKS

Il tuo nuovo cluster AKS ha bisogno di accedere ad ACR per scaricare le immagini dei container e avviarle.

Connetti al cluster AKS

Per connettere un cluster Kubernetes in locale, usare il client da riga di comando Kubernetes kubectl. kubectl è già installato se si usa Azure Cloud Shell.

Scaricare l'applicazione di esempio

Questa guida di avvio rapido usa l'applicazione Azure Vote.

1. Clonare l'applicazione da GitHub usando il comando git clone.

   git clone https://github.com/Azure-Samples/azure-voting-app-redis.git
   

2. Passare alla directory azure-vote usando il comando cd.

   cd azure-voting-app-redis/azure-vote/
   

Compilare ed eseguire il push dell'applicazione di esempio in Registro Azure Container

• Compilare e pubblicare l'immagine nel Azure Container Registry usando il comando az acr build. L'esempio seguente crea un'immagine denominata azure-vote-front:v1 e la carica nel Registro Azure Container myhelmacr. Assicurarsi di sostituire myhelmacr con il nome del registro Azure Container.

  az acr build --image azure-vote-front:v1 --registry myhelmacr --file Dockerfile .
  

Creare il grafico Helm

1. Generare il grafico Helm usando il comando helm create.

   helm create azure-vote-front
   

2. Aggiornare azure-vote-front/Chart.yaml per aggiungere una dipendenza per il grafico redis dal repository del grafico https://charts.bitnami.com/bitnami e aggiornare appVersion a v1, come illustrato nell'esempio seguente:

   Nota

   Le versioni dell'immagine del contenitore illustrate in questa guida sono state testate per funzionare con questo esempio, ma potrebbero non essere la versione più recente disponibile.

   apiVersion: v2
   name: azure-vote-front
   description: A Helm chart for Kubernetes
   
   dependencies:
     - name: redis
       version: 17.3.17
       repository: https://charts.bitnami.com/bitnami
   
   ...
   # This is the version number of the application being deployed. This version number should be
   # incremented each time you make changes to the application.
   appVersion: v1
   

3. Aggiorna le dipendenze del chart di Helm usando il comando helm dependency update.

   helm dependency update azure-vote-front
   

4. Aggiornare azure-vote-front/values.yaml con le modifiche seguenti.

   • Aggiungere una sezione redis per impostare i dettagli dell'immagine, la porta del contenitore e il nome della distribuzione.
   • Aggiungere un backendName per connettere la parte front-end alla distribuzione redis.
   • Modificare image.repository in <loginServer>/azure-vote-front.
   • Modificare image.tag in v1.
   • Modificare service.type in LoadBalancer.

   Ad esempio:

   replicaCount: 1
   backendName: azure-vote-backend-master
   redis:
     image:
       registry: mcr.microsoft.com
       repository: oss/bitnami/redis
       tag: 6.0.8
     fullnameOverride: azure-vote-backend
     auth:
       enabled: false
   
   image:
     repository: myhelmacr.azurecr.io/azure-vote-front
     pullPolicy: IfNotPresent
     tag: "v1"
   ...
   service:
     type: LoadBalancer
     port: 80
   ...
   

5. Aggiungere una sezione env ad azure-vote-front/templates/deployment.yaml per passare il nome della distribuzione redis.

   ...
         containers:
           - name: {{ .Chart.Name }}
             securityContext:
               {{- toYaml .Values.securityContext | nindent 12 }}
             image: "{{ .Values.image.repository }}:{{ .Values.image.tag | default .Chart.AppVersion }}"
             imagePullPolicy: {{ .Values.image.pullPolicy }}
             env:
             - name: REDIS
               value: {{ .Values.backendName }}
   ...
   

Eseguire il grafico Helm

1. Installare l'applicazione usando il grafico Helm usando il comando helm install.

   helm install azure-vote-front azure-vote-front/
   

2. Ci vogliono alcuni minuti perché il servizio restituisca un indirizzo IP pubblico. Monitorare lo stato di avanzamento usando il comando kubectl get service con l'argomento --watch.

   kubectl get service azure-vote-front --watch
   

   Quando il servizio è pronto, il valore EXTERNAL-IP passa da <pending> a un indirizzo IP. Premere CTRL+C per arrestare il processo di monitoraggio kubectl.

     NAME               TYPE           CLUSTER-IP    EXTERNAL-IP     PORT(S)        AGE
     azure-vote-front   LoadBalancer   10.0.18.228   <pending>       80:32021/TCP   6s
     ...
     azure-vote-front   LoadBalancer   10.0.18.228   52.188.140.81   80:32021/TCP   2m6s
   

3. Passare al load balancer dell'applicazione in un browser usando <EXTERNAL-IP> per visualizzare l'applicazione di esempio.

Eliminare il cluster

Passaggi successivi

Per altre informazioni sull'uso di Helm, vedere la documentazionedi Helm.