Início Rápido: Crie um recurso Gerenciador de Frota de Kubernetes do Azure e junte-se a clusters de membros utilizando o CLI do Azure

Artigo
10/15/2024

Introdução ao Gerenciador de Frota de Kubernetes do Azure (Frota) usando a CLI do Azure para criar um recurso da Frota e conectar clusters do AKS (Serviço de Kubernetes do Azure) posteriormente como clusters membros.

Pré-requisitos

Caso você não tenha uma assinatura do Azure, crie uma conta gratuita do Azure antes de começar.

Leia o artigo de visão geral conceitual sobre esse recurso, que fornece uma explicação sobre as frotas e clusters de membros referenciados neste documento.
Leia a visão geral conceitual dos tipos de frota, que fornece uma comparação de diferentes opções de configuração de frota.
Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.
Uma identidade (usuário ou entidade de serviço) que pode ser usada para fazer login na CLI do Azure. Essa identidade precisa ter as seguintes permissões nos tipos de recursos Frota e AKS para concluir as etapas listadas neste início rápido:
- Microsoft.ContainerService/fleets/read
- Microsoft.ContainerService/fleets/write
- Microsoft.ContainerService/fleets/members/read
- Microsoft.ContainerService/fleets/members/write
- Microsoft.ContainerService/fleetMemberships/read
- Microsoft.ContainerService/fleetMemberships/write
- Microsoft.ContainerService/managedClusters/read
- Microsoft.ContainerService/managedClusters/write
Instale ou atualize a CLI do Azure para a versão 2.53.1 ou posterior.
Instale a extensão Frota CLI do Azure usando o comando az extension add e certifique-se de que sua versão seja pelo menos1.0.0.
```
az extension add --name fleet
```

Defina as seguintes variáveis de ambiente:

export SUBSCRIPTION_ID=<subscription_id>
export GROUP=<your_resource_group_name>
export FLEET=<your_fleet_name>

Instale kubectl e kubelogin use o comando az aks install-cli.
```
az aks install-cli
```
Os clusters AKS que pretende juntar como clusters membros ao recurso Fleet precisam de estar dentro das versões suportadas do AKS. Saiba mais sobre a política de suporte à versão do AKS aqui.

Criar um grupo de recursos

Um grupo de recursos do Azure é um grupo lógico no qual os recursos do Azure são implantados e gerenciados. Ao criar um grupo de recursos, você é solicitado a especificar um local. Esse local é o local de armazenamento dos metadados do seu grupo de recursos e onde os seus recursos são executados no Azure se não especificar outro local durante a criação de recursos.

Defina a assinatura do Azure e crie um grupo de recursos usando o comando az group create.

az account set -s ${SUBSCRIPTION_ID}
az group create --name ${GROUP} --location eastus

O exemplo de saída a seguir é semelhante à criação bem-sucedida do grupo de recursos:

{
  "id": "/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/fleet-demo",
  "location": "eastus",
  "managedBy": null,
  "name": "fleet-demo",
  "properties": {
    "provisioningState": "Succeeded"
  },
  "tags": null,
  "type": "Microsoft.Resources/resourceGroups"
}

Criar um recurso da Frota

Você pode criar um recurso de frota para agrupar posteriormente seus clusters AKS como clusters membros. Quando criado através do CLI do Azure, por padrão, esse recurso permite o agrupamento de clusters de membros e a orquestração de atualizações. Se o hub Frota estiver habilitado, outra versão prévia do recurso será habilitado, como propagação de objeto Kubernetes para clusters membros e balanceamento de carga de serviço L4 em vários clusters membros. Para obter mais informações, veja a visão geral conceitual dos tipos de frota, que fornece uma comparação de diferentes configurações de frota.

Importante

Depois que um recurso da Frota Kubernetes for criado, será possível atualizar um recurso da Frota Kubernetes sem um cluster de hub para um com cluster de hub. Para recursos do Kubernetes Fleet com um cluster de hub, depois que privado ou público for selecionado, ele não poderá ser alterado.

Recurso Kubernetes Fleet sem cluster de hub
Recurso Kubernetes Fleet com cluster de hub

