Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Aplica-se a: ✔️ Gerenciador de Frota com cluster do hub
Este artigo mostra como usar o Fleet Manager para criar e configurar um Namespace da Frota Gerenciada que define cotas de recursos, políticas de rede e acesso de usuário delegado para os namespaces em vários clusters.
Se você estiver procurando exibir ou acessar namespaces de frota gerenciada existentes aos quais você tem acesso, consulte exibir e acessar namespaces da frota gerenciada.
Limitações conhecidas
- Quando um Namespace de Frota Gerenciado adota um único cluster Namespace do Kubernetes Gerenciado ou vice-versa, pode haver conflito de propriedade. Para evitar, use uma política de exclusão de
keeppara os Namespaces Gerenciados de Frota e do Kubernetes. - Os clusters devem ser membros gerenciados pelo Fleet Manager que hospeda o Namespace da Frota Gerenciada.
- Os clusters devem ter uma versão do Kubernetes de pelo menos 1.30.0. Os clusters abaixo dessa versão não impedirão que os usuários no cluster modifiquem os recursos do Kubernetes colocados.
- As funções do RBAC atribuídas a um escopo de Namespace de Frota Gerenciada concedem acesso equivalente a quaisquer namespaces de Kubernetes não gerenciados com o mesmo nome em clusters membros.
Antes de começar
- Você precisa de uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.
- Você precisa de um Fleet Manager com um cluster de hubs. Caso você não tenha uma, veja Criar e unir pelo menos um cluster do AKS (Serviço de Kubernetes do Azure) à frota.
- Verifique se o usuário que está executando as etapas tem a função Administrador de controle de acesso baseado em função atribuída para o Fleet Manager.
- Entenda o conceito de Namespace de Frota Gerenciado lendo a visão geral.
Você precisa ter o CLI do Azure instalado para verificar o namespace do Managed Fleet que o Terraform cria. Para instalar ou atualizar, confira Instalar a CLI do Azure.
Você precisa da
fleetextensão da CLI do Azure versão 1.8.0 ou superior para verificar o namespace da Frota Gerenciada. Você pode instalá-lo e atualizá-lo para a versão mais recente usando os comandosaz extension updateeaz extension add.az extension add --name fleet az extension update --name fleetSe você ainda não tiver um Fleet Manager com um cluster de hub, a primeira parte deste artigo criará uma para você usando um exemplo e um estado do Terraform separados do exemplo de Namespace da Frota Gerenciada. Se você já tiver um namespace, anote o grupo de recursos e o nome do Fleet Manager e pule para Criar o namespace de frota gerenciada com Terraform.
O exemplo de pré-requisitos do Terraform cria apenas um gerenciador de frota e um cluster hub; ele não cria nem adiciona nenhum cluster membro. Você pode criar um namespace de frota gerenciada e exibir sua configuração sem nenhum cluster membro associado, mas, para verificar se o namespace realmente é implantado (propagado) em um cluster membro, é necessário ter pelo menos um cluster do AKS associado à Frota. Se você não tiver um, consulte as instruções para criar e adicionar à frota pelo menos um cluster do AKS (Serviço de Kubernetes do Azure) usando as orientações compatíveis existentes.
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
fleetAzure versão 1.8.0 ou posterior. Você pode instalá-lo e atualizá-lo para a versão mais recente usando os comandosaz extension addeaz extension update.# Install the extension az extension add --name fleet # Update the extension az extension update --name fleetConfirme se a versão da extensão da frota é pelo menos 1.8.0 usando o
az extension showcomando.az extension show --name fleetDefina 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 setcomando.az account set --subscription ${SUBSCRIPTION_ID}
Criar um novo namespace da 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
Observação
Essas configurações são opcionais: políticas de rede, cota de computação, política de exclusão e adoção, rótulos e anotações.
Ao usar políticas de rede, os usuários com uma ação Microsoft.ContainerService/managedClusters/networking.k8s.io/networkpolicies/write, como Serviço de Kubernetes do Azure RBAC Writer, na função atribuída do Microsoft Entra ID, podem adicionar mais políticas de rede por meio da API do Kubernetes.
Por exemplo, se um administrador aplicar uma Deny All política para entrada/saída e um usuário aplicar uma Allow política para um namespace por meio da API do Kubernetes, a Allow política tem prioridade sobre a Deny All política, e o tráfego é permitido para o namespace. Esse comportamento aditivo é padrão para políticas de rede.
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
Configurar um namespace de frota gerenciada existente
Você pode modificar políticas de rede, cotas de recursos, rótulos e anotações em um Namespace de Frota Gerenciada existente usando o az fleet namespace create comando com valores de parâmetro atualizados. O comando executa uma operação upsert, atualizando o namespace se ele já existir.
Importante
Ao atualizar um namespace gerenciado existente, você deve especificar todos os parâmetros que deseja reter, mesmo que não os esteja alterando. Todos os parâmetros que você omitir são redefinidos para seus valores padrão. Isso inclui políticas de rede, cotas de recursos, etiquetas, anotações, política de exclusão, política de adoção e nomes de clusters membros.
O exemplo a seguir atualiza as políticas de rede, cotas de recursos, rótulos e anotações de um namespace gerenciado existente:
az fleet namespace create \
--resource-group $GROUP \
--fleet-name $FLEET \
--name my-managed-namespace \
--annotations "updated-annotation=new-value" \
--labels "team=updatedTeam environment=production" \
--cpu-requests 1000m \
--cpu-limits 2000m \
--memory-requests 1000Mi \
--memory-limits 1000Mi \
--ingress-policy allowAll \
--egress-policy allowAll \
--delete-policy keep \
--adoption-policy never \
--member-cluster-names contoso-prd-01-fm contoso-prd-02-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
Aviso
A exclusão de um Namespace Gerenciado de Frota com uma DeletePolicy configurada para delete é uma ação permanente. Se não tiver certeza, você deve atualizar a política para keep para manter o namespace.
As atribuições de RBAC do Azure são sempre excluídas para evitar permissões pendentes.
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.
Observação
Esta etapa é opcional. Você pode criar e distribuir um Namespace da Frota Gerenciada sem atribuir usuários ou grupos. Isso permite que você distribua o namespace sem conceder acesso imediatamente.
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.
Observação
Essas configurações são opcionais. Você pode criar e distribuir um Namespace da Frota Gerenciada sem políticas de rede ou controles de cota aplicados.
Os usuários com uma ação Microsoft.ContainerService/managedClusters/networking.k8s.io/networkpolicies/write, como Serviço de Kubernetes do Azure RBAC Writer, na função do Microsoft Entra ID atribuída podem adicionar mais políticas de rede por meio da API do Kubernetes.
Por exemplo, se um administrador aplicar uma Deny All política para entrada/saída e um usuário aplicar uma Allow política para um namespace por meio da API do Kubernetes, a Allow política tem prioridade sobre a Deny All política, e o tráfego é permitido para o namespace. Esse comportamento aditivo é padrão para políticas de rede.
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 de membros, pesquise os clusters de membros e selecione-os marcando a caixa.
- Por fim, escolha Selecionar para adicionar os clusters de membros.
Observação
Esta etapa é opcional. Se você não fornecer nenhum cluster membro, o Namespace de Frota Gerenciada será implantado somente no cluster central do Gerenciador de Frota. Você pode adicionar clusters de membros posteriormente.
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.
Observação
Esta etapa é opcional. Você pode gerenciar rótulos, anotações e marcas posteriormente.
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 distribuição do namespace do Kubernetes em clusters, use Posicionamentos de recursos, e procure o posicionamento do recurso com o mesmo nome que o Namespace da Frota Gerenciada.
Configurar um namespace de frota gerenciada existente
Você pode localizar um namespace de frota gerenciada no Fleet Manager ou pelo Kubernetes Center.
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 de membros, procure os clusters de membros e selecione-os marcando a caixa.
- 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.
Aviso
Excluir o namespace e todos os recursos associados é uma ação permanente. Se você não tiver certeza, deverá optar por manter o namespace.
Em ambos os casos, as atribuições de RBAC do Azure são excluídas para evitar permissões pendentes.
Criar um novo namespace da frota gerenciada
Os exemplos do Terraform nesta seção estão divididos em dois diretórios, cada um com seu próprio estado do Terraform: um exemplo de pré-requisitos que cria um Fleet Manager com um cluster de hub e um exemplo de cenário que cria o Managed Fleet Namespace em um Fleet Manager existente. Mantendo o Fleet Manager e o Namespace da Frota Gerenciada em estados separados, você pode criar um Namespace de Frota Gerenciada em relação a qualquer Gerenciador de Frotas existente com um cluster de hub. Essa configuração funciona se você criou ou não o Fleet Manager usando o Terraform. Você pode destruir um Namespace da Frota Gerenciada sem afetar o Gerenciador de Frotas ou quaisquer outros Namespaces da Frota Gerenciada nele.
Criar um Fleet Manager com um cluster de hub
Se você já tiver um Fleet Manager com um cluster de hub, pule para Criar o Namespace da Frota Gerenciada com o Terraform e use seu grupo de recursos e o nome do Fleet Manager nessa seção.
Observação
O código de exemplo desta seção está localizado no repositório Azure Terraform GitHub. Exiba o arquivo de log que contém os resultados do teste das versões atuais e anteriores do Terraform.
Veja mais artigos e exemplos de código mostrando como usar o Terraform para gerenciar recursos do Azure.
Crie um diretório no qual testar o código terraform de exemplo e torná-lo o diretório atual. Use um diretório separado daquele que você usará para o exemplo de namespace da frota gerenciada mais adiante neste artigo, pois cada exemplo mantém seu próprio estado do Terraform.
Crie um arquivo chamado
providers.tf, depois insira o código a seguir:terraform { required_version = ">= 1.5.0" required_providers { azurerm = { source = "hashicorp/azurerm" version = "~> 4.0" } azapi = { source = "Azure/azapi" version = "~> 2.0" } random = { source = "hashicorp/random" version = "~> 3.0" } } } provider "azurerm" { features {} } provider "azapi" {}Crie um arquivo chamado
variables.tf, depois insira o código a seguir:variable "resource_group_location" { type = string default = "eastus" description = "Location of the resource group" } variable "resource_group_name_prefix" { type = string default = "rg" description = "Prefix of the resource group name that's combined with a random ID so name is unique in your Azure subscription." } variable "fleet_name" { type = string description = "Name of the fleet resource. If left blank, this value is randomly generated." default = "" }Crie um arquivo chamado
main.tf, depois insira o código a seguir:resource "random_pet" "rg_name" { prefix = var.resource_group_name_prefix } resource "azurerm_resource_group" "fleet_rg" { name = random_pet.rg_name.id location = var.resource_group_location } resource "random_string" "fleet_name" { length = 54 lower = true numeric = false special = false upper = false } locals { fleet_name = coalesce(var.fleet_name != "" ? var.fleet_name : null, random_string.fleet_name.result) } # A fleet with a hub cluster is required for features such as managed namespaces, # which the plain azurerm_kubernetes_fleet_manager resource cannot provision because # its hub_profile attribute is deprecated and is no longer sent to the API. resource "azapi_resource" "fleet" { type = "Microsoft.ContainerService/fleets@2025-03-01" name = local.fleet_name location = azurerm_resource_group.fleet_rg.location parent_id = azurerm_resource_group.fleet_rg.id body = { properties = { hubProfile = { dnsPrefix = local.fleet_name } } } identity { type = "SystemAssigned" } response_export_values = ["name"] }Crie um arquivo chamado
outputs.tf, depois insira o código a seguir:output "resource_group_name" { value = azurerm_resource_group.fleet_rg.name } output "fleet_name" { value = azapi_resource.fleet.name }
O exemplo cria um grupo de recursos e um Fleet Manager com um cluster de hub usando o tipo de recurso azapi_resource em vez de azurerm_kubernetes_fleet_manager, porque o atributo hub_profile do provedor azurerm foi descontinuado e a API do Fleet não o aceita mais. Se você não definir a variável, o fleet_name Terraform gerará um nome aleatório para você.
Execute terraform init para inicializar a implantação do Terraform. Esse comando baixa os provedores de Azure necessários para gerenciar seus recursos de Azure.
terraform init
Execute o terraform fmt para formatar os arquivos de configuração de forma consistente.
terraform fmt
Execute terraform validate para confirmar que os arquivos de configuração são sintaticamente válidos.
terraform validate
Execute o comando terraform plan para criar um plano de execução.
terraform plan -out main.tfplan
Execute o comando terraform apply para aplicar o plano de execução à sua infraestrutura de nuvem.
terraform apply main.tfplan
Salve o nome do grupo de recursos e o nome do Fleet Manager nos outputs do Terraform. Você precisa desses valores para o exemplo de Namespace da Frota Gerenciada.
resource_group_name=$(terraform output -raw resource_group_name)
fleet_manager_name=$(terraform output -raw fleet_name)
Este exemplo não cria nem adiciona nenhum cluster de membros ao Fleet. Verifique se o Fleet Manager já tem clusters de membros associados usando o az fleet member list comando:
az fleet member list \
--resource-group $resource_group_name \
--fleet-name $fleet_manager_name \
-o table
Se esse comando não retornar nenhum membro, você ainda poderá concluir a seção a seguir para criar um namespace de frota gerenciada e exibir sua configuração, mas não poderá verificar se o namespace é implantado em um cluster membro até criar e associar pelo menos um cluster AKS à frota.
Criar o namespace da frota gerenciada com o Terraform
Observação
O código de exemplo desta seção está localizado no repositório Azure Terraform GitHub. Exiba o arquivo de log que contém os resultados do teste das versões atuais e anteriores do Terraform.
Veja mais artigos e exemplos de código mostrando como usar o Terraform para gerenciar recursos do Azure.
Crie um novo diretório separado para testar o código Terraform deste exemplo e torná-lo o diretório atual.
Crie um arquivo chamado
providers.tf, depois insira o código a seguir:terraform { required_version = ">= 1.5.0" required_providers { azurerm = { source = "hashicorp/azurerm" version = "~> 4.0" } azapi = { source = "Azure/azapi" version = "~> 2.0" } } } provider "azurerm" { features {} } provider "azapi" {}Crie um arquivo chamado
variables.tf, depois insira o código a seguir:variable "resource_group_name" { type = string description = "Name of the resource group that contains the Fleet Manager." } variable "fleet_name" { type = string description = "Name of the existing Azure Kubernetes Fleet Manager." } variable "managed_namespace_name" { type = string description = "Name of the Managed Fleet Namespace." default = "platform-ns" validation { condition = can(regex("^[a-z0-9]([-a-z0-9]*[a-z0-9])?$", var.managed_namespace_name)) && length(var.managed_namespace_name) <= 63 error_message = "The managed namespace name must be 1-63 characters, use lowercase letters, numbers, or hyphens, and start and end with a lowercase letter or number." } } variable "tags" { type = map(string) description = "Tags to apply to the Managed Fleet Namespace." default = { environment = "demo" managed_by = "terraform" } }Crie um arquivo chamado
main.tf, depois insira o código a seguir:data "azurerm_client_config" "current" {} data "azurerm_resource_group" "fleet_rg" { name = var.resource_group_name } locals { fleet_id = "/subscriptions/${data.azurerm_client_config.current.subscription_id}/resourceGroups/${var.resource_group_name}/providers/Microsoft.ContainerService/fleets/${var.fleet_name}" } resource "azapi_resource" "managed_fleet_namespace" { type = "Microsoft.ContainerService/fleets/managedNamespaces@2025-08-01-preview" name = var.managed_namespace_name parent_id = local.fleet_id location = data.azurerm_resource_group.fleet_rg.location tags = var.tags body = { properties = { adoptionPolicy = "Never" deletePolicy = "Keep" managedNamespaceProperties = { labels = { team = "platform" environment = "demo" } annotations = { owner = "aks-fleet-demo" "app.kubernetes.io/managed-by" = "terraform" } defaultNetworkPolicy = { ingress = "AllowAll" egress = "AllowAll" } defaultResourceQuota = { cpuRequest = "100m" cpuLimit = "500m" memoryRequest = "128Mi" memoryLimit = "512Mi" } } propagationPolicy = { type = "Placement" placementProfile = { defaultClusterResourcePlacement = { policy = { placementType = "PickAll" } } } } } } }Crie um arquivo chamado
outputs.tf, depois insira o código a seguir:output "managed_fleet_namespace_id" { description = "Resource ID of the Managed Fleet Namespace." value = azapi_resource.managed_fleet_namespace.id }Crie um arquivo chamado
terraform.tfvars.example, depois insira o código a seguir:resource_group_name = "<resource-group-name>" fleet_name = "<fleet-manager-name>" managed_namespace_name = "platform-ns"Copie
terraform.tfvars.exampleparaterraform.tfvarsno mesmo diretório. Definaresource_group_nameefleet_namecom os valores que você salvou na seção anterior (ou com os valores do seu Fleet Manager existente). Definamanaged_namespace_namecomo o nome desejado para o namespace.cp terraform.tfvars.example terraform.tfvars
Este exemplo não cria seu próprio Fleet Manager. Em vez disso, ele usa as fontes de dados azurerm_resource_group e azurerm_client_config para localizar o grupo de recursos e a assinatura atual. Em seguida, ele monta o ID do recurso do Fleet Manager existente cujo nome está na variável fleet_name, para usar como pai do Namespace de Frota Gerenciada. É assim que o exemplo consome as informações do Fleet Manager a partir do estado dos pré-requisitos ou de qualquer Fleet Manager pré-existente com um cluster de hub associado, sem compartilhar o estado do Terraform entre os dois exemplos.
O exemplo cria o namespace usando o tipo de recurso azapi_resource na versão prévia da API 2025-08-01-preview de Microsoft.ContainerService/fleets/managedNamespaces, porque esse tipo de recurso ainda não tem um recurso azurerm nativo. As propriedades a seguir são codificadas main.tf e não são expostas como variáveis. Para alterá-los, edite o body.properties bloco diretamente:
-
adoptionPolicyé definido comoNeveredeletePolicyé definido comoKeep, correspondendo aos padrões da CLI do Azure mostrados anteriormente neste artigo. -
managedNamespaceProperties.labelsdefine os rótulosteam=platformdo Kubernetes eenvironment=demo. -
managedNamespaceProperties.annotationsdefine as anotaçõesowner=aks-fleet-demodo Kubernetes eapp.kubernetes.io/managed-by=terraform. -
managedNamespaceProperties.defaultNetworkPolicydefine ambosingresseegressparaAllowAll. -
managedNamespaceProperties.defaultResourceQuotadefinecpuRequest=100m,cpuLimit=500m,memoryRequest=128MiememoryLimit=512Mi. -
propagationPolicy.placementProfile.defaultClusterResourcePlacement.policy.placementTypeé definido comoPickAll, portanto, o namespace é propagado para cada cluster membro atualmente associado à Frota. Ao contrário do parâmetro do--member-cluster-namesCLI do Azure, este exemplo não expõe uma maneira de direcionar clusters de membros nomeados específicos. Para limitar o posicionamento a um subconjunto de clusters, use as guias da CLI do Azure ou do portal do Azure nesta página, ou estenda o blocoplacementProfileemmain.tf, seguindo a referência de modelo do ARM para fleets do Microsoft.ContainerService.
A única variável que é mapeada para tags do Azure Resource Manager (ARM) no recurso Namespace da Frota Gerenciada, em vez de rótulos do Kubernetes no próprio namespace, é tags. É opcional e, se você não o definir, o padrão em variables.tf é { environment = "demo", managed_by = "terraform" }. O terraform.tfvars.example do exemplo não inclui tags, portanto, adicione-o ao arquivo terraform.tfvars somente se você quiser substituir o padrão.
Execute terraform init para inicializar a implantação do Terraform.
terraform init
Execute o terraform fmt para formatar os arquivos de configuração de forma consistente.
terraform fmt
Execute terraform validate para confirmar que os arquivos de configuração são sintaticamente válidos.
terraform validate
Execute o comando terraform plan para criar um plano de execução.
terraform plan -out main.tfplan
Execute o comando terraform apply para aplicar o plano de execução à sua infraestrutura de nuvem.
terraform apply main.tfplan
Atribuir acesso de usuário ou grupo
O Terraform não gerencia as atribuições de função do Azure RBAC neste exemplo. Conceda a um usuário acesso ao Managed Fleet Namespace em todos os clusters membros usando o comando az role assignment create. Use a saída do Terraform como escopo:
managed_namespace_id=$(terraform output -raw managed_fleet_namespace_id)
az role assignment create \
--role "Azure Kubernetes Fleet Manager RBAC Writer for Member Clusters" \
--assignee <USER-ENTRA-ID> \
--scope "$managed_namespace_id"
Adicionar ou remover clusters de membros
Como o propagationPolicy do exemplo usa PickAll, o espaço de nomes sempre se propaga para cada cluster de membro atual da frota. Adicionar um cluster de membros à Frota adiciona automaticamente o namespace a ele e remover um cluster membro da Frota remove automaticamente o namespace dele. O exemplo não dá suporte a direcionar uma lista específica de nomes dos clusters de membro, como faz o parâmetro --member-cluster-names da CLI do Azure. Se você precisar selecionar clusters de membros específicos, use as opções da CLI do Azure ou do portal do Azure nesta página.
Configurar um namespace de frota gerenciada existente
O Terraform executa um upsert para o azapi_resource tipo, para que você possa atualizar um Namespace de Frota Gerenciada existente alterando o exemplo e reaplicando-o.
- Para alterar as tags ARM, adicione ou atualize a variável
tagsemterraform.tfvars(ela é opcional e não está incluída emterraform.tfvars.example). - Para alterar os rótulos, anotações, políticas de rede ou cotas de recursos do Kubernetes, edite os valores correspondentes no
managedNamespacePropertiesbloco demain.tf. O exemplo não expõe essas configurações como variáveis.
Depois de fazer suas alterações, execute terraform plan -out main.tfplan novamente e terraform apply main.tfplan no diretório Namespace da Frota Gerenciada.
Exibir a configuração de um namespace de frota gerenciada
A saída do Terraform retorna apenas o ID do recurso do namespace da frota gerenciada. Extraia do identificador o grupo de recursos, o Fleet Manager e os nomes de namespace. Em seguida, exiba os detalhes do namespace usando o az fleet namespace show comando.
managed_namespace_id=$(terraform output -raw managed_fleet_namespace_id)
resource_group_name=$(echo $managed_namespace_id | cut -d'/' -f5)
fleet_manager_name=$(echo $managed_namespace_id | cut -d'/' -f9)
managed_namespace_name=$(echo $managed_namespace_id | cut -d'/' -f11)
az fleet namespace show \
--resource-group $resource_group_name \
--fleet-name $fleet_manager_name \
--name $managed_namespace_name \
-o table
Para revisar a distribuição do namespace entre clusters de membros, use Posicionamentos de recursos, e procure o posicionamento do recurso com o mesmo nome que o Namespace da Frota Gerenciada. Revisar a configuração do namespace usando az fleet namespace show não exige que nenhum cluster membro esteja associado à frota, mas revisar o status de distribuição ou posicionamento exige pelo menos um cluster membro associado. Se você ainda não tiver um, consulte primeiro como criar e adicionar pelo menos um cluster do AKS (Serviço de Kubernetes do Azure) à frota.
Excluir um Namespace de Frota Gerenciado
Exclua o Namespace da Frota Gerenciada antes de excluir o Fleet Manager ao qual ele pertence.
No diretório que contém o exemplo de namespace da frota gerenciada, execute terraform plan com a flag -destroy para criar um plano de execução para destruição.
terraform plan -destroy -out main.destroy.tfplan
Execute terraform apply para aplicar o plano de destruição.
terraform apply main.destroy.tfplan
Aviso
Excluir um namespace de frota gerenciada configurado com um deletePolicy de Delete é uma ação irreversível. Este exemplo define deletePolicy como Keep, portanto, depois que o recurso ARM é destruído, o namespace do Kubernetes permanece no cluster de hub do Fleet Manager e nos clusters membros, mas não é mais gerenciado pelo Azure Resource Manager. Se você quiser que o namespace seja removido de todos os lugares, altere deletePolicy para Delete em main.tf e reaplique antes de destruir o recurso.
As atribuições do RBAC do Azure com escopo no namespace da Frota Gerenciada são sempre excluídas para evitar permissões órfãs.
Se você implantou o Fleet Manager com um exemplo de pré-requisito de cluster de hub apenas para este artigo e não precisa dele para mais nada, alterne para o diretório desse exemplo e destrua-o também.
terraform plan -destroy -out main.destroy.tfplan
terraform apply main.destroy.tfplan
Aviso
Esse comando exclui o Fleet Manager, seu cluster de hub e o grupo de recursos criado pelo exemplo de pré-requisito, não apenas o Fleet Manager. Confirme se o grupo de recursos não contém outros recursos que você deseja manter e se nenhum outro Namespace da Frota Gerenciada ou clusters de membro ainda dependem do Fleet Manager, antes de executar esse comando.
Próximas etapas
- Entenda o conceito de Namespaces Gerenciados da Frota lendo a visão geral.
- Saiba como exibir e acessar namespaces da Frota Gerenciada aos quais você tem acesso.