Documentación de Oracle Cloud Infrastructure

Aplicación de etiquetas a clusters

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

Al crear un cluster, puede aplicar etiquetas al recurso de cluster. Estas etiquetas se denominan etiquetas de cluster. Puede especificar tanto las etiquetas definidas como las de formato libre como las de cluster.

Los valores por defecto de etiqueta con los valores por defecto especificados para el compartimento también se aplican automáticamente al recurso de cluster. Tenga en cuenta que Container Engine for Kubernetes no soporta actualmente valores por defecto de etiquetas con valores aplicados por el usuario.

Tenga en cuenta lo siguiente:

  • Si utiliza el flujo de trabajo 'Creación rápida' para crear un nuevo cluster, la etiqueta de formato libre "OKEclusterName": <cluster-name> se agrega automáticamente al cluster. La etiqueta no se agrega a un cluster si utiliza el flujo de trabajo 'Creación personalizada' para crear el cluster. Tenga en cuenta que el valor de esta etiqueta no cambia si posteriormente cambia el nombre del cluster.
  • Las etiquetas aplicadas a un recurso de cluster no se aplican al recurso de dirección IP privada del cluster ni al recurso de dirección IP pública opcional.
  • Para aplicar etiquetas definidas de un espacio de nombres de etiqueta que pertenece a un compartimento a un recurso de cluster 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 cluster

Para agregar una etiqueta de cluster a 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 cluster de la página Crear cluster.
  3. Para agregar una etiqueta definida al cluster:
    • 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 cluster.
    • 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 cluster:
    • 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 cluster.
    • Valor de etiqueta: introduzca un valor para la etiqueta que se va a aplicar al cluster.

Para actualizar las etiquetas de cluster aplicadas a un cluster existente:

  1. Siga las instrucciones de Actualización de un cluster para actualizar un cluster existente.
  2. Muestre el separador Etiquetas de cluster de la página Detalles de cluster.
  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 cluster.

Uso de la CLI para especificar etiquetas de cluster

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

Por ejemplo:

oci ce cluster create \
--compartment-id ocid1.compartment.oc1..aaaaaaaay______t6q \
--kubernetes-version v1.20.11 \
--name Finance-Cluster \
--vcn-id ocid1.vcn.oc1.iad.aaaaaae___yja \
--defined-tags {"Operations": {"CostCenter": "42"}} \
--freeform-tags {"Department": "Finance"}

Uso de la API para especificar etiquetas de cluster

Utilice los atributos freeformTags y definedTags de los objetos CreateClusterDetails y UpdateClusterDetails utilizados por las operaciones CreateCluster y Actualizar cluster para agregar y actualizar etiquetas de cluster.