Criar e configurar namespaces da frota gerenciada (versão prévia)

• Você precisa da CLI do Azure versão 2.78.0 ou posterior instalada para concluir este artigo. Para instalar ou atualizar, confira Instalar a CLI do Azure.

• Você precisa da extensão da CLI do fleet Azure versão 1.8.0 ou posterior. Você pode instalá-lo e atualizá-lo para a versão mais recente usando os comandos az extension add e az extension update.

  # Install the extension
  az extension add --name fleet
  
  # Update the extension
  az extension update --name fleet
  

• Confirme se a versão da extensão da frota é pelo menos 1.8.0 usando o az extension show comando.

  az extension show --name fleet
  

• Defina as seguintes variáveis de ambiente para sua ID de assinatura, grupo de recursos, Frota e Membro da Frota:

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

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

  az account set --subscription ${SUBSCRIPTION_ID}
  

Criar um novo namespace de Frota Gerenciada

Crie um novo Namespace da Frota Gerenciada usando o az fleet namespace create comando.

    az fleet namespace create \
        --resource-group $GROUP \
        --fleet-name $FLEET \
        --name my-managed-namespace \ 
        --annotations annotation1=value1 annotation2=value2 \
        --labels team=myTeam label2=value2 \
        --cpu-requests 1m \
        --cpu-limits 4m \
        --memory-requests 1Mi \
        --memory-limits 4Mi \
        --ingress-policy allowAll \
        --egress-policy allowAll \
        --delete-policy keep \
        --adoption-policy never

Atribuir acesso de usuário ou grupo

Agora você pode conceder acesso a um usuário para o Namespace de Frota Gerenciada em clusters membros usando uma das funções internas do Azure RBAC.

Crie uma atribuição de função usando o az role assignment create comando.

O exemplo a seguir atribui a um usuário a função RBAC Writer for Member Clusters do Azure Kubernetes Fleet Manager em qualquer cluster que receba o my-managed-namespace Managed Fleet Namespace:

az role assignment create \
    --role "Azure Kubernetes Fleet Manager RBAC Writer for Member Clusters" \
    --assignee <USER-ENTRA-ID> \
    --scope "$FLEET_ID/managedNamespaces/my-managed-namespace"

Adicionar clusters de membros

Você pode controlar em quais clusters de membros implantar o namespace gerenciado especificando a lista desejada de nomes de cluster de membros.

Especifique a lista completa de clusters de membros nos quais você deseja implantar o namespace gerenciado usando o comando az fleet namespace create com o parâmetro --member-cluster-names. O namespace gerenciado é propagado para todos os clusters na lista.

Neste exemplo, o namespace gerenciado é implantado em contoso-prd-01-fm e contoso-prd-02-fm.

az fleet namespace create \
    --resource-group $GROUP \
    --fleet-name $FLEET \
    --name my-managed-namespace \
    --member-cluster-names contoso-prd-01-fm contoso-prd-02-fm

Remover clusters de membros

Você pode remover clusters membros de um Namespace de Frota Gerenciado excluindo-os da lista de clusters membros nos quais deseja o namespace.

Especifique a lista de clusters de membros em que você deseja que o namespace gerenciado permaneça usando o az fleet namespace create comando com o --member-cluster-names parâmetro. O namespace gerenciado é removido de todos os clusters excluídos da lista.

Neste exemplo, o namespace gerenciado é removido de contoso-prd-02-fm.

az fleet namespace create \
    --resource-group $GROUP \
    --fleet-name $FLEET \
    --name my-managed-namespace \
    --member-cluster-names contoso-prd-01-fm

Exibir a configuração de um namespace de frota gerenciada

Exiba os detalhes de um Namespace de Frota Gerenciada específico usando o az fleet namespace show comando.

az fleet namespace show \ 
    --resource-group $GROUP \ 
    --fleet-name $FLEET \ 
    --name my-managed-namespace \ 
    -o table 

Sua saída deve ser parecida com o seguinte exemplo de saída:

AdoptionPolicy  DeletePolicy   ETag                                    Location   Name                  ProvisioningState   ResourceGroup
--------------  ------------   -------------------------------------   --------   --------------------  -----------------   -------------
Always          Delete         "aaaaaaaa-0b0b-1c1c-2d2d-333333333333   westus2    my-managed-namespace  Succeeded           test-rg

Excluir um Namespace de Frota Gerenciado

Exclua um Namespace da Frota Gerenciada usando o az fleet namespace delete comando.

az fleet namespace delete \
    --resource-group $GROUP \
    --fleet-name $FLEET \
    --name my-managed-namespace 

Criar um novo namespace da frota gerenciada

Você pode criar um novo Namespace da Frota Gerenciada no Fleet Manager ou por meio do Centro do Kubernetes.

Começando no Fleet Manager:

• No portal do Azure, navegue até o recurso do Gerenciador de Frota de Kubernetes do Azure.
• No menu à esquerda, em Recursos da Frota, selecione Namespaces.
• No menu, selecione + Criar e, em seguida, Namespace da Frota Gerenciada.

Começando no Centro do Kubernetes:

• Abra o Centro do Kubernetes – Namespaces gerenciados no portal do Azure.
• No menu, selecione + Criar e, em seguida, Namespace da Frota Gerenciada.
• Selecione uma assinatura e uma instância de Fleet Manager.

