Início Rápido: Implantar e gerenciar aplicativos usando a área de trabalho do AKS

A implantação e o gerenciamento de aplicativos Kubernetes normalmente exige a gravação de manifestos YAML, a execução de comandos kubectl e a alternância entre várias ferramentas. A área de trabalho do AKS remove essa complexidade com fluxos de trabalho guiados que permitem que desenvolvedores e engenheiros do DevOps implantem, monitorem, solucionem problemas e limpem aplicativos sem conhecimento profundo do Kubernetes.

Este guia orienta você pela implantação de um aplicativo TypeScript usando a área de trabalho do AKS, desde a criação de um cluster até a exploração de logs de aplicativos, métricas, dimensionamento e ferramentas de solução de problemas internas.

Pré-requisitos

Uma assinatura do Azure. Se você não tiver uma assinatura do Azure, poderá criar uma conta gratuita do Azure.
A CLI do Azure versão 2.64.0 ou posterior deve ser instalada. Verifique a versão usando o comando az --version. Para instalar ou atualizar, consulte Instalar CLI do Azure.
A extensão da CLI do aks-preview Azure. Instale-o usando o az extension add --name aks-preview comando.
AKS Desktop instalado. A área de trabalho do AKS dá suporte aos seguintes sistemas operacionais (SO): Windows, Linux e Mac.
Se estiver usando um cluster existente, o cluster precisará ser autenticado com o Microsoft Entra ID. Para garantir que o cluster seja autenticado pelo Microsoft Entra ID, use um cluster automático do AKS. Você também precisa da função de Administrador de Cluster do RBAC do Serviço de Kubernetes do Azure ou permissões equivalentes no cluster de destino.

Criar recursos do Azure

Se você não tiver um cluster do AKS existente e o ACR (Registro de Contêiner do Azure), poderá criá-los usando a CLI do Azure. Essas seções mostram como criar um novo grupo de recursos, um cluster do AKS e o ACR. Se você já tiver esses recursos, poderá pular para Registrar seu cluster na área de trabalho do AKS.

Definir variáveis de ambiente

Para simplificar os comandos, defina as variáveis de ambiente a seguir no terminal. Certifique-se de definir myLocation para sua região do Azure. O exemplo aqui usa RAND para criar nomes de recursos exclusivos. Você pode substituí-los por seus próprios valores se preferir.

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 Azure usando o comando az group create.

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 comando az acr create.

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

Criar um cluster do AKS com a integração do ACR

Crie um cluster do AKS com a integração do ACR usando o az aks create comando. O --attach-acr parâmetro concede ao cluster do AKS permissão para buscar imagens do ACR. Este comando de exemplo também define --sku como automatic. É recomendável usar clusters automáticos do AKS para obter a melhor experiência com a área de trabalho do AKS, mas você também pode usar um cluster Standard.

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

Conceder permissões de administrador de cluster

Obtenha a ID do recurso de cluster usando o comando e defina-a az aks show como uma variável de ambiente.
```
AKS_ID=$(az aks show --resource-group $myResourceGroup --name $myClusterName --query id --output tsv)
```
Conceda a si mesmo permissões de administrador para o cluster usando o az role assignment create comando com a função de Administrador de Cluster RBAC do Serviço de Kubernetes do Azure. Substitua <your-entra-id> pelo ID de objeto do Microsoft Entra ID.
```
az role assignment create --role "Azure Kubernetes Service RBAC Cluster Admin" \
   --assignee <your-entra-id> \
   --scope $AKS_ID
```

Criar uma imagem de contêiner para teste

Este exemplo cria uma imagem do aplicativo de exemplo Contoso Air, mas você pode usar qualquer imagem de contêiner para testar a implantação de um aplicativo com a área de trabalho do AKS. Se você quiser usar uma imagem diferente, substitua os detalhes da imagem nas etapas de implantação.

