Actualizar cargas de trabajo con reconocimiento del estado

En este documento 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 de 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 las cargas de trabajo con estado, consulta la documentación de Kubernetes sobre estrategias de actualización.

Este documento está dirigido 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 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 IAM

Debes tener roles específicos para obtener los permisos que necesitas para actualizar las 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 IAM de 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 IAM de proyecto que te asigne el rol Desarrollador de clústeres (cluster-developer). Este rol está vinculado al espacio de nombres de tu proyecto.

Prepara tu 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.

Actualizar un recurso StatefulSet

Para actualizar el StatefulSet, aplica un archivo de manifiesto nuevo o actualizado. Esto resulta ú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 lo siguiente:

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. En el caso de los clústeres compartidos, debe ser un espacio de nombres de proyecto. En el caso de los clústeres estándar, puede ser cualquier espacio de nombres.

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

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 un recurso StatefulSet

Puedes ver información detallada sobre el estado y el historial del lanzamiento de la actualización 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 lo siguiente:

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. En el caso de los clústeres compartidos, debe ser un espacio de nombres de proyecto. En el caso de los clústeres estándar, puede ser cualquier espacio de nombres.

  • STATEFULSET_NAME: el nombre del objeto StatefulSet actualizado.

Obtener el historial de lanzamientos

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

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. En el caso de los clústeres compartidos, debe ser un espacio de nombres de proyecto. En el caso de los clústeres estándar, puede ser cualquier espacio de nombres.

  • STATEFULSET_NAME: el nombre del objeto StatefulSet actualizado.

Deshacer un lanzamiento

Para deshacer un lanzamiento, ejecuta lo siguiente:

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. En el caso de los clústeres compartidos, debe ser un espacio de nombres de proyecto. En el caso de los clústeres estándar, puede ser cualquier espacio de nombres.

  • STATEFULSET_NAME: el nombre del objeto StatefulSet.

Siguientes pasos