Se quiser utilizar a Frota apenas para orquestração de atualização, que é a experiência padrão ao criar um novo recurso da Frota através do CLI do Azure, pode criar um recurso da Frota sem o cluster do hub utilizando o comando az fleet create.

az fleet create --resource-group ${GROUP} --name ${FLEET} --location eastus

Seu resultado deve ser semelhante ao seguinte exemplo de saída:

{
  "etag": "...",
  "hubProfile": null,
  "id": "/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/fleet-demo/providers/Microsoft.ContainerService/fleets/fleet-demo",
  "identity": {
    "principalId": null,
    "tenantId": null,
    "type": "None",
    "userAssignedIdentities": null
  },
  "location": "eastus",
  "name": "fleet-demo",
  "provisioningState": "Succeeded",
  "resourceGroup": "fleet-demo",
  "systemData": {
    "createdAt": "2023-11-03T17:15:19.610149+00:00",
    "createdBy": "<user>",
    "createdByType": "User",
    "lastModifiedAt": "2023-11-03T17:15:19.610149+00:00",
    "lastModifiedBy": "<user>",
    "lastModifiedByType": "User"
  },
  "tags": null,
  "type": "Microsoft.ContainerService/fleets"
}

Se você quiser usar a propagação de objetos do Fleet for Kubernetes e o balanceamento de carga de vários clusters, além da orquestração de atualização, será necessário criar o recurso Fleet com o cluster de hub habilitado, especificando o parâmetro --enable-hub com o comando az fleet create.

