Quickstart: Implementar e gerir aplicações usando o desktop AKS

Implementar e gerir aplicações Kubernetes normalmente requer escrever manifestos YAML, executar comandos kubectl e alternar entre várias ferramentas. O AKS desktop elimina esta complexidade com fluxos de trabalho guiados que permitem a programadores e engenheiros DevOps implementar, monitorizar, resolver problemas e limpar aplicações sem grande experiência em Kubernetes.

Este guia guia-o na implementação de uma aplicação TypeScript usando o desktop AKS, desde a criação de um cluster até à exploração de registos de aplicação, métricas, escalabilidade e ferramentas integradas de resolução de problemas.

Pré-requisitos

Criar recursos do Azure

Se não tiver um cluster AKS e o Azure Container Registry (ACR) existentes, pode criá-los usando a linha de comando do Azure. Estas secções mostram como criar um novo grupo de recursos, um cluster AKS e um ACR. Se já tiver estes recursos, pode saltar para Registar o seu cluster no ambiente de trabalho AKS.

Definir variáveis de ambiente

Para simplificar os comandos, defina as seguintes variáveis de ambiente no seu terminal. Certifica-te de definir myLocation para a tua região Azure. O exemplo aqui é usado RAND para criar nomes de recursos únicos. Podes substituir estes por valores próprios, se preferires.

RAND=$RANDOM
export RAND
echo "Random resource identifier will be: ${RAND}"
myResourceGroup=bbash$RAND
myLocation=westus3
myClusterName=clu-$RAND
registryName=bbashreg$RAND

Criar um grupo de recursos

Crie um grupo de recursos do Azure usando o az group create comando.

az group create --name $myResourceGroup --location $myLocation

Criar um registro de contêiner do Azure

Crie um registro de contêiner do Azure usando o az acr create comando.

az acr create --resource-group $myResourceGroup --name $registryName --sku Basic

Criar um cluster AKS com integração ACR

Crie um cluster AKS com integração ACR usando o az aks create comando. O --attach-acr parâmetro concede ao cluster AKS permissão para extrair imagens do ACR. Este comando de exemplo também define o --sku para automatic. Recomendamos usar Clusters automáticos AKS para a melhor experiência com AKS Desktop, mas também pode usar um Cluster padrão.

az aks create --resource-group $myResourceGroup --name $myClusterName --sku automatic --attach-acr $registryName

Conceder permissões de administrador do cluster

  1. Obtenha o ID do recurso do cluster usando o az aks show comando e defina-o como variável de ambiente.

    AKS_ID=$(az aks show --resource-group $myResourceGroup --name $myClusterName --query id --output tsv)

  2. Conceda permissões de administrador ao cluster usando o az role assignment create comando com o papel de Administrador do Cluster RBAC do Serviço Azure Kubernetes. Certifique-se de substituir <your-entra-id> pelo ID de objeto do seu Microsoft Entra ID.

    az role assignment create --role "Azure Kubernetes Service RBAC Cluster Admin" \
   --assignee <your-entra-id> \
   --scope $AKS_ID

Crie uma imagem de contentor para testar

Este exemplo cria uma imagem a partir da aplicação de amostra Contoso Air, mas pode usar qualquer imagem de contentor para testar a implementação de uma aplicação com o desktop AKS. Se quiser usar uma imagem diferente, certifique-se de substituir os detalhes da imagem nas etapas de implementação.

  1. Cria um novo diretório, navega até ele e clona a aplicação de amostra Contoso Air. Depois navega até ao diretório da aplicação web. Se estiveres a usar uma aplicação ou estrutura de diretórios diferente, ajusta estes comandos em conformidade.

    mkdir myapp
cd myapp
git clone https://github.com/Azure-Samples/contoso-air
cd contoso-air/src/web

  2. Constrói e envia a imagem do contentor para o registo do teu contentor usando o az acr build comando. Se estiveres a usar uma imagem diferente, certifica-te de atualizar o nome e o caminho da imagem em conformidade.

    az acr build --resource-group $myResourceGroup --registry $registryName --image contosoair:v1 .