Crie um novo diretório, navegue até ele e clone o aplicativo de exemplo Contoso Air. Em seguida, navegue até o diretório do aplicativo Web. Se você estiver usando um aplicativo ou estrutura de diretório diferente, ajuste esses comandos de acordo.
```
mkdir myapp
cd myapp
git clone https://github.com/Azure-Samples/contoso-air
cd contoso-air/src/web
```
Compile e envie a imagem do contêiner para o seu registro de contêineres usando o comando az acr build. Se você estiver usando uma imagem diferente, atualize o nome e o caminho da imagem adequadamente.
```
az acr build --resource-group $myResourceGroup --registry $registryName --image contosoair:v1 .
```

Registre seu cluster no AKS Desktop

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.
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.)
Selecione seu cluster e selecione Registrar Cluster

Criar um projeto gerenciado na área de trabalho do AKS

Na área de trabalho do AKS, navegue até a guia Projetos e selecione Criar um Novo Projeto Gerenciado.
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

Ao definir a assinatura do Azure e o cluster do AKS, o AKS Desktop verifica se o cluster e a assinatura oferecem suporte aos recursos necessários para a experiência do AKS Desktop.
- 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: mantenha a configuração padrão para o aplicativo de teste.
- Acesso: Adicione alguém ou exclua a entrada excluindo o item de linha.
Em Revisão, verifique as configurações do projeto e, em seguida, selecione Criar Projeto.

Implantar um aplicativo

Forneça um nome de aplicativo e selecione Criar Aplicativo.
Selecione uma origem para seu aplicativo. Para este exemplo, selecione Imagem de Contêiner>Em Seguida.
Defina as seguintes configurações de aplicativo. Você pode aceitar os padrões ou atualizá-los conforme necessário.
- Nome da imagem do contêiner:
  - Adicione o nome da imagem do contêiner. Neste exemplo, usamos myacr.azurecr.io/contosoair:v1.
  Importante
  
  Você não pode usar a latest marca. Especifique uma marca explícita, como v1.
- Networking:
  - Porta de destino: para o contêiner de exemplo, definido como 3000.
  - Habilitar o acesso público: defina se você deseja acessar o aplicativo de uma URL pública.
- HPA (Dimensionador Automático de Pod Horizontal):
  - Habilitar o HPA: defina para habilitar o dimensionamento automático do aplicativo com base no uso de recursos.
Selecione Implantar para implantar o aplicativo. Pode levar alguns minutos para o aplicativo concluir a implantação. Você pode exibir o status da implantação na página visão geral do Projeto. Aguarde até que todos os recursos mostrem um estado íntegro antes de explorar o aplicativo.

Explorar o aplicativo

Na página visão geral do Projeto, você pode explorar seu aplicativo usando as seguintes guias:

Recursos: exibir todos os recursos do Kubernetes para o aplicativo.
Mapa: visualize como todos os recursos do Kubernetes interagem e dependem uns dos outros.
Logs: Ver logs do pod.
Métricas: exibir o consumo de recursos do aplicativo principal.
Dimensionamento: exibir eventos de dimensionamento e fazer atualizações.
Insights: solucionar problemas de falhas de DNS, tráfego de rede e uso de recursos (versão prévia). Para obter mais informações, consulte Solucionar problemas de um aplicativo na área de trabalho do AKS usando o Insights.
Excluir: excluir o Projeto.
Assistente de IA: use a linguagem natural para diagnosticar e resolver problemas em seu cluster (versão prévia). Para obter mais informações, consulte Usar o assistente de solução de problemas de IA na área de trabalho do AKS.

Limpar os recursos

Ao concluir o guia de início rápido, você pode liberar os recursos criados para evitar custos desnecessários.

Para remover o projeto, selecione Excluir. Se você também quiser remover o recurso de Namespace gerenciado do Azure subjacente, selecione Também excluir os namespaces.

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

Comentários

Esta página foi útil?

Last updated on 2026-05-14