Os clusters do Kubernetes Fleet com um cluster hub oferecem suporte aos modos público e privado para acesso à rede. Para obter mais informações, consulte [Escolha uma opção do Gerenciador de Frota de Kubernetes do Azure](./concepts-choosing-fleet.md#network-access-modes-for-hub-cluster.

Observação

Por padrão, os recursos do Kubernetes Fleet com clusters de hub são públicos e o Fleet escolherá o SKU da VM usado para o nó do hub (nesse momento, ele tenta "Standard_D4s_v4", "Standard_D4s_v3", "Standard_D4s_v5", "Standard_Ds3_v2", "Standard_E4as_v4" em ordem). Se nenhuma dessas opções for aceitável ou disponível, você poderá selecionar um SKU de VM definindo --vm-size <SKU>.

Cluster de hub público

Para criar um recurso público do Kubernetes Fleet com um cluster de hub, use o comando az fleet create com o sinalizador --enable-hub definido.

az fleet create --resource-group ${GROUP} --name ${FLEET} --location eastus --enable-hub

Seu resultado deve ser semelhante ao seguinte exemplo de saída:

{
  "etag": "...",
  "hubProfile": null,
  "id": "/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/fleet-demo/providers/Microsoft.ContainerService/fleets/fleet-demo",
  "identity": {
    "principalId": null,
    "tenantId": null,
    "type": "None",
    "userAssignedIdentities": null
  },
  "location": "eastus",
  "name": "fleet-demo",
  "provisioningState": "Succeeded",
  "resourceGroup": "fleet-demo",
  "systemData": {
    "createdAt": "2023-11-03T17:15:19.610149+00:00",
    "createdBy": "<user>",
    "createdByType": "User",
    "lastModifiedAt": "2023-11-03T17:15:19.610149+00:00",
    "lastModifiedBy": "<user>",
    "lastModifiedByType": "User"
  },
  "tags": null,
  "type": "Microsoft.ContainerService/fleets"
}

Cluster de hub privado

Ao criar um recurso de Frota Kubernetes de modo de acesso privado com um cluster de hub, algumas considerações extras se aplicam:

O Fleet exige que você forneça a sub-rede na qual as VMs do nó do cluster do hub do Fleet serão colocadas. Você pode especificar isso no momento da criação, definindo --agent-subnet-id <subnet>. Esse comando difere daquele que você usa para trabalhar diretamente com um cluster AKS privado, pois é um argumento necessário para o Fleet, mas não para o AKS.
O prefixo de endereço da vnet cuja sub-rede é passada por --vnet-subnet-id não deve se sobrepor ao intervalo de serviço padrão do AKS de 10.0.0.0/16.
Ao utilizar um cluster privado AKS, tem a capacidade de configurar nomes de domínio totalmente qualificados (FQDNs) e subdomínios FQDN. Essa funcionalidade não se aplica ao cluster de hub do tipo modo de acesso privado.

Primeiro, crie uma rede virtual e uma sub-rede para as VMs do nó do cluster de hub usando os comandos az network vnet create e az network vnet subnet create.

az network vnet create --resource-group ${GROUP} --name vnet --address-prefixes 192.168.0.0/16
az network vnet subnet create --resource-group ${GROUP} --vnet-name vnet --name subnet --address-prefixes 192.168.0.0/24

SUBNET_ID=$(az network vnet subnet show --resource-group ${GROUP} --vnet-name vnet -n subnet -o tsv --query id)

Para criar um recurso Kubernetes Fleet em modo de acesso privado, use az fleet createcommand com o sinalizador --enable-private-cluster e forneça o ID da sub-rede obtido na etapa anterior ao argumento --agent-subnet-id <subnet>.

az fleet create --resource-group ${GROUP} --name ${FLEET} --enable-hub --enable-private-cluster --agent-subnet-id "${SUBNET_ID}"

Ingressar em clusters membros

Atualmente, a Frota dá suporte ao ingresso de clusters AKS existentes como clusters de membros.

Configure as seguintes variáveis de ambiente para clusters membros:

export MEMBER_NAME_1=aks-member-1
export MEMBER_CLUSTER_ID_1=/subscriptions/${SUBSCRIPTION_ID}/resourceGroups/${GROUP}/providers/Microsoft.ContainerService/managedClusters/${MEMBER_NAME_1}

Junte os seus clusters AKS existentes ao recurso Fleet utilizando o comando az fleet member create.

# Join the first member cluster
az fleet member create --resource-group ${GROUP} --fleet-name ${FLEET} --name ${MEMBER_NAME_1} --member-cluster-id ${MEMBER_CLUSTER_ID_1}

Seu resultado deve ser semelhante ao seguinte exemplo de saída:

{
  "clusterResourceId": "/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<GROUP>/providers/Microsoft.ContainerService/managedClusters/aks-member-x",
  "etag": "...",
  "id": "/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<GROUP>/providers/Microsoft.ContainerService/fleets/<FLEET>/members/aks-member-x",
  "name": "aks-member-1",
  "provisioningState": "Succeeded",
  "resourceGroup": "<GROUP>",
  "systemData": {
    "createdAt": "2022-10-04T19:04:56.455813+00:00",
    "createdBy": "<user>",
    "createdByType": "User",
    "lastModifiedAt": "2022-10-04T19:04:56.455813+00:00",
    "lastModifiedBy": "<user>",
    "lastModifiedByType": "User"
  },
  "type": "Microsoft.ContainerService/fleets/members"
}

Verifique se os clusters membros ingressaram com êxito no recurso Fleet usando o comando az fleet member list.

az fleet member list --resource-group ${GROUP} --fleet-name ${FLEET} -o table

Se for bem-sucedido, sua saída deverá ser semelhante ao seguinte exemplo de saída:

ClusterResourceId                                                                                                                                Name          ProvisioningState    ResourceGroup
-----------------------------------------------------------------------------------------------------------------------------------------------  ------------  -------------------  ---------------
/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<GROUP>/providers/Microsoft.ContainerService/managedClusters/aks-member-1  aks-member-1  Succeeded            <GROUP>
/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<GROUP>/providers/Microsoft.ContainerService/managedClusters/aks-member-2  aks-member-2  Succeeded            <GROUP>
/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<GROUP>/providers/Microsoft.ContainerService/managedClusters/aks-member-3  aks-member-3  Succeeded            <GROUP>

Próximas etapas

Acesse a API Kubernetes do recurso de frota.

Compartilhar via

Início Rápido: Crie um recurso Gerenciador de Frota de Kubernetes do Azure e junte-se a clusters de membros utilizando o CLI do Azure

Pré-requisitos

Criar um grupo de recursos

Criar um recurso da Frota

Cluster de hub público

Cluster de hub privado

Ingressar em clusters membros

Próximas etapas

Recursos adicionais