Usar namespaces gerenciados no AKS (Serviço de Kubernetes do Azure)

• Listar namespaces existentes a serem convertidos no portal não funciona com clusters privados. Você pode adicionar novos namespaces.

O exemplo Bicep a seguir demonstra como criar um namespace gerenciado como uma sub-fonte de um cluster gerenciado. Selecione o valor apropriado para defaultNetworkPolicy, adoptionPolicye deletePolicy. Para obter mais informações sobre o que esses parâmetros significam, consulte a visão geral dos namespaces gerenciados.

resource existingCluster 'Microsoft.ContainerService/managedClusters@2024-03-01' existing = {
  name: 'contoso-cluster'
}

resource managedNamespace 'Microsoft.ContainerService/managedClusters/managedNamespaces@2025-09-01' = {
  parent: existingCluster
  name: 'retail-team'
  location: location
  properties: {
    defaultResourceQuota: {
      cpuRequest: '1000m'
      cpuLimit: '2000m'
      memoryRequest: '512Mi'
      memoryLimit: '1Gi'
    }
    defaultNetworkPolicy: {
      ingress: 'AllowSameNamespace'
      egress: 'AllowAll'
    }
    adoptionPolicy: 'IfIdentical'
    deletePolicy: 'Keep'
    labels: {
      environment: 'dev'
    }
    annotations: {
      owner: 'retail'
    }
  }
}

Salve o arquivo Bicep managedNamespace.bicep no computador local.

Implante o arquivo Bicep usando a CLI do Azure.

az deployment group create --resource-group <resource-group> --template-file managedNamespace.bicep

Definir variáveis

Defina as variáveis a seguir a serem usadas nas etapas subsequentes.

RG_NAME=cluster-rg
CLUSTER_NAME=contoso-cluster
NAMESPACE_NAME=retail-team
LABELS="environment=dev"
ANNOTATIONS="owner=retail"

Criar o namespace gerenciado

Para personalizar sua configuração, os namespaces gerenciados têm várias opções de parâmetro para escolher durante a criação. Selecione o valor apropriado para ingress-network-policy, egress-network-policyadoption-policye delete-policy. Para obter mais informações sobre o que esses parâmetros significam, consulte a visão geral dos namespaces gerenciados.

az aks namespace add \
    --name ${NAMESPACE_NAME} \
    --cluster-name ${CLUSTER_NAME} \
    --resource-group ${RG_NAME} \
    --cpu-request 1000m \
    --cpu-limit 2000m \
    --memory-request 512Mi \
    --memory-limit 1Gi \
    --ingress-policy [AllowSameNamespace|AllowAll|DenyAll] \
    --egress-policy [AllowSameNamespace|AllowAll|DenyAll] \
    --adoption-policy [Never|IfIdentical|Always] \
    --delete-policy [Keep|Delete] \
    --labels ${LABELS} \
    --annotations ${ANNOTATIONS}

Atribuir função

Depois que o namespace for criado, você poderá atribuir uma das funções internas para o plano de controle e o plano de dados.

ASSIGNEE="user@contoso.com"
NAMESPACE_ID=$(az aks namespace show --name ${NAMESPACE_NAME} --cluster-name ${CLUSTER_NAME} --resource-group ${RG_NAME} --query id -o tsv)

Atribua uma função de plano de controle para poder exibir o namespace gerenciado no portal, na saída da CLI do Azure e no Azure Resource Manager. Essa função também permite que o usuário recupere as credenciais para se conectar a esse namespace.

az role assignment create \
  --assignee ${ASSIGNEE} \
  --role "Azure Kubernetes Service Namespace User" \
  --scope ${NAMESPACE_ID}

Atribua a função de plano de dados para obter acesso para criar recursos no namespace usando a API do Kubernetes.

az role assignment create \
  --assignee ${ASSIGNEE} \
  --role "Azure Kubernetes Service RBAC Writer" \
  --scope ${NAMESPACE_ID}

1. Entre no portal do Azure.
2. Na home page do portal do Azure, selecione Criar um recurso.
3. Na seção Categorias, selecione Namespaces Gerenciados do Kubernetes.
4. Na guia Noções básicas , em detalhes do Projeto , defina as seguintes configurações:
   1. Selecione o cluster de destino no qual criar o namespace.
   2. Se você estiver criando um novo namespace, deixe o padrão criar novo, caso contrário, escolha alterar existente para gerenciado para converter um namespace existente.
5. Configure a política de rede a ser aplicada no namespace.
6. Configure solicitações de recursos e limites para o namespace.
7. Selecione os membros (usuários ou grupos) e sua função.
   1. Atribua a função de Usuário do Namespace do Serviço de Kubernetes do Azure para conceder-lhes acesso para exibir o namespace gerenciado no portal, na saída da CLI do Azure e no Azure Resource Manager. Essa função também permite que o usuário recupere as credenciais para se conectar a esse namespace.
   2. Atribua a função de Gravador RBAC do Serviço de Kubernetes do Azure para dar a eles acesso para criar recursos no namespace usando a API do Kubernetes.
8. Selecione Examinar + criar para executar a validação na configuração. Após a conclusão da validação, selecione Criar.

Listar namespaces gerenciados

Você pode listar namespaces gerenciados em escopos diferentes usando a CLI do Azure.

Nível de assinatura

Execute o comando a seguir para listar todos os namespaces gerenciados em uma assinatura.

az aks namespace list --subscription <subscription-id>

Nível do grupo de recursos

Execute o comando a seguir para listar todos os namespaces gerenciados em um grupo de recursos específico.

az aks namespace list --resource-group <rg-name>

Nível do cluster

Execute o comando a seguir para listar todos os namespaces gerenciados em um cluster específico.

az aks namespace list --resource-group <rg-name> --cluster-name <cluster-name>

Listar namespaces gerenciados

Você pode listar namespaces gerenciados em escopos diferentes usando a CLI do Azure.

Nível de assinatura

Execute o comando a seguir para listar todos os namespaces gerenciados em uma assinatura.

az aks namespace list --subscription <subscription-id>

Nível do grupo de recursos

Execute o comando a seguir para listar todos os namespaces gerenciados em um grupo de recursos específico.

az aks namespace list --resource-group <rg-name>

Nível do cluster

Execute o comando a seguir para listar todos os namespaces gerenciados em um cluster específico.

az aks namespace list --resource-group <rg-name> --cluster-name <cluster-name>

Conectar-se ao cluster

Você pode recuperar as credenciais para se conectar a um namespace por meio do comando a seguir.

az aks namespace get-credentials --name <namespace-name> --resource-group <rg-name> --cluster-name <cluster-name>

Conectar-se ao cluster

Você pode recuperar as credenciais para se conectar a um namespace por meio do comando a seguir.

az aks namespace get-credentials --name <namespace-name> --resource-group <rg-name> --cluster-name <cluster-name>