Configurar grupos de nodos dedicados

Acerca de los grupos de nodos

Un grupo de nodos es un conjunto 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 programación de los pods:

Nombre predeterminado del grupo de nodos Descripción
apigee-data Un grupo de nodos con estado.
apigee-runtime Un grupo de nodos sin estado.

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: false
  apigeeRuntime:
    key: "cloud.google.com/gke-nodepool"
    value: "apigee-runtime"
  apigeeData:
    key: "cloud.google.com/gke-nodepool"
    value: "apigee-data"

De nuevo, para asegurarte de que tus pods se programan en los nodos correctos, solo tienes que crear 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 (valor predeterminado), 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 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 del grupo de nodos de GKE

En GKE, los grupos de nodos deben tener un nombre único que proporciones al crearlos. GKE etiqueta 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 de Anthos

Actualmente, Apigee hybrid solo se admite en Anthos 1.1.1. Esta versión de Anthos no admite la función de grupo de nodos, por lo que debes etiquetar manualmente los nodos de trabajo, tal como se explica a continuación. Sigue estos pasos una vez que tu clúster híbrido esté en funcionamiento:

  1. Ejecuta el siguiente comando para obtener una lista de los nodos de trabajo de tu clúster: 
    kubectl -n apigee get nodes

    Ejemplo: 

    NAME                   STATUS   ROLES    AGE     VERSION
apigee-092d639a-4hqt   Ready       7d      v1.14.6-gke.2
apigee-092d639a-ffd0   Ready       7d      v1.14.6-gke.2
apigee-109b55fc-5tjf   Ready       7d      v1.14.6-gke.2
apigee-c2a9203a-8h27   Ready       7d      v1.14.6-gke.2
apigee-c70aedae-t366   Ready       7d      v1.14.6-gke.2
apigee-d349e89b-hv2b   Ready       7d      v1.14.6-gke.2
  2. Etiqueta cada nodo para diferenciar entre los nodos de tiempo de ejecución y los nodos de datos.

    Usa este comando para etiquetar los nodos: 

    kubectl label node node_name key=value

    Por ejemplo:

    $ kubectl label node apigee-092d639a-4hqt apigee.com/apigee-nodepool=apigee-runtime
$ kubectl label node apigee-092d639a-ffd0 apigee.com/apigee-nodepool=apigee-runtime
$ kubectl label node apigee-109b55fc-5tjf apigee.com/apigee-nodepool=apigee-runtime
$ kubectl label node apigee-c2a9203a-8h27 apigee.com/apigee-nodepool=apigee-data
$ kubectl label node apigee-c70aedae-t366 apigee.com/apigee-nodepool=apigee-data
$ kubectl label node apigee-d349e89b-hv2b apigee.com/apigee-nodepool=apigee-data

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

También puedes anular las configuraciones de los grupos de nodos a nivel de componente en una instalación de Anthos GKE. 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:

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