Escalar cargas de trabajo con reconocimiento del estado

En este documento se describe cómo escalar cargas de trabajo con estado que se ejecutan en un clúster de Kubernetes aislado de Google Distributed Cloud (GDC). Debes escalar los pods que se ejecutan en tus cargas de trabajo con estado a medida que evolucionan los requisitos de tus cargas de trabajo de contenedores.

Este documento está dirigido a los desarrolladores del grupo de operadores de aplicaciones que se encargan de gestionar las cargas de trabajo de aplicaciones de su organización. Para obtener más información, consulta Audiencias de la documentación de GDC aislado.

Antes de empezar

Para completar las tareas de este documento, debes solicitar los permisos necesarios y preparar tu entorno.

Solicitar roles de gestión de identidades y accesos

Debes tener roles específicos para obtener los permisos que necesitas para escalar cargas de trabajo con estado. Los roles que necesitas dependen de si trabajas en un clúster compartido con ámbito de organización o en un clúster estándar con ámbito de proyecto. Para obtener más información, consulta el artículo Configuraciones de clústeres de Kubernetes.

Roles de clúster compartido

Para crear, eliminar, editar o ver cargas de trabajo en un clúster compartido, pide a tu administrador de gestión de identidades y accesos del proyecto que te asigne el rol Administrador de espacios de nombres (namespace-admin). Este rol está vinculado al espacio de nombres de tu proyecto.

Roles de clúster estándar

Para crear, eliminar, editar o ver cargas de trabajo en un clúster estándar, pide a tu administrador de gestión de identidades y accesos del proyecto que te asigne el rol Desarrollador de clústeres (cluster-developer). Este rol está vinculado al espacio de nombres de tu proyecto.

Preparar el entorno

Para ejecutar comandos en un clúster de Kubernetes mediante la API, asegúrate de tener los siguientes recursos:

  • Busca el nombre del clúster de Kubernetes o pregunta a un miembro del grupo de administradores de la plataforma cuál es el nombre del clúster.

  • Inicia sesión y genera el archivo kubeconfig del clúster de Kubernetes.

  • Usa la ruta de kubeconfig del clúster de Kubernetes para sustituir KUBERNETES_CLUSTER_KUBECONFIG en estas instrucciones.

Escalar un recurso StatefulSet

Usa la función de escalado de Kubernetes para escalar adecuadamente la cantidad de pods que se ejecutan en tu recurso StatefulSet.

Escalar manualmente los pods de un recurso StatefulSet

Para escalar manualmente tu recurso StatefulSet, ejecuta lo siguiente:

kubectl --kubeconfig KUBERNETES__CLUSTER_KUBECONFIG -n NAMESPACE \
    scale statefulset STATEFULSET_NAME \
    --replicas NUMBER_OF_REPLICAS

Haz los cambios siguientes:

  • KUBERNETES_CLUSTER_KUBECONFIG: el archivo kubeconfig del clúster.

  • NAMESPACE: el espacio de nombres. En el caso de los clústeres compartidos, debe ser un espacio de nombres del proyecto. En el caso de los clústeres estándar, puede ser cualquier espacio de nombres.

  • STATEFULSET_NAME: el nombre del objeto StatefulSet que se va a escalar.

  • NUMBER_OF_REPLICAS: el número de objetos Pod replicados en el objeto StatefulSet.

Escalar los pods haciendo una actualización in situ

Para escalar los pods de un recurso StatefulSet directamente en el archivo de manifiesto, ejecuta lo siguiente:

kubectl --kubeconfig KUBERNETES__CLUSTER_KUBECONFIG -n NAMESPACE \
    patch statefulsets STATEFULSET_NAME \
    -p '{"spec":{"replicas":NUMBER_OF_REPLICAS}}'

Haz los cambios siguientes:

  • KUBERNETES__CLUSTER_KUBECONFIG: el archivo kubeconfig del clúster.

  • NAMESPACE: el espacio de nombres. En el caso de los clústeres compartidos, debe ser un espacio de nombres del proyecto. En el caso de los clústeres estándar, puede ser cualquier espacio de nombres.

  • STATEFULSET_NAME: el nombre del objeto StatefulSet que se va a escalar.

  • NUMBER_OF_REPLICAS: el número de objetos Pod replicados en el objeto StatefulSet.

Siguientes pasos