Tutorial - Criar um cluster do Serviço Kubernetes do Azure (AKS)

O Kubernetes dispõe de uma plataforma distribuída para aplicações em contentores. Com o Azure Kubernetes Service (AKS), pode criar rapidamente um cluster Kubernetes pronto para produção.

Neste tutorial, você implanta um cluster Kubernetes no AKS. Sabe como:

  • Implante um cluster AKS que possa se autenticar em um Registro de Contêiner do Azure (ACR).
  • Instale a CLI do Kubernetes, kubectl.
  • Configurar kubectl para se conectar ao seu cluster AKS.

Antes de começar

Em tutoriais anteriores, você criou uma imagem de contêiner e a carregou em uma instância do ACR. Comece com o Tutorial 1 - Prepare a aplicação para o AKS para acompanhar.

Este tutorial cria recursos faturáveis de um cluster do AKS e requer a função Proprietário ou administrador da conta Azure na sua subscrição do Azure.

  • Se você estiver usando a CLI do Azure, este tutorial requer que você esteja executando a CLI do Azure versão 2.35.0 ou posterior. Verifique a sua versão com az --version. Para instalar ou atualizar, consulte Instalar a CLI do Azure.
  • Se você estiver usando o Azure PowerShell, este tutorial requer que você esteja executando o Azure PowerShell versão 5.9.0 ou posterior. Verifique a sua versão com Get-InstalledModule -Name Az. Para instalar ou atualizar, consulte Instalar o Azure PowerShell.
  • Se você estiver usando a CLI do Desenvolvedor do Azure, este tutorial requer que você esteja executando a CLI do Desenvolvedor do Azure versão 1.5.1 ou posterior. Verifique a sua versão com azd version. Para instalar ou atualizar, consulte Instalar a CLI do Azure Developer.

Criar um cluster do Kubernetes

Os clusters AKS podem usar o controle de acesso baseado em função do Kubernetes (Kubernetes RBAC), que permite definir o acesso a recursos com base nas funções atribuídas aos usuários. Se forem atribuídas várias funções a um usuário, as permissões serão combinadas. As permissões podem ter como escopo um único namespace ou em todo o cluster.

Para saber mais sobre AKS e Kubernetes RBAC, consulte Controlar o acesso a recursos de cluster usando identidades Kubernetes RBAC e Microsoft Entra no AKS.

Este tutorial requer a CLI do Azure versão 2.35.0 ou posterior. Verifique a sua versão com az --version. Para instalar ou atualizar, consulte Instalar a CLI do Azure. Se você estiver usando o ambiente Bash no Azure Cloud Shell, a versão mais recente já está instalada.

Instalar a CLI do Kubernetes

Você usa a CLI do Kubernetes, kubectl, para se conectar ao cluster do Kubernetes. Se utilizar o Azure Cloud Shell, o kubectl já está instalado. Se estiver a executar os comandos localmente, pode usar a CLI do Azure ou o Azure PowerShell para instalar kubectl.

Criar um cluster do AKS

Os clusters AKS podem usar o controle de acesso baseado em função do Kubernetes (Kubernetes RBAC), que permite definir o acesso a recursos com base nas funções atribuídas aos usuários. As permissões são combinadas quando os usuários recebem várias funções. As permissões podem ter como escopo um único namespace ou em todo o cluster. Para obter mais informações, consulte Controlar o acesso a recursos de cluster usando o Kubernetes RBAC e o Microsoft Entra ID no AKS.

Para permitir que um cluster AKS interaja com outros recursos do Azure, a plataforma Azure cria automaticamente uma identidade de cluster. Neste exemplo, a identidade do cluster recebe o direito de extrair imagens da instância ACR criada no tutorial anterior. Para executar o comando com êxito, você deve ter uma função de Proprietário ou administrador de conta do Azure em sua assinatura do Azure.

  • Crie um cluster AKS usando o az aks create comando. O exemplo seguinte cria um cluster com o nome myAKSCluster no grupo de recursos com o nome myResourceGroup. Este grupo de recursos foi criado no tutorial anterior na região westus2 . Continuaremos a usar a variável de ambiente, $ACRNAME, que definimos no tutorial anterior. Se você não tiver essa variável de ambiente definida, defina-a agora com o mesmo valor usado anteriormente.

