Documentación de Oracle Cloud Infrastructure

Aplicación de etiquetas a pools de nodos

Descubra cómo aplicar etiquetas a los pools de nodos que cree mediante Container Engine for Kubernetes (OKE).

Al crear un pool de nodos gestionado o un pool de nodos virtual, puede aplicar etiquetas al recurso del pool de nodos. Estas etiquetas se denominan etiquetas de agrupación de nodos. Puede especificar tanto etiquetas definidas como etiquetas de formato libre como etiquetas de pool de nodos.

Los valores por defecto de etiqueta con los valores por defecto especificados para el compartimento del pool de nodos se aplican automáticamente al recurso del pool de nodos. Los valores por defecto de etiquetas con valores aplicados por el usuario solo se aplican al recurso del pool de nodos si el pool de nodos está en un compartimento diferente al cluster. Si ese es el caso, debe especificar un valor para los valores por defecto de etiquetas con valores aplicados por el usuario especificando etiquetas de pool de nodos, como se describe en esta sección.

Tenga en cuenta lo siguiente:

  • Si utiliza el flujo de trabajo 'Creación rápida' para crear un nuevo cluster, las etiquetas de formato libre "OKEclusterName": <cluster-name> y "OKEnodePoolName": <node-pool-name> también se agregan automáticamente a los pools de nodos del nuevo cluster. Las etiquetas no se agregan a los pools de nodos si utiliza el flujo de trabajo 'Creación personalizada' para crear el cluster. Tenga en cuenta que los valores de estas etiquetas no cambian si posteriormente cambia el nombre del cluster o el pool de nodos.
  • Las etiquetas de pool de nodos no se aplican a los nodos de trabajador del pool de nodos. Para aplicar etiquetas a nodos de trabajador, consulte Aplicación de etiquetas a nodos.
  • Para aplicar etiquetas definidas de un espacio de nombres de etiqueta que pertenece a un compartimento a un pool de nodos que pertenece a un compartimento diferente, debe incluir una sentencia de política para permitir que el cluster utilice el espacio de nombres de etiqueta. Consulte Política de IAM adicional cuando un cluster y un espacio de nombres de etiqueta están en diferentes compartimentos.

Uso de la consola para especificar etiquetas de pool de nodos

Para agregar una etiqueta de pool de nodos a un nuevo pool de nodos al crear un nuevo cluster:

  1. Siga las instrucciones de Uso de la consola para crear un cluster con una configuración definida explícitamente en el flujo de trabajo "Creación personalizada" para crear un nuevo cluster.
  2. Muestre la sección Etiquetas de agrupación de nodos de la página Agrupaciones de nodos.
  3. Para agregar una etiqueta definida al pool de nodos:
    • Espacio de nombres de etiqueta: seleccione el espacio de nombres de etiqueta al que pertenece la etiqueta.
    • Clave de etiqueta: seleccione el nombre de la etiqueta definida que se va a aplicar al pool de nodos.
    • Valor de etiqueta: seleccione el valor de la etiqueta de una lista de valores predefinida, introduzca un nuevo valor o déjelo en blanco (en función de cómo se haya configurado la etiqueta definida).
  4. Para agregar una etiqueta de formato libre al pool de nodos:
    • Espacio de nombres de etiqueta: defínalo en Ninguno (las etiquetas de formato libre no pertenecen a un espacio de nombres de etiqueta).
    • Clave de etiqueta: introduzca un nombre para la etiqueta de formato libre que se aplicará al pool de nodos.
    • Valor de etiqueta: introduzca un valor para la etiqueta que se va a aplicar al pool de nodos.

Para actualizar las etiquetas de pool de nodos aplicadas a un pool de nodos existente:

  1. Siga las instrucciones de Modificación de las propiedades de los pools de nodos y de los nodos de trabajador para actualizar un pool de nodos existente.
  2. Muestre el separador Etiquetas de pool de nodos de la página Detalles de pool de nodos.
  3. Haga clic en Agregar etiquetas para agregar, eliminar y cambiar el valor de las etiquetas definidas y las etiquetas de formato libre aplicadas al pool de nodos.

Uso de la CLI para especificar etiquetas de pool de nodos gestionados

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 ejemplo:

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"}

Uso de la CLI para especificar etiquetas de pool de nodos virtuales

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 ejemplo:

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"}

Uso de la API para especificar etiquetas de pool de nodos

Para agregar y actualizar etiquetas de pool de nodos gestionados, utilice los atributos freeformTags y definedTags de los objetos CreateNodePoolDetails y UpdateNodePoolDetails utilizados por las operaciones CreateNodePool y UpdateNodePool.

Para agregar y actualizar etiquetas de pool de nodos virtuales, utilice los atributos freeformTags y definedTags de los objetos CreateVirtualNodePoolDetails y UpdateVirtualNodePoolDetails utilizados por las operaciones CreateVirtualNodePool y UpdateVirtualNodePool.