Início Rápido: Desenvolver no Azure Kubernetes Service (AKS) com Helm

O Helm é uma ferramenta de empacotamento de código aberto que ajuda você a instalar e gerenciar o ciclo de vida dos aplicativos Kubernetes. Semelhante aos gerenciadores de pacotes Linux como APT e Yum, o Helm gerencia gráficos Kubernetes, que são pacotes de recursos Kubernetes pré-configurados.

Neste início rápido, você usa o Helm para empacotar e executar um aplicativo no AKS. Para obter informações sobre como instalar um aplicativo existente usando o Helm, consulte Instalar aplicativos existentes com o Helm no AKS.

Prerequisites

• Uma subscrição do Azure. Se não tiver uma subscrição Azure, pode criar uma conta gratuita.
• CLI do Azure ou Azure PowerShell instalado.
• Helm v3 instalado.

Criar um Registo de Contentores do Azure

Precisa de armazenar as suas imagens de contentores num Azure Container Registry (ACR) para executar a sua aplicação no cluster AKS usando Helm. O nome do seu registo deve ser único no Azure e conter entre 5 a 50 caracteres alfanuméricos. Apenas caracteres minúsculos são permitidos. O SKU básico é um ponto de entrada com custo otimizado para fins de desenvolvimento que fornece um equilíbrio entre armazenamento e taxa de transferência.

Criar um cluster do AKS

O seu novo cluster AKS precisa de aceder ao seu ACR para obter as imagens de contentor e executá-las.

Conecte-se ao cluster AKS

Para conectar um cluster Kubernetes localmente, use o cliente de linha de comando Kubernetes, kubectl. kubectl já está instalado se usares Azure Cloud Shell.

Baixe o aplicativo de exemplo

Este quickstart utiliza a aplicação Azure Vote.

1. Clone a aplicação a partir de GitHub usando o comando git clone.

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

2. Navegue até o azure-vote diretório usando o cd comando.

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

Crie e envie o aplicativo de exemplo para o ACR

• Crie e envie a imagem para o seu ACR usando o comando az acr build . O exemplo a seguir cria uma imagem chamada azure-vote-front:v1 e a envia por push para o ACR myhelmacr . Certifique-se de substituir myhelmacr pelo nome do seu ACR.

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

Cria o teu Helm chart

1. Gere o Helm chart usando o comando helm create.

   helm create azure-vote-front
   

2. Atualize azure-vote-front/Chart.yaml para adicionar uma dependência para o gráfico redis do https://charts.bitnami.com/bitnami repositório de gráficos e atualize appVersion para v1, conforme mostrado no exemplo a seguir:

   Nota

   As versões de imagem de contêiner mostradas neste guia foram testadas para funcionar com este exemplo, mas podem não ser a versão mais recente disponível.

   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. Atualize as dependências do gráfico Helm usando o helm dependency update comando.

   helm dependency update azure-vote-front
   

4. Atualize azure-vote-front/values.yaml com as seguintes alterações.

   • Adicione uma seção redis para definir os detalhes da imagem, a porta do contêiner e o nome da implantação.
   • Adicione um backendName para conectar a parte frontal à implementação do redis.
   • Altere image.repository para <loginServer>/azure-vote-front.
   • Altere image.tag para v1.
   • Altere service.type para LoadBalancer.

   Por exemplo:

   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. Adicione uma env seção a azure-vote-front/templates/deployment.yaml para passar o nome da implantação do 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 }}
   ...
   

Execute seu gráfico Helm

1. Instale seu aplicativo usando o gráfico Helm usando o helm install comando.

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

2. Leva alguns minutos para o serviço retornar um endereço IP público. Monitore o progresso usando o kubectl get service comando com o --watch argumento.

   kubectl get service azure-vote-front --watch
   

   Quando o serviço estiver pronto, o EXTERNAL-IP valor muda de <pending> para um endereço IP. Pressione CTRL+C para parar o processo de kubectl monitorização.

     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. Navegue até o balanceador de carga do seu aplicativo em um navegador usando o <EXTERNAL-IP> para ver o aplicativo de exemplo.

Eliminar o cluster

Próximos passos

Para obter mais informações sobre como usar o Helm, consulte a documentação do Helm.