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

  • Uma assinatura do Azure. Se não tiver subscrição Azure, pode criar uma conta Azure gratuita.
  • A versão 2.64.0 ou posterior do CLI do Azure deve ser instalada. Verifique sua versão usando o az --version comando. Para instalar ou atualizar, consulte Install CLI do Azure.
  • A aks-preview extensão CLI do Azure. Instala-o usando o az extension add --name aks-preview comando.
  • AKS desktop instalado. O desktop AKS suporta os seguintes sistemas operativos (SO): Windows, Linux e Mac.
  • Se for utilizado um cluster existente, este precisa de ser autenticado com o Microsoft Entra ID. Para garantir que o seu cluster está autenticado com o ID Microsoft Entra, utilize um cluster AKS Automatic. Também precisa do papel de Administrador do Cluster RBAC do Serviço Azure Kubernetes ou de permissões equivalentes no cluster alvo.

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:

  • Last updated on