Documentação do Oracle Cloud Infrastructure

Aplicando Tags a Pools de Nós

Descubra como aplicar tags aos pools de nós que você cria usando o Kubernetes Engine (OKE).

Ao criar um pool de nós gerenciado ou um pool de nós virtual, você tem a opção de aplicar tags ao recurso de pool de nós. Essas tags são chamadas de tags do pool de nós. Você pode especificar tags definidas e de formato livre como tags de pool de nós.

Os padrões de tag com valores padrão especificados para o compartimento do pool de nós são aplicados automaticamente ao recurso do pool de nós. Os padrões de tag com valores aplicados pelo usuário só serão aplicados ao recurso de pool de nós se o pool de nós estiver em outro compartimento para o cluster. Se esse for o caso, você deverá especificar um valor para padrões de tag com valores aplicados pelo usuário especificando tags de pool de nós, conforme descrito nesta seção.

Observe o seguinte:

  • Se você usar o workflow 'Criação Rápida' para criar um novo cluster, as tags de formato livre "OKEclusterName": <cluster-name> e "OKEnodePoolName": <node-pool-name> também serão adicionadas automaticamente aos pools de nós no novo cluster. As tags não serão adicionadas aos pools de nós se você usar o workflow 'Criação Personalizada' para criar o cluster. Observe que os valores dessas tags não serão alterados se você alterar subsequentemente o nome do cluster ou do pool de nós.
  • As tags do pool do nó não são aplicadas aos nós de trabalho no pool do nó. Para aplicar tags a nós de trabalho, consulte Aplicando Tags a Nós.
  • Para aplicar tags definidas de um namespace de tag pertencente a um compartimento a um pool de nós pertencente a outro compartimento, inclua uma instrução de política para permitir que o cluster use o namespace de tag. Consulte Política Adicional do Serviço IAM quando um Cluster e um Namespace de Tag estão em Compartimentos Diferentes.

Usando a Console para Especificar Tags de Pool de Nós

Para adicionar uma tag de pool de nós a um novo pool de nós ao criar um novo cluster:

  1. Siga as instruções em Usando a Console para criar um Cluster com Definições Explicitamente Definidas no workflow 'Criação Personalizada' para criar um novo cluster.
  2. Na seção Tags de pool de nós da página Pools de nós, selecione Adicionar tag.
  3. Para adicionar uma tag definida ao pool de nós:
    • Namespace: Selecione o namespace de tag ao qual a tag pertence.
    • Chave: Selecione o nome da tag definida a ser aplicada ao pool de nós.
    • Valor: Selecione o valor da tag em uma lista de valores predefinida, informe um novo valor ou deixe em branco (dependendo de como a tag definida foi configurada).
  4. Para adicionar uma tag de formato livre ao pool de nós:
    • Namespace: Definido como Nenhum (as tags de formato livre não pertencem a um namespace de tag).
    • Chave: Informe um nome para a tag de formato livre a ser aplicada ao pool de nós.
    • Valor: Informe um valor para a tag a ser aplicada ao pool de nós.

Para atualizar as tags de pool de nós aplicadas a um pool de nós existente:

  1. Siga as instruções em Modificando Propriedades do Pool de Nós e do Nó de Trabalho para atualizar um pool de nós existente.
  2. Selecione a guia Tags da página de detalhes do pool de nós.
  3. Na seção Tags do pool de nós:
    • Selecione Adicionar para aplicar tags definidas adicionais e tags de formato livre ao pool de nós.
    • Selecione Editar no menu Ações (três pontos) para alterar o valor das tags definidas e de formato livre aplicadas anteriormente ao pool de nós.
    • Selecione Excluir no menu Ações (três pontos) para remover as tags definidas e as tags de formato livre aplicadas anteriormente ao pool de nós.

Usando a CLI para Especificar Tags de Pool de Nós Gerenciados

oci ce node-pool create \
--cluster-id <cluster-ocid> \
--compartment-id <compartment-ocid> \
--kubernetes-version <kubernetes-version> \
--name <node-pool-name> \
--node-shape <node-shape> \
--defined-tags <json-name-value-pairs> \
--freeform-tags <json-name-value-pairs>

Por exemplo:

oci ce node-pool create \
--cluster-id ocid1.cluster.oc1.iad.aaaaaaaaaf______jrd \
--compartment-id ocid1.compartment.oc1..aaaaaaaay______t6q \
--kubernetes-version v1.20.11 \
--name Finance-Node-Pool \
--node-shape VM.Standard2.1 \
--defined-tags {"Operations": {"CostCenter": "42"}} \
--freeform-tags {"Department": "Finance"}

Usando a CLI para Especificar Tags de Pool de Nós Virtuais

oci ce virtual-node-pool create \
--cluster-id <cluster-ocid> \
--compartment-id <compartment-ocid> \
--display-name <node-pool-name> \
--kubernetes-version <kubernetes-version> \
--placement-configurations "[{\"availabilityDomain\":\"<ad-name>\",\"faultDomain\":[\"FAULT-DOMAIN-<n>\"],\"subnetId\":\"<virtualnode-subnet-ocid>\"}]" \
--nsg-ids "[\"<virtual-node-nsg-ocid>\"]" \
--pod-configuration "{\"subnetId\":\"<pod-subnet-ocid>\",\"nsgIds\":[\"<pod-nsg-ocid>\"],\"shape\":\"<shape-name>\"}" \
--size <number-of-nodes> \
--defined-tags <json-name-value-pairs> \
--freeform-tags <json-name-value-pairs>

Por exemplo:

oci ce virtual-node-pool create \
--cluster-id ocid1.cluster.oc1.phx.aaaaaaaa______w5q \
--compartment-id ocid1.compartment.oc1..aaaaaaaa______n5q \
--display-name sales-vnp \
--kubernetes-version v1.24.1 \
--placement-configurations "[{\"availabilityDomain\":\"GMvH:PHX-AD-1\",\"faultDomain\":[\"FAULT-DOMAIN-1\"],\"subnetId\":\"ocid1.subnet.oc1.phx.aaaaaaaa______sra\"}]" \
--nsg-ids "[\"ocid1.networksecuritygroup.oc1.phx.aaaaaaaa______hpa\"]" \
--pod-configuration "{\"subnetId\":\"ocid1.subnet.oc1.phx.aaaaaaaa______o7q\",\"nsgIds\":[\"ocid1.networksecuritygroup.oc1.phx.aaaaaaaa______osq\"],\"shape\":\"Pod.Standard.E4.Flex\"}" \
--size 1 \
--defined-tags {"Operations": {"CostCenter": "43"}} \
--freeform-tags {"Department": "Sales"}

Usando a API para Especificar Tags de Pool de Nós

Para adicionar e atualizar tags de pool de nós gerenciados, use os atributos freeformTags e definedTags dos objetos CreateNodePoolDetails e UpdateNodePoolDetails usados pelas operações CreateNodePool e UpdateNodePool.

Para adicionar e atualizar tags de pool de nós virtuais, use os atributos freeformTags e definedTags dos objetos CreateVirtualNodePoolDetails e UpdateVirtualNodePoolDetails usados pelas operações CreateVirtualNodePool e UpdateVirtualNodePool.