Regista o teu cluster no ambiente de trabalho AKS

  1. Certifica-te de que estás ligado ao desktop do AKS com a mesma conta que tem acesso ao cluster do AKS. Assim que iniciar sessão, selecione Adicionar a partir da subscrição do Azure.

  2. Introduza o nome da sua subscrição Azure se tiver mais do que uma. (Alternativamente, selecione a seta para abrir a lista suspensa e, em seguida, selecione a sua subscrição do Azure.)

  3. Selecione o seu cluster e depois selecione Registar Cluster

    Um vídeo a demonstrar como adicionar um cluster à aplicação de ambiente de trabalho do AKS.

Criar um Projeto gerido no ambiente de trabalho AKS

  1. No ambiente de trabalho AKS, navegue até ao separador Projetos e selecione Criar um Novo Projeto Gerido.

  2. Configure as seguintes definições do projeto:

    • Princípios básicos:
      • Nome do Projeto: Por exemplo, my-dev-frontend
      • Subscrição: <your-subscription-name>
      • Agrupamento: <your-cluster-name>

    Note

    Quando configurado a subscrição Azure e o cluster AKS, o desktop do AKS verifica o suporte a clusters e funcionalidades de subscrição necessários para a experiência desktop do AKS.

    • Políticas de Rede: Pode deixar as definições padrão deste início rápido ou atualizá-las conforme necessário.

      • Para expor a aplicação publicamente, altere Ingress para Allow all traffic.

    • Cota de Computação: Deixar como padrão para a aplicação de teste.

    • Acesso: Adicionar alguém ou eliminar a entrada eliminando o item de linha.

  3. Em Revisar, verifique as definições do seu Projeto e depois selecione Criar Projeto.

    Captura de ecrã da criação de um novo Projeto no ambiente de trabalho AKS.

Implementar uma aplicação

  1. Forneça um nome de aplicação e depois selecione Criar Aplicação.

    Captura de ecrã da criação de uma nova aplicação no ambiente de trabalho AKS.

  2. Selecione uma fonte para a sua candidatura. Para este exemplo, selecione Imagem do Contentor>a seguir.

    Captura de ecrã da seleção de uma fonte para uma nova aplicação no desktop AKS.

  3. Configure as seguintes definições do aplicativo. Podes aceitar os valores definidos ou atualizá-los conforme necessário.

    • Nome da imagem do contentor:

      • Adicione o nome da imagem do contentor. Neste exemplo, usamos myacr.azurecr.io/contosoair:v1.

      Importante

      Não podes usar a latest etiqueta. Especifique uma etiqueta explícita como v1.

    • Redes:

      • Porta alvo: Para o contentor de exemplo, defina para 3000.
      • Ativar acesso público: Defina se quiser aceder à aplicação a partir de uma URL pública.

    • HPA (Escalador Automático de Pod Horizontal):

      • Ativar HPA: Definir para permitir a escalabilidade automática da aplicação com base no uso de recursos.

  4. Selecione Implementar para implementar a aplicação. Pode demorar alguns minutos até a aplicação terminar de ser implementada. Pode consultar o estado da implementação na página de visão geral do projeto. Espere até que todos os recursos mostrem um estado saudável antes de explorar a aplicação.

    Captura de ecrã de um ecrã de visão geral do projeto no ambiente de trabalho AKS.

Explore a aplicação

Na página de visão geral do projeto, pode explorar a sua aplicação utilizando as seguintes abas:

  • Recursos: Veja todos os recursos Kubernetes para a aplicação.
  • Mapa: Visualize como todos os recursos Kubernetes interagem e dependem uns dos outros.
  • Logs: Ver logs do pod.
  • Métricas: Veja o consumo de recursos principais da aplicação.
  • Escalabilidade: Visualize eventos de escalonamento e faça atualizações.
  • Insights: Resolver falhas de DNS, tráfego de rede e utilização de recursos (pré-visualização). Para mais informações, consulte Solucionar problemas de uma aplicação no desktop AKS usando Insights.
  • Eliminar: Apagar o projeto.
  • Assistente de IA: Use linguagem natural para diagnosticar e resolver problemas no seu cluster (pré-visualização). Para mais informações, consulte Usar o assistente de resolução de problemas com IA no desktop AKS.

Limpeza de recursos

Quando terminar o quickstart, pode limpar os recursos que criou para evitar custos desnecessários.

Para remover o projeto, selecione Eliminar. Se também quiser remover o recurso subjacente do Namespace gerido do Azure, seleciona Eliminar também os namespaces.

Conteúdo relacionado

Para mais informações sobre o desktop AKS, consulte os seguintes recursos:

  • Última atualização a