Escolha uma opção de cluster e execute apenas o bloco de comandos correspondente. Tens duas opções para criar um cluster AKS. Veja aqui uma comparação detalhada.

  1. AKS Automatic (recomendado) — uma experiência de Kubernetes totalmente gerida que automatiza a configuração do cluster, as operações e a gestão dos nós. Escolha esta opção para operações simplificadas e para usar a interface da aplicação AKS Desktop com os padrões recomendados.

    Executa este bloco de comandos apenas se escolheres AKS Automático.

    az aks create \
    --resource-group myResourceGroup \
    --name myAKSCluster \
    --sku automatic \
    --attach-acr $ACRNAME

AKS_ID=$(az aks show --resource-group myResourceGroup --name myAKSCluster --query id -o tsv)
ENTRA_OBJECT_ID=$(az ad signed-in-user show --query id -o tsv)

# Grant yourself admin permissions to the cluster using the Azure Kubernetes Service RBAC Cluster Admin role.
az role assignment create --role "Azure Kubernetes Service RBAC Cluster Admin" \
    --assignee $ENTRA_OBJECT_ID \
    --scope $AKS_ID

  2. AKS Standard — dá-lhe controlo total sobre a configuração do cluster e a gestão de nós. Escolhe esta opção se precisares de personalizar as definições do cluster. Para usar o AKS Desktop com clusters Standard, especifique opções adicionais de cluster no momento da criação.

    Executa este bloco de comandos apenas se escolheres o AKS Standard.

    Importante

    Este tutorial cria um cluster de três nós. Se você receber uma mensagem de erro ao tentar criar o cluster, talvez seja necessário solicitar um aumento de cota para sua assinatura do Azure ou tentar uma região diferente do Azure. Alternativamente, pode usar menos nós ou omitir o parâmetro de tamanho da VM do nó para usar o tamanho padrão da VM. Para obter informações sobre limites de recursos do AKS e disponibilidade de região, consulte Cotas, restrições de tamanho de máquina virtual e disponibilidade de região no AKS.

    az aks create \
    --resource-group myResourceGroup \
    --name myAKSCluster \
    --node-count 3 \
    --node-vm-size standard_l8s_v3 \
    --generate-ssh-keys \
    --attach-acr $ACRNAME

    Nota

    Se você já gerou chaves SSH, poderá encontrar um erro semelhante ao linuxProfile.ssh.publicKeys.keyData is invalid. Para continuar, tente novamente o comando sem o --generate-ssh-keys parâmetro.

Para evitar a necessidade de uma função de Proprietário ou administrador de conta do Azure, pode também configurar manualmente um principal de serviço para extrair imagens do Registo de Contentores do Azure (ACR). Para obter mais informações, consulte Autenticação ACR com principais de serviço ou Autenticar do Kubernetes com um segredo de extração. Como alternativa, pode utilizar uma identidade gerida em vez de uma entidade de serviço para facilitar a gestão.

Ligar ao cluster com o kubectl

  1. Configure kubectl para se conectar ao cluster do Kubernetes usando o az aks get-credentials comando. O exemplo a seguir obtém credenciais para o cluster AKS chamado myAKSCluster em myResourceGroup.

    az aks get-credentials --resource-group myResourceGroup --name myAKSCluster

  2. Verifique a conexão com o cluster usando o kubectl get nodes comando, que retorna uma lista de nós do cluster.

    kubectl get nodes

    O exemplo de saída a seguir mostra uma lista dos nós do cluster:

    NAME                                STATUS   ROLES   AGE   VERSION
aks-nodepool1-19366578-vmss000000   Ready    agent   47h   v1.30.9
aks-nodepool1-19366578-vmss000001   Ready    agent   47h   v1.30.9
aks-nodepool1-19366578-vmss000002   Ready    agent   47h   v1.30.9

Passos seguintes

Neste tutorial, você implantou um cluster Kubernetes no AKS e configurou kubectl para se conectar ao cluster. Aprendeu a:

  • Implante um cluster AKS que possa se autenticar em um ACR.
  • Instale a CLI do Kubernetes, kubectl.
  • Configurar kubectl para se conectar ao seu cluster AKS.

No próximo tutorial, você aprenderá a implantar o Armazenamento de Contêiner do Azure em seu cluster e criar um volume efêmero genérico. Se você estiver usando a CLI do Desenvolvedor do Azure ou se não puder usar um tipo de VM otimizado para armazenamento devido a problemas de cota, vá diretamente para o tutorial Implantar aplicativo em contêiner.

Implantar o Armazenamento de Contêiner do Azure

  • Last updated on