Compartilhar via

Conectar um cluster do Serviço de Kubernetes do Azure ao Azure Arc

  • Artigo

Aplica-se a: AKS no Azure Stack HCI 22H2, AKS no Windows Server

Quando um cluster do AKS (Serviço de Kubernetes do Azure) é anexado ao Azure Arc, ele obtém uma representação do Azure Resource Manager. Os clusters são anexados a assinaturas do Azure padrão, estão localizados em um grupo de recursos e podem receber marcas, assim como qualquer outro recurso do Azure. Além disso, a representação do Kubernetes permite estender os seguintes recursos para o cluster do Kubernetes:

  • Serviços de gerenciamento: configurações (GitOps), Azure Monitor para contêineres, Azure Policy (Gatekeeper).
  • Serviços de dados: Instância Gerenciada de SQL, Hiperescala do PostgreSQL.
  • Serviços de aplicativo: Serviço de Aplicativo, Funções, Grade de Eventos, Aplicativos Lógicos, Gerenciamento de API.

Para conectar um cluster do Kubernetes ao Azure, o administrador do cluster deve implantar agentes. Esses agentes são executados em um namespace do Kubernetes chamado azure-arc e são implantações padrão do Kubernetes. Os agentes são responsáveis pela conectividade com o Azure, coletando logs e métricas do Azure Arc e habilitando os cenários mencionados anteriormente no cluster.

O AKS dá suporte ao SSL padrão do setor para proteger os dados em trânsito. Além disso, os dados são armazenados criptografados quando em repouso em um banco de dados Azure Cosmos DB para garantir a confidencialidade dos dados.

As etapas a seguir descrevem como conectar clusters do AKS ao Azure Arc no AKS habilitado pelo Arc. Você pode ignorar essas etapas se já conectou o cluster do Kubernetes ao Azure Arc usando o Windows Admin Center.

Antes de começar

Verifique se você tem os seguintes requisitos:

  • Um cluster do AKS com pelo menos um nó de trabalho do Linux em execução.
  • Instale o módulo AksHci PowerShell.
  • O seguinte nível de acesso em sua assinatura do Azure:
    • Uma conta de usuário com a função de Proprietário interna. Você pode verificar seu nível de acesso navegando até sua assinatura, selecionando "Controle de acesso (IAM)" no lado esquerdo do portal do Azure e clicando em Exibir meu acesso.
    • Uma entidade de serviço com a função de Proprietário interna.
  • Execute os comandos neste artigo em uma janela administrativa do PowerShell.
  • Verifique se você atende aos requisitos de rede do AKS.

Etapa 1: Entrar no Azure

Para entrar no Azure, execute o comando Connect-AzAccount do PowerShell:

Connect-AzAccount $tenantId

Se você quiser alternar para uma assinatura diferente, execute o comando Set-AzContext do PowerShell:

Set-AzContext -Subscription $subscriptionId

Etapa 2: Registrar os dois provedores para o AKS

Você pode ignorar esta etapa se já tiver registrado os dois provedores do AKS em sua assinatura. O registro é um processo assíncrono e precisa ocorrer uma vez por assinatura. O registro pode levar aproximadamente 10 minutos:

Register-AzResourceProvider -ProviderNamespace Microsoft.Kubernetes
Register-AzResourceProvider -ProviderNamespace Microsoft.KubernetesConfiguration
Register-AzResourceProvider -ProviderNamespace Microsoft.ExtendedLocation

Você pode verificar se está registrado com os seguintes comandos:

Get-AzResourceProvider -ProviderNamespace Microsoft.Kubernetes
Get-AzResourceProvider -ProviderNamespace Microsoft.KubernetesConfiguration
Get-AzResourceProvider -ProviderNamespace Microsoft.ExtendedLocation

Etapa 3: Conectar-se ao Azure Arc usando o módulo Aks-HCI do PowerShell

Conecte o cluster do AKS ao Kubernetes usando o comando Enable-AksHciArcConnection do PowerShell. Esta etapa implanta agentes do Azure Arc para Kubernetes no azure-arc namespace:

Enable-AksHciArcConnection -name $clusterName

Conectar o cluster do AKS ao Azure Arc usando uma entidade de serviço

Se você não tiver acesso a uma assinatura na qual você é um Proprietário, poderá conectar seu cluster do AKS ao Azure Arc usando uma entidade de serviço.

O primeiro comando solicita credenciais da entidade de serviço e as armazena na $Credential variável. Quando solicitado, insira a ID do aplicativo para o nome de usuário e use o segredo da entidade de serviço como a senha. Certifique-se de obter esses valores do administrador da assinatura. O segundo comando conecta o cluster ao Azure Arc usando as credenciais da entidade de serviço armazenadas na $Credential variável:

$Credential = Get-Credential
Enable-AksHciArcConnection -name $clusterName -subscriptionId $subscriptionId -resourceGroup $resourceGroup -credential $Credential -tenantId $tenantId -location $location

Verifique se a entidade de serviço usada neste comando tem a função Proprietário atribuída a ela e se ela tem escopo sobre a ID de assinatura usada no comando. Para obter mais informações sobre entidades de serviço, consulte Criar uma entidade de serviço com o Azure PowerShell.

Conectar o cluster do AKS ao Azure Arc e habilitar locais personalizados

Se você quiser habilitar locais personalizados em seu cluster junto com o Azure Arc, execute o seguinte comando para obter a ID do objeto do aplicativo de local personalizado e, em seguida, conecte-se ao Azure Arc usando uma entidade de serviço:

$objectID = (Get-AzADServicePrincipal -ApplicationId "00001111-aaaa-2222-bbbb-3333cccc4444").Id
Enable-AksHciArcConnection -name $clusterName -subscriptionId $subscriptionId -resourceGroup $resourceGroup -credential $Credential -tenantId $tenantId -location -customLocationsOid $objectID

Verificar o cluster conectado

Você pode exibir o recurso de cluster do Kubernetes no portal do Azure. Depois de abrir o portal no navegador, navegue até o grupo de recursos e o recurso do AKS com base nas entradas de nome do recurso e nome do grupo de recursos usadas no comando enable-akshciarcconnection do PowerShell.

Observação

Depois de conectar o cluster, pode levar no máximo de cinco a dez minutos para que os metadados do cluster (versão do cluster, versão do agente, número de nós) apareçam na página de visão geral do recurso do AKS no portal do Azure.

Agentes do Azure Arc para Kubernetes

O AKS implanta alguns operadores no azure-arc namespace. Você pode exibir essas implantações e pods com kubectl, conforme mostrado no exemplo a seguir:

kubectl -n azure-arc get deployments,pods

O AKS consiste em alguns agentes (operadores) que são executados no cluster implantado no azure-arc namespace. Para obter mais informações sobre esses agentes, consulte esta visão geral.

Desconectar o cluster do AKS do Azure Arc

Se você quiser desconectar o cluster do AKS, execute o comando Disable-AksHciArcConnection do PowerShell. Certifique-se de entrar no Azure antes de executar o comando:

Disable-AksHciArcConnection -Name $clusterName

Próximas etapas