Configurar grupos de nodos dedicados

Acerca de los grupos de nodos

Un grupo de nodos es un grupo de nodos de un clúster que tienen la misma configuración. Normalmente, se definen grupos de nodos independientes cuando se tienen pods con requisitos de recursos diferentes. Por ejemplo, los pods apigee-cassandra requieren almacenamiento persistente, mientras que los demás pods híbridos de Apigee no.

En este artículo se explica cómo configurar grupos de nodos dedicados para una instalación híbrida.

Usar los nodeSelectors predeterminados

Lo más recomendable es configurar dos grupos de nodos dedicados: uno para los pods de Cassandra y otro para el resto de los pods de tiempo de ejecución. Si se usan las configuraciones predeterminadas de nodeSelector, el instalador asignará los pods de Cassandra a un grupo de nodos con estado llamado apigee-data y todos los demás pods a un grupo de nodos sin estado llamado apigee-runtime. Solo tienes que crear grupos de nodos con estos nombres y Apigee hybrid se encargará de los detalles de la programación de pods:

A continuación, se muestra la configuración predeterminada de nodeSelector. La propiedad apigeeData especifica un grupo de nodos para los pods de Cassandra. apigeeRuntime especifica el grupo de nodos de todos los demás pods. Puedes anular estos ajustes predeterminados en tu archivo de anulaciones, como se explica más adelante en este tema:

nodeSelector:
  requiredForScheduling: true
  apigeeRuntime:
    key: "cloud.google.com/gke-nodepool"
    value: "apigee-runtime"
  apigeeData:
    key: "cloud.google.com/gke-nodepool"
    value: "apigee-data"

Para asegurarte de que tus pods se programan en los nodos correctos, crea dos grupos de nodos con los nombres apigee-data y apigee-runtime.

Propiedad requiredForScheduling

La sección de configuración nodeSelector tiene una propiedad llamada requiredForScheduling:

nodeSelector:
  requiredForScheduling: false
  apigeeRuntime:
    key: "cloud.google.com/gke-nodepool"
    value: "apigee-runtime"
  apigeeData:
    key: "cloud.google.com/gke-nodepool"
    value: "apigee-data"

Si se define como false, los pods subyacentes se programarán independientemente de si los grupos de nodos se definen con los nombres necesarios. Esto significa que, si olvidas crear grupos de nodos o si asignas a un grupo de nodos un nombre que no sea apigee-runtime o apigee-data, la instalación del tiempo de ejecución híbrido se completará correctamente. Kubernetes decidirá dónde ejecutar tus pods.

Si asignas el valor true (predeterminado) a requiredForScheduling, la instalación fallará a menos que haya grupos de nodos que coincidan con las claves y los valores de nodeSelector configurados.

Usar nombres de grupos de nodos personalizados

Si no quieres usar grupos de nodos con los nombres predeterminados, puedes crear grupos de nodos con nombres personalizados y especificar esos nombres en la sección nodeSelector. Por ejemplo, la siguiente configuración asigna los pods de Cassandra al pool llamado my-cassandra-pool y todos los demás pods al pool llamado my-runtime-pool:

nodeSelector:
  requiredForScheduling: false
  apigeeRuntime:
    key: "cloud.google.com/gke-nodepool"
    value: "my-runtime-pool"
  apigeeData:
    key: "cloud.google.com/gke-nodepool"
    value: "my-cassandra-pool"

Anular el grupo de nodos de componentes específicos en GKE

También puedes anular las configuraciones de grupos de nodos en componentes concretos. Por ejemplo, la siguiente configuración asigna el valor apigee-custom al componente runtime del grupo de nodos:

runtime:
  nodeSelector:
    key: cloud.google.com/gke-nodepool
    value: apigee-custom

Puede especificar un grupo de nodos personalizado en cualquiera de estos componentes:

• istio
• mart
• synchronizer
• runtime
• cassandra
• udca
• logger

Configuración de grupos de nodos de GKE y Google Distributed Cloud

En las plataformas GKE y Google Distributed Cloud (GDC), los grupos de nodos deben tener un nombre único que proporciones al crearlos. Además, GKE o GDC etiquetan automáticamente cada nodo con lo siguiente:

cloud.google.com/gke-nodepool=THE_NODE_POOL_NAME

Si creas grupos de nodos llamados apigee-data y apigee-runtime, no tendrás que hacer nada más. Si quieres usar nombres de nodo personalizados, consulta Usar nombres de grupo de nodos personalizados.

Configuración de grupos de nodos en otras plataformas de Kubernetes.

Consulta la documentación de tu plataforma de Kubernetes para obtener información sobre el etiquetado y la gestión de grupos de nodos.

Aunque los grupos de nodos etiquetan automáticamente los nodos de trabajador de forma predeterminada, puedes etiquetarlos manualmente siguiendo estos pasos:

1. Ejecuta el siguiente comando para obtener una lista de los nodos de trabajador de tu clúster:

   kubectl -n APIGEE_NAMESPACE get nodes

   Si utiliza etiquetas de grupo de nodos personalizadas, asegúrese de que cada par clave-valor sea único. Por ejemplo:

   nodeSelector:
     requiredForScheduling: true
     apigeeRuntime:
       key: "pool1-key"
       value: "pool1-label"
     apigeeData:
       key: "pool2-key"
       value: "pool2-label"
   

   Anular el grupo de nodos de componentes específicos

   También puedes anular las configuraciones de los grupos de nodos a nivel de componente individual. Por ejemplo, la siguiente configuración asigna el valor apigee-custom al componente runtime del grupo de nodos:

   runtime:
     nodeSelector:
       key: apigee.com/apigee-nodepool
       value: apigee-custom

   Puede especificar un grupo de nodos personalizado en cualquiera de estos componentes:

   • apigeeingressgateway
   • cassandra
   • logger
   • mart
   • metrics
   • runtime
   • synchronizer
   • udca