Actualizar cargas de trabajo con reconocimiento del estado

En esta página se explica cómo actualizar las cargas de trabajo con estado que se ejecutan en un clúster de Kubernetes aislado de Google Distributed Cloud (GDC). A medida que tu aplicación evoluciona en función del uso de recursos y las optimizaciones de configuración, debes actualizar la especificación del pod subyacente en el clúster de Kubernetes para reflejar esos cambios en la carga de trabajo. Para obtener más información sobre cómo planificar las actualizaciones de cargas de trabajo con estado, consulta la documentación de Kubernetes sobre estrategias de actualización.

Esta página está dirigida a los desarrolladores del grupo de operadores de aplicaciones, que son responsables de actualizar las cargas de trabajo de las aplicaciones de su organización. Para obtener más información, consulta Audiencias de la documentación aislada de GDC.

Antes de empezar

Para ejecutar comandos en un clúster de Kubernetes, asegúrate de que tienes los siguientes recursos:

  1. Busca el nombre del clúster de Kubernetes o pregunta a tu administrador de la plataforma cuál es.

  2. Inicia sesión y genera el archivo kubeconfig del clúster de Kubernetes si no tienes uno.

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

Para obtener los permisos necesarios para actualizar las cargas de trabajo con estado, pide a tu administrador de gestión de identidades y accesos de la organización que te conceda el rol Administrador de espacio de nombres (namespace-admin) en el espacio de nombres de tu proyecto.

Actualizar un recurso StatefulSet

Para actualizar el StatefulSet, aplica un archivo de manifiesto nuevo o actualizado. Esto es útil para hacer varios cambios en tu StatefulSet al escalar o para especificar una nueva versión de tu aplicación.

Para actualizar un objeto StatefulSet, ejecuta el siguiente comando:

kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG -n NAMESPACE \
    apply -f STATEFULSET_FILE

Haz los cambios siguientes:

  • KUBERNETES_CLUSTER_KUBECONFIG: el archivo kubeconfig del clúster que ejecuta las cargas de trabajo con estado.

  • NAMESPACE: el espacio de nombres del proyecto.

  • STATEFULSET_FILE: el nombre del archivo de manifiesto actualizado.StatefulSet

El comando kubectl apply aplica un archivo de manifiesto a un recurso. Si el recurso especificado no existe, lo crea el comando.

Inspeccionar el lanzamiento de una actualización de recursos de StatefulSet

Puedes ver información detallada sobre el estado de lanzamiento de la actualización y el historial de un objeto StatefulSet. También puedes deshacer el lanzamiento de un objeto StatefulSet.

Inspeccionar el lanzamiento

Para inspeccionar el lanzamiento del recurso StatefulSet, ejecuta el siguiente comando:

kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG -n NAMESPACE \
    rollout status statefulset STATEFULSET_NAME
  • KUBERNETES_CLUSTER_KUBECONFIG: el archivo kubeconfig del clúster que ejecuta las cargas de trabajo con estado.

  • NAMESPACE: el espacio de nombres del proyecto.

  • STATEFULSET_NAME: el nombre del objeto StatefulSet actualizado.

Obtener el historial de lanzamiento

Para ver el historial de lanzamientos del recurso StatefulSet, ejecuta el siguiente comando:

kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG -n NAMESPACE \
    rollout history statefulset STATEFULSET_NAME
  • KUBERNETES_CLUSTER_KUBECONFIG: el archivo kubeconfig del clúster que ejecuta las cargas de trabajo con estado.

  • NAMESPACE: el espacio de nombres del proyecto.

  • STATEFULSET_NAME: el nombre del objeto StatefulSet actualizado.

Deshacer un lanzamiento

Para deshacer un lanzamiento, ejecuta el siguiente comando:

kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG -n NAMESPACE \
    rollout undo statefulset STATEFULSET_NAME

Haz los cambios siguientes:

  • KUBERNETES_CLUSTER_KUBECONFIG: el archivo kubeconfig del clúster que ejecuta las cargas de trabajo con estado.

  • NAMESPACE: el espacio de nombres del proyecto.

  • STATEFULSET_NAME: el nombre del objeto StatefulSet.