Início Rápido: Desenvolver no Serviço de Kubernetes do Azure (AKS) com o Helm

Helm é uma ferramenta de empacotamento de software livre que ajuda a instalar e gerenciar o ciclo de vida de aplicativos Kubernetes. Semelhante a gerenciadores de pacotes do Linux, como o APT e o Yum, o Helm gerencia gráficos do Kubernetes, que são pacotes de recursos de Kubernetes pré-configurados.

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

• Uma assinatura do Azure. Caso não tenha uma assinatura do Azure, é possível criar uma conta gratuita.
• CLI do Azure ou Azure PowerShell instalados.
• Helm v3 instalado.

Você precisa armazenar suas imagens de contêiner em um Registro de Contêiner do Azure (ACR) para executar seu aplicativo no cluster do AKS usando o Helm. O seu nome do registro deve ser exclusivo no Azure e conter de 5 a 50 caracteres alfanuméricos. Somente são permitidos caracteres minúsculos. A SKU Basic é um ponto de entrada de otimização de custo para fins de desenvolvimento que fornece um equilíbrio entre o armazenamento e taxa de transferência.

O novo cluster AKS precisa acessar seu ACR para efetuar pull das imagens de contêiner e executá-las.

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

Este guia de início rápido usa o aplicativo de voto do Azure.

1. Clone o aplicativo do GitHub usando o comando git clone.

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

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

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

• Crie e envie por push 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 .
  

1. Gere o gráfico Helm 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 repositório de gráficos https://charts.bitnami.com/bitnami e atualizar o appVersion para v1, como mostrado no exemplo a seguir:

   Observação

   As versões da 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 suas dependências de gráficos do Helm usando o comando helm dependency update.

   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 de front-end à implantação do redis.
   • Altere image.repository para <loginServer>/azure-vote-front.
   • Altere image.tag para v1.
   • Altere o 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 seção env a azure-vote-front/templates/deployment.yaml para aprovar 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 }}
   ...
   

1. Com o comando helm install, instale o aplicativo que usa o gráfico Helm.

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

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

   kubectl get service azure-vote-front --watch
   

   Quando o serviço estiver pronto, o valor EXTERNAL-IP será alterado de <pending> para um endereço IP. Pressione CTRL+C para interromper o processo de inspeção 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. Navegue até o balanceador de carga do aplicativo em um navegador usando o <EXTERNAL-IP> para ver o aplicativo de exemplo.

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