Aplicación de etiquetas a equilibradores de carga

Uso de la consola para especificar etiquetas de equilibrador de carga inicial

Para especificar una etiqueta de equilibrador de carga inicial que aplicar a los recursos de equilibrador de carga creados para 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 equilibrador de carga iniciales de la página Crear cluster.
3. Para agregar una etiqueta definida a los recursos del equilibrador de carga:
   • 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 aplicará a los recursos del equilibrador de carga.
   • 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 a los recursos del equilibrador de carga:
   • 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á a los recursos del equilibrador de carga.
   • Valor de etiqueta: introduzca un valor para la etiqueta que se va a aplicar a los recursos del equilibrador de carga.

Para actualizar las etiquetas del equilibrador de carga inicial que se aplicarán a los nuevos recursos del equilibrador de carga creados para un cluster:

1. Siga las instrucciones de Actualización de un cluster para actualizar un cluster existente.
2. Muestre el separador Etiquetas del equilibrador de carga inicial 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 a los nuevos recursos del equilibrador de carga.

   Tenga en cuenta que las etiquetas solo se aplican a los equilibradores de carga cuando se crean por primera vez. Por lo tanto, si actualiza las etiquetas del equilibrador de carga inicial, los cambios solo se aplican a los nuevos recursos del equilibrador de carga. Las etiquetas ya aplicadas a los recursos del equilibrador de carga existentes no se ven afectadas.

Uso de la CLI para especificar etiquetas de equilibrador de carga inicial

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>  \
--service-lb-defined-tags <json-name-value-pairs> \
--service-lb-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 \
--service-lb-defined-tags {"Operations": {"CostCenter": "42"}} \
--service-lb-freeform-tags {"Department": "Finance"}

Uso de la API para especificar etiquetas de equilibrador de carga inicial

Utilice los atributos freeformTags y definedTags del objeto ServiceLbConfigDetails utilizado por las operaciones CreateCluster y Actualizar cluster para agregar y actualizar etiquetas de equilibrador de carga inicial.

Sustitución de etiquetas de equilibrador de carga inicial

Puede sustituir las etiquetas de equilibrador de carga iniciales especificadas para un cluster mediante anotaciones en la definición de un servicio de Kubernetes de tipo LoadBalancer, de la siguiente forma:

• Para los recursos del equilibrador de carga:

  • Para sustituir las etiquetas iniciales del equilibrador de carga definidas para los recursos del equilibrador de carga, agregue la siguiente anotación en la sección de metadatos del archivo de manifiesto:

    oci.oraclecloud.com/initial-defined-tags-override: '{"<tag-namespace>": {"<tag-key>": "<tag-value>"}}'

  • Para sustituir las etiquetas de equilibrador de carga inicial de formato libre para los recursos del equilibrador de carga, agregue la siguiente anotación en la sección de metadatos del archivo de manifiesto:

    oci.oraclecloud.com/initial-freeform-tags-override: '{"<tag-key>": "<tag-value>"}'

• Para recursos de equilibrador de carga de red:

  • Para sustituir las etiquetas del equilibrador de carga inicial definidas para los recursos del equilibrador de carga de red, agregue la siguiente anotación en la sección de metadatos del archivo de manifiesto:

    oci-network-load-balancer.oraclecloud.com/initial-defined-tags-override: '{"<tag-namespace>": {"<tag-key>": "<tag-value>"}}'

  • Para sustituir las etiquetas del equilibrador de carga inicial de formato libre para los recursos del equilibrador de carga de red, agregue la siguiente anotación en la sección de metadatos del archivo de manifiesto:

    oci-network-load-balancer.oraclecloud.com/initial-freeform-tags-override: '{"<tag-key>": "<tag-value>"}'

Por ejemplo:

apiVersion: v1
kind: Service
metadata:
  name: my-nginx-svc
  labels:
    app: nginx
  annotations:
    oci.oraclecloud.com/initial-defined-tags-override: '{"Operations": {"CostCenter": "42"}}'
    oci.oraclecloud.com/initial-freeform-tags-override: '{"Department": "Finance"}'
spec:
  type: LoadBalancer
  ports:
  - port: 80
  selector:
    app: nginx

Tenga en cuenta lo siguiente:

• Si especifica las anotaciones anteriores, ninguna de las etiquetas del equilibrador de carga inicial definidas para el cluster se aplica al recurso del equilibrador de carga. Solo se aplican al recurso del equilibrador de carga las etiquetas especificadas por las anotaciones, junto con los valores por defecto de las etiquetas.
• Si cambia las anotaciones en el archivo de manifiesto, los cambios solo se aplican a los nuevos recursos del equilibrador de carga. Las etiquetas ya aplicadas a los recursos del equilibrador de carga existentes no se ven afectadas. No puede cambiar las etiquetas aplicadas a un recurso de equilibrador de carga existente cambiando las anotaciones. En su lugar, debe crear un nuevo servicio de Kubernetes de tipo LoadBalancer con las anotaciones para las etiquetas que necesita.