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

  • Artigo

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

Quando um cluster do Serviço de Kubernetes do Azure (AKS) é anexado ao Azure Arc, ele obtém uma representação do Gerenciador de Recursos do Azure. 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 que você estenda os seguintes recursos para o cluster do Kubernetes:

  • Serviços de gerenciamento: configurações (GitOps), Azure Monitor para contêineres, Política do Azure (Gatekeeper).
  • Serviços de dados: SQL Managed Instance, PostgreSQL Hyperscale.
  • Serviços de aplicativos: 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 suporta SSL padrão da indústria para proteger 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 AKS ao Azure Arc no AKS habilitado pelo Arc. Você pode ignorar essas etapas se já tiver conectado seu cluster do Kubernetes ao Azure Arc usando o Windows Admin Center.

Antes de começar

Verifique se você tem os seguintes requisitos:

  • Um cluster AKS com pelo menos um nó de trabalho Linux que está em funcionamento.
  • 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 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 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 PowerShell:

Connect-AzAccount $tenantId

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

Set-AzContext -Subscription $subscriptionId

Etapa 2: Registrar os dois provedores para AKS

Você pode pular esta etapa se já tiver registrado os dois provedores para 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 PowerShell

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

Enable-AksHciArcConnection -name $clusterName

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

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

O primeiro comando solicita as credenciais da entidade de serviço e as armazena $Credential na 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 senha. Certifique-se de obter esses valores do administrador da assinatura. O segundo comando conecta seu 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.

Conecte seu cluster AKS ao Azure Arc e habilite 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 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 seu 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 AKS baseado 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 AKS no portal do Azure.

Agentes do Azure Arc para Kubernetes

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

kubectl -n azure-arc get deployments,pods

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

Desconectar seu cluster AKS do Azure Arc

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

Disable-AksHciArcConnection -Name $clusterName

Próximas etapas