Acessar a API do Kubernetes para um cluster de hub do Kubernetes Fleet Manager do Azure

Se o recurso do Azure Kubernetes Fleet Manager (Kubernetes Fleet) foi criado com um cluster de hub, você pode usá-lo para controlar centralmente cenários como a propagação de recursos do Kubernetes. Neste artigo, você aprenderá a acessar a API do Kubernetes para um cluster de hub do Kubernetes Fleet.

Pré-requisitos

• Se não tiver uma subscrição do Azure, crie uma conta gratuita do Azure antes de começar.
• Você precisa de um recurso da Frota do Kubernetes com um cluster de hub e clusters de membros. Se você não tiver um, consulte Criar um recurso do Azure Kubernetes Fleet Manager e ingressar em clusters de membros usando a CLI do Azure.
• A identidade (usuário ou entidade de serviço) que você está usando precisa ter permissões Microsoft.ContainerService/fleets/listCredentials/action no recurso Frota do Kubernetes.

Acesse a API do Kubernetes

1. Defina as seguintes variáveis de ambiente para sua ID de assinatura, grupo de recursos e recurso de frota do Kubernetes:

   export SUBSCRIPTION_ID=<subscription-id>
   export GROUP=<resource-group-name>
   export FLEET=<fleet-name>
   

2. Defina a assinatura padrão do Azure usando o az account set comando:

   az account set --subscription ${SUBSCRIPTION_ID}
   

3. Obtenha o arquivo kubeconfig do cluster de hub do Kubernetes Fleet usando o az fleet get-credentials comando:

   az fleet get-credentials --resource-group ${GROUP} --name ${FLEET}
   

   O resultado deverá ter um aspeto semelhante ao seguinte exemplo:

   Merged "hub" as current context in /home/fleet/.kube/config
   

4. Defina a seguinte variável de ambiente para o FLEET_ID valor do recurso Kubernetes Fleet do cluster de hub:

   export FLEET_ID=/subscriptions/${SUBSCRIPTION_ID}/resourceGroups/${GROUP}/providers/Microsoft.ContainerService/fleets/${FLEET}
   

5. Autorize sua identidade para acessar o cluster de hub do Kubernetes Fleet usando os comandos a seguir.

   Para a ROLE variável de ambiente, você pode usar uma das quatro definições de função internas a seguir como o valor:

   • Azure Kubernetes Fleet Manager RBAC Reader
   • Azure Kubernetes Fleet Manager RBAC Writer
   • Azure Kubernetes Fleet Manager RBAC Admin
   • Azure Kubernetes Fleet Manager RBAC Cluster Admin

   export IDENTITY=$(az ad signed-in-user show --query "id" --output tsv)
   export ROLE="Azure Kubernetes Fleet Manager RBAC Cluster Admin"
   az role assignment create --role "${ROLE}" --assignee ${IDENTITY} --scope ${FLEET_ID}
   

   O resultado deverá ter um aspeto semelhante ao seguinte exemplo:

   {
     "canDelegate": null,
     "condition": null,
     "conditionVersion": null,
     "description": null,
     "id": "/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<GROUP>/providers/Microsoft.ContainerService/fleets/<FLEET>/providers/Microsoft.Authorization/roleAssignments/<assignment>",
     "name": "<name>",
     "principalId": "<id>",
     "principalType": "User",
     "resourceGroup": "<GROUP>",
     "roleDefinitionId": "/subscriptions/<SUBSCRIPTION_ID>/providers/Microsoft.Authorization/roleDefinitions/18ab4d3d-a1bf-4477-8ad9-8359bc988f69",
     "scope": "/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<GROUP>/providers/Microsoft.ContainerService/fleets/<FLEET>",
     "type": "Microsoft.Authorization/roleAssignments"
   }
   

6. Verifique se você pode acessar o servidor de API usando o kubectl get memberclusters comando:

   kubectl get memberclusters
   

   Se o comando for bem-sucedido, sua saída deverá ser semelhante ao exemplo a seguir:

   NAME           JOINED   AGE
   aks-member-1   True     2m
   aks-member-2   True     2m
   aks-member-3   True     2m
   

Conteúdos relacionados

• Propagar recursos de um cluster de hub do Azure Kubernetes Fleet Manager para clusters membros