• Selecione uma das seguintes opções para Escopo:
  • Novo – crie um novo namespace do Kubernetes que não existe no cluster do Hub do Fleet Manager. Insira um nome para o novo namespace.
  • Converter para Gerenciado – use um namespace existente do Kubernetes no cluster de hub do Fleet Manager. Selecione o Namespace na lista de namespaces no cluster do hub do Fleet Manager.

Atribuir acesso de usuário ou grupo

Selecione os usuários e grupos do Microsoft Entra que acessam o Namespace da Frota Gerenciada em clusters aos quais ele é distribuído.

Adicionar políticas de rede e cota de computação

Controle o fluxo de tráfego de rede para dentro e fora do namespace em cada cluster para o qual ele é distribuído, juntamente com a definição das cotas de recursos de CPU e memória para o namespace.

Selecionar clusters de membros

Defina a quais clusters de membros distribuir o namespace gerenciado adicionando-os da seguinte maneira.

• No menu, selecione + Adicionar.
• Na caixa de diálogo Selecionar clusters membro, pesquise os clusters membros e selecione-os marcando a caixa correspondente.
• Por fim, escolha Selecionar para adicionar os clusters de membros.

Definir rótulos, anotações e marcas

Defina rótulos e anotações opcionais do Kubernetes, bem como tags do Azure Resource Manager (ARM), que fornecem metadados utilizáveis para automação e gerenciamento de recursos.

Criar o namespace da frota gerenciada

Depois de configurar todas as propriedades para o novo Namespace da Frota Gerenciada, você poderá confirmar os detalhes antes de criar o namespace selecionando Criar.

Uma implantação do Azure Resource Manager é iniciada imediatamente, o que inicia um posicionamento de carga de trabalho do Fleet Manager para distribuir o namespace para os clusters selecionados.

Depois que a implantação for concluída, você poderá encontrar o Namespace da Frota Gerenciada na lista de namespaces do Fleet Manager.

Para revisar a implementação do namespace do Kubernetes em todos os clusters, use Posicionamentos de recursos, procurando o posicionamento do recurso denominado o mesmo que o Namespace da Frota Gerenciada.

Configurar o namespace da frota gerenciada existente

Você pode localizar o Namespace da Frota Gerenciada no Gerenciador de Frotas ou por meio do centro do Kubernetes.

Começando no Fleet Manager:

• No portal do Azure, navegue até o recurso do Gerenciador de Frota de Kubernetes do Azure.
• No menu à esquerda, em Recursos da Frota, selecione Namespaces.

Começando no Centro do Kubernetes:

• Abra o Centro do Kubernetes – Namespaces gerenciados no portal do Azure.
• Defina o filtro Tipo como Namespace da Frota Gerenciada.

Modificar a configuração

Modifique políticas de rede, cotas de recursos, rótulos, anotações e marcas selecionando editar ao lado do item apropriado na tela de visão geral do Namespace da Frota Gerenciada.

Selecionar editar ao lado de rótulos, anotações ou marcas abre uma caixa de diálogo em que você pode modificar qualquer um desses três itens.

Selecionar a edição ao lado de qualquer uma das opções de cota de recurso ou política de rede abre uma caixa de diálogo na qual você pode modificar qualquer um desses itens.

Modificar o acesso de usuário ou grupo

Um Namespace Gerenciado da Frota é um recurso do ARM (Gerenciador de Recursos do Azure); portanto, o gerenciamento do acesso de usuários e grupos pode ser feito ao selecionar controle de acesso (IAM) na tela de visão geral, na navegação à esquerda do Namespace Gerenciado da Frota.

Modificar clusters de membros

Na visão geral do Namespace da Frota Gerenciada, selecione Clusters membro na navegação à esquerda.

Para remover clusters de membros:

• Selecione os clusters a serem removidos marcando a caixa de seleção à esquerda da linha.
• Na navegação superior, selecione Remover.
• Confirme a ação e selecione Remover.

Para adicionar clusters de membros:

• No menu, selecione + Adicionar.
• Na caixa de diálogo Adicionar clusters membro, pesquise os clusters membros e selecione-os marcando a caixa correspondente.
• Por fim, escolha Adicionar para adicionar os clusters de membro.

Depois que os clusters que hospedam o Namespace da Frota Gerenciada são modificados, a visão geral é atualizada para exibir os clusters que hospedam ativamente o namespace.

Excluir um Namespace de Frota Gerenciado

Na visão geral do Namespace da Frota Gerenciada, selecione Excluir na navegação superior.

Na confirmação de Excluir Namespace da Frota Gerenciada, selecione a opção desejada:

• Mantenha o namespace, remova os recursos de gerenciamento: o Namespace da Frota Gerenciada é convertido em um namespace do Kubernetes padrão, permanecendo no cluster do hub do Fleet Manager e nos clusters de membros, mas não é mais gerenciado pelo ARM (Azure Resource Manager).
• Exclua o namespace e todos os recursos associados: o recurso ARM do Namespace da Frota Gerenciada é excluído, juntamente com o namespace do Kubernetes no cluster do Hub do Fleet Manager e nos clusters membros.