Tutorial – Implantar um aplicativo no AKS (Serviço de Kubernetes do Azure)

Este tutorial requer a instalação da área de trabalho do AKS.

Este tutorial exige a CLI do Azure versão 2.0.53 ou posterior. Verifique sua versão com az --version. Para instalar ou atualizar, confira Instalar a CLI do Azure.

Este tutorial exige o Azure PowerShell versão 5.9.0 ou posterior. Verifique sua versão com Get-InstalledModule -Name Az. Para instalar ou atualizar, confira Instalar o Azure PowerShell.

Este tutorial requer a Azure Developer CLI (azd) versão 1.5.1 ou posterior. Verifique sua versão com azd version. Para instalar ou atualizar, confira Instalar o Azure Developer CLI.

1. Verifique se você está no diretório clonado aks-store-demo e, em seguida, abra o arquivo de manifesto aks-store-quickstart.yaml com um editor de texto.

2. Atualize a propriedade image para os contêineres substituindo ghcr.io/azure-samples pelo nome do servidor de logon do ACR.

   containers:
   ...
   - name: order-service
     image: <acrName>.azurecr.io/aks-store-demo/order-service:1.0
   ...
   - name: product-service
     image: <acrName>.azurecr.io/aks-store-demo/product-service:1.0
   ...
   - name: store-front
     image: <acrName>.azurecr.io/aks-store-demo/store-front:1.0
   ...
   

1. Verifique se você está no diretório clonado aks-store-demo e, em seguida, abra o arquivo de manifesto aks-store-quickstart.yaml com um editor de texto.

2. Atualize a propriedade image para os contêineres substituindo ghcr.io/azure-samples pelo nome do servidor de logon do ACR.

   containers:
   ...
   - name: order-service
     image: <acrName>.azurecr.io/aks-store-demo/order-service:1.0
   ...
   - name: product-service
     image: <acrName>.azurecr.io/aks-store-demo/product-service:1.0
   ...
   - name: store-front
     image: <acrName>.azurecr.io/aks-store-demo/store-front:1.0
   ...
   

3. Salve e feche o arquivo.

4. Verifique se está aks-store-quickstart.yaml no diretório atual antes de continuar.

1. Verifique se você está no diretório clonado aks-store-demo e, em seguida, abra o arquivo de manifesto aks-store-quickstart.yaml com um editor de texto.

2. Atualize a propriedade image para os contêineres substituindo ghcr.io/azure-samples pelo nome do servidor de logon do ACR.

   containers:
   ...
   - name: order-service
     image: <acrName>.azurecr.io/aks-store-demo/order-service:1.0
   ...
   - name: product-service
     image: <acrName>.azurecr.io/aks-store-demo/product-service:1.0
   ...
   - name: store-front
     image: <acrName>.azurecr.io/aks-store-demo/store-front:1.0
   ...
   

3. Salve e feche o arquivo.

4. Verifique se está aks-store-quickstart.yaml no diretório atual antes de continuar.

azd não requer uma etapa do registro de contêiner, pois está no modelo.

Implantar e gerenciar o aplicativo usando a área de trabalho do AKS

A área de trabalho do AKS é um portal de desenvolvedores focado em aplicativos para AKS (Serviço de Kubernetes do Azure) que simplifica a implantação e o gerenciamento de aplicativos sem a necessidade de conhecimento profundo do Kubernetes.

Registrar seu cluster com a área de trabalho do AKS

1. Verifique se você está conectado à área de trabalho do AKS com a mesma conta que tem acesso ao cluster do AKS. Depois de entrar, selecione Adicionar por meio da Assinatura do Azure.
2. Insira o nome da sua assinatura do Azure se você tiver mais de uma. (Como alternativa, selecione a seta para abrir a lista suspensa e selecione sua assinatura do Azure.)
3. Selecione seu cluster e selecione Registrar Cluster.

Continue quando o status do cluster aparecer como conectado na área de trabalho do AKS.

Criar um projeto gerenciado na área de trabalho do AKS

1. Na área de trabalho do AKS, vá para a guia Projetos e selecione Criar um novo Project Gerenciado.

2. Defina as seguintes configurações do Projeto:

   • Noções básicas:
     • Nome do projeto: por exemplo, my-dev-frontend
     • Assinatura: <your-subscription-name>
     • Cluster: <your-cluster-name>

   Note

   Quando você define a assinatura Azure e o cluster do AKS, a área de trabalho do AKS verifica se há suporte necessário para o cluster e o recurso de assinatura.

   • Políticas de Rede: você pode deixar as configurações padrão para este início rápido ou atualizá-las conforme necessário.

     • Para expor o aplicativo publicamente, altere Ingress para Allow all traffic.

   • Cota de Computação: defina os valores do aplicativo de teste.

   • Acesso: Adicione alguém ou exclua a entrada excluindo o item de linha.

3. Em Revisão, verifique as configurações do projeto e, em seguida, selecione Criar Projeto.

   

Implantar um aplicativo

1. Forneça um nome de aplicativo e selecione Criar Aplicativo.

   

2. Selecione uma origem para seu aplicativo. Para este exemplo, selecione Kubernetes YAML>Next.

3. Abra aks-store-quickstart.yaml, copie e cole seu conteúdo no editor e selecione Avançar.

4. Examine os recursos criados e selecione Implantar e Fechar.

5. Os recursos podem levar alguns minutos para serem implantados. Durante esse tempo, o status do projeto pode aparecer como Degraded enquanto o cluster é escalado.

6. Verifique o status dos recursos do aplicativo selecionando Recursos e, em seguida, Cargas de Trabalho.

   Você pode forçar uma atualização de tela selecionando a opção de menu de janela superior Navegar>Recarregar.

7. Selecione recursos de carga de trabalho individuais para exibir seus detalhes e eventos.

1. Implante a aplicação usando o comando kubectl apply, que processa o arquivo de manifesto e cria os objetos do Kubernetes definidos nele.

   kubectl apply -f aks-store-quickstart.yaml
   

   A saída de exemplo a seguir mostra os recursos criados com êxito no cluster AKS:

   statefulset.apps/rabbitmq 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
   

2. Verifique se a implantação foi bem-sucedida exibindo os pods com o comando kubectl get pods.

   kubectl get pods
   

   Verifique se os pods da aplicação estão com status Running antes de continuar.

1. Implante a aplicação usando o comando kubectl apply, que processa o arquivo de manifesto e cria os objetos do Kubernetes definidos.

   kubectl apply -f aks-store-quickstart.yaml
   

   A saída de exemplo a seguir mostra os recursos criados com êxito no cluster AKS:

   statefulset.apps/rabbitmq 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
   

2. Verifique se a implantação foi bem-sucedida visualizando os pods com o comando kubectl get pods.

   kubectl get pods
   

   Verifique se os pods do aplicativo estão com status Running antes de continuar.

A implantação em azd é dividida em vários estágios representados por ganchos. azd é implantado com todos os hooks por padrão.

1. Implante o aplicativo usando o comando azd up.

   azd up
   

   Continue quando azd up terminar com êxito e imprima a saída da implantação.

2. Selecione em qual assinatura e região hospedar seus recursos do Azure.

   ? Select an Azure Subscription to use:  [Use arrows to move, type to filter]
   > 1. My Azure Subscription (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)
   Select an Azure location to use:  [Use arrows to move, type to filter]
   > 43. (US) East US 2 (eastus2)
   

   Você pode atualizar as variáveis de AZURE_LOCATION e AZURE_SUBSCRIPTION_ID de dentro do arquivo .azure/<your-env-name>/.env.