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

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

Este tutorial requer 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.

Este tutorial requer 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.

• Instale kubectl localmente usando o az aks install-cli comando.

  az aks install-cli
  

• Instale kubectl localmente usando o Install-AzAksCliTool cmdlet.

  Install-AzAksCliTool
  

azd ambientes em um espaço de código baixam automaticamente todas as dependências encontradas no ./devcontainer/devcontainer.json. Isso inclui a CLI do Kubernetes junto com quaisquer imagens do Azure Container Registry (ACR).

• Para instalar kubectl localmente, use o az aks install-cli comando.

  az aks install-cli
  

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ê precisa 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 eastus. 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.

  az aks create \
      --resource-group myResourceGroup \
      --name myAKSCluster \
      --node-count 2 \
      --generate-ssh-keys \
      --attach-acr $ACRNAME
  

  Nota

  Se você já gerou chaves SSH, você pode 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, você também pode configurar manualmente uma entidade de serviço para extrair imagens do ACR. Para obter mais informações, consulte Autenticação ACR com entidades de serviço ou Autenticar do Kubernetes com um segredo de receção. Como alternativa, você pode usar uma identidade gerenciada em vez de uma entidade de serviço para facilitar o gerenciamento.

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ê precisa ter uma função de Proprietário ou administrador de conta do Azure em sua assinatura do Azure.

• Crie um cluster AKS usando o New-AzAksCluster cmdlet. 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 eastus.

  New-AzAksCluster -ResourceGroupName myResourceGroup -Name myAKSCluster -NodeCount 2 -GenerateSshKey -AcrNameToAttach $ACRNAME
  

  Nota

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

Para evitar a necessidade de uma função de Proprietário ou administrador de conta do Azure, você também pode configurar manualmente uma entidade de serviço para extrair imagens do ACR. Para obter mais informações, consulte Autenticação ACR com entidades de serviço ou Autenticar do Kubernetes com um segredo de receção. Como alternativa, você pode usar uma identidade gerenciada em vez de uma entidade de serviço para facilitar o gerenciamento.

azd Empacota a implantação de clusters com o próprio aplicativo usando o azd up comando. Este comando é abordado no próximo tutorial.

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.28.9
   aks-nodepool1-19366578-vmss000001   Ready    agent   47h   v1.28.9
   

1. Configure kubectl para se conectar ao cluster do Kubernetes usando o Import-AzAksCredential cmdlet. O exemplo a seguir obtém credenciais para o cluster AKS chamado myAKSCluster em myResourceGroup.

   Import-AzAksCredential -ResourceGroupName 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.28.9
   aks-nodepool1-19366578-vmss000001   Ready    agent   47h   v1.28.9
   

1. Configure a autenticação para o cluster usando o azd auth login comando.

   azd auth login 
   

2. Siga as instruções para o seu método de autenticação.

3. Verifique a conexão com o cluster usando o kubectl get nodes comando.

   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.28.9
   aks-nodepool1-19366578-vmss000001   Ready    agent   47h   v1.28.9
   

AZD Auth Solução alternativa

Esta solução alternativa requer que você tenha a CLI do Azure instalada.

1. Abra uma janela de terminal e faça logon com a CLI do Azure usando o az login comando com o --scope parâmetro definido como https://graph.microsoft.com/.default.

   az login --scope https://graph.microsoft.com/.default
   

   Você deve ser redirecionado para uma página de autenticação em uma nova guia para criar um token de acesso do navegador, conforme mostrado no exemplo a seguir:

   https://login.microsoftonline.com/organizations/oauth2/v2.0/authorize?clientid=<your_client_id>.
   

2. Copie o URL localhost da página da Web que você recebeu depois de tentar entrar com azd auth logino .

3. Numa nova janela do terminal, utilize o seguinte curl pedido para iniciar sessão. Certifique-se de substituir o espaço reservado <localhost> pelo URL do host local copiado na etapa anterior.

   curl <localhost>
   

   Um login bem-sucedido gera uma página da Web HTML, conforme mostrado no exemplo a seguir:

   <!DOCTYPE html>
   <html>
   <head>
       <meta charset="utf-8" />
       <meta http-equiv="refresh" content="60;url=https://docs.microsoft.com/cli/azure/">
       <title>Login successfully</title>
       <style>
           body {
               font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;
           }
   
           code {
               font-family: Consolas, 'Liberation Mono', Menlo, Courier, monospace;
               display: inline-block;
               background-color: rgb(242, 242, 242);
               padding: 12px 16px;
               margin: 8px 0px;
           }
       </style>
   </head>
   <body>
       <h3>You have logged into Microsoft Azure!</h3>
       <p>You can close this window, or we will redirect you to the <a href="https://docs.microsoft.com/cli/azure/">Azure CLI documentation</a> in 1 minute.</p>
       <h3>Announcements</h3>
       <p>[Windows only] Azure CLI is collecting feedback on using the <a href="https://learn.microsoft.com/windows/uwp/security/web-account-manager">Web Account Manager</a> (WAM) broker for the login experience.</p>
       <p>You may opt-in to use WAM by running the following commands:</p>
       <code>
           az config set core.allow_broker=true<br>
           az account clear<br>
           az login
       </code>
   </body>
   </html>
   

4. Feche o terminal atual e abra o terminal original. Você verá uma lista JSON de suas assinaturas.

5. Copie o id campo da subscrição que pretende utilizar.

6. Defina sua assinatura usando o az account set comando.

   az account set --subscription <subscription_id>