Restablece una carga de trabajo a partir de una instantánea de Pod

Para reducir la latencia de inicio de las cargas de trabajo de Google Kubernetes Engine (GKE), puedes restablecer Pods nuevos a partir de una instantánea guardada de un Pod en ejecución. En este documento, se muestra cómo ver las instantáneas existentes, restablecer las cargas de trabajo desde la instantánea más reciente o una instantánea específica, y cómo inhabilitar o borrar instantáneas. Para obtener más información sobre cómo funcionan las instantáneas de Pods, consulta Acerca de las instantáneas de Pods de GKE.

Este documento está dirigido a los administradores y operadores de plataformas, y a los desarrolladores de aplicaciones que administran instantáneas de Pods para sus cargas de trabajo. Para obtener más información sobre los roles comunes y las tareas de ejemplo a las que se hace referencia en el contenido de Google Cloud , consulta Roles y tareas comunes del usuario de GKE.

Antes de comenzar

Antes de comenzar, asegúrate de haber realizado las siguientes tareas:

  • Habilita la API de Google Kubernetes Engine.
  • Habilitar la API de Google Kubernetes Engine
  • Para usar Google Cloud CLI en esta tarea, instala y, luego, inicializa la gcloud CLI. Si ya instalaste gcloud CLI, ejecuta el comando gcloud components update para obtener la versión más reciente. Es posible que las versiones anteriores de gcloud CLI no admitan la ejecución de los comandos de este documento.

Ver instantáneas

Cuando activas una instantánea de Pod, GKE crea un recurso personalizado PodSnapshot que representa el estado del Pod en ese momento. El campo status de este recurso personalizado indica si la operación de instantánea se realizó correctamente y si la instantánea está disponible para restablecer Pods.

Para ver todos los PodSnapshots de un espacio de nombres, ejecuta el siguiente comando:

kubectl get podsnapshots.podsnapshot.gke.io \
    --namespace NAMESPACE

Reemplaza NAMESPACE por el espacio de nombres de tus Pods.

El resultado es similar a lo siguiente:

NAME                                  STATUS                 POLICY          AGE
de334898-1e7a-4cdb-9f2e-7cc2181c29e4  AllSnapshotsAvailable  example-policy  47h

En este resultado, la columna NAME muestra el nombre único que GKE genera automáticamente para cada PodSnapshot. En la columna STATUS, se muestra el valor AllSnapshotsAvailable, lo que significa que la instantánea está lista para restablecer Pods.

Restablece una carga de trabajo a partir de la instantánea más reciente

Cuando se inicia un Pod y coincide con una instantánea existente, GKE lo restablece automáticamente a partir de la instantánea más reciente en lugar de iniciarlo desde un estado nuevo. Puedes activar esta restauración de cualquiera de las siguientes maneras:

  • Crea un Pod nuevo: Implementa un Pod con una especificación idéntica, como cuando agregas réplicas.
  • Vuelve a implementar un Pod existente: borra el Pod existente y, luego, vuelve a implementarlo.

Para restablecer un Pod existente borrándolo y volviéndolo a implementar, sigue estos pasos:

  1. Borra el Pod:

    kubectl delete pod POD_NAME \
        --namespace NAMESPACE
    

    Reemplaza lo siguiente:

    • POD_NAME: es el nombre del Pod.
    • NAMESPACE: Es el espacio de nombres de tus Pods.
  2. Vuelve a implementar el Pod:

    kubectl apply -f MANIFEST_FILE
    

    Reemplaza MANIFEST_FILE por la ruta de acceso al archivo de manifiesto de tu Pod.

  3. Para confirmar que GKE restableció el Pod a partir de la instantánea, consulta los registros del Pod:

    kubectl logs POD_NAME \
        --namespace NAMESPACE
    

    El resultado depende de cómo hayas configurado tu aplicación. Por ejemplo, si implementaste la aplicación de Python de ejemplo de Activa una instantánea desde una carga de trabajo, los registros muestran GKE Pod Snapshot: restore cuando GKE restablece el Pod.

Restablece una carga de trabajo a partir de una instantánea específica

De forma predeterminada, GKE restablece las cargas de trabajo desde el PodSnapshot más reciente que coincida con el Pod. Para restablecer una carga de trabajo desde un PodSnapshot específico, agrega la anotación podsnapshot.gke.io/ps-name a la especificación del Pod de tu carga de trabajo siguiendo estos pasos:

  1. Para encontrar el nombre del PodSnapshot desde el que deseas restablecer, enumera los PodSnapshots en tu espacio de nombres:

    kubectl get podsnapshots.podsnapshot.gke.io \
        --namespace NAMESPACE
    

    Reemplaza NAMESPACE por el espacio de nombres de tus Pods.

  2. En el manifiesto del Pod, agrega la anotación podsnapshot.gke.io/ps-name y especifica el nombre del PodSnapshot:

    apiVersion: v1
    kind: Pod
    metadata:
      name: my-app
      namespace: NAMESPACE
      labels:
        app: my-app
      annotations:
        podsnapshot.gke.io/ps-name: "POD_SNAPSHOT_NAME"
    spec:
      serviceAccountName: SERVICEACCOUNT_NAME
      runtimeClassName: gvisor
      containers:
      # Multiple lines are omitted here
    

    Reemplaza lo siguiente:

    • POD_SNAPSHOT_NAME: Es el nombre del PodSnapshot desde el que deseas restablecer. Usa el nombre que encontraste en el paso anterior.
    • SERVICEACCOUNT_NAME: Es el nombre del objeto ServiceAccount al que le otorgaste acceso a Cloud Storage en Prepárate para las instantáneas de Pods.
  3. Aplica el manifiesto

    kubectl apply -f MANIFEST_FILE
    

    Reemplaza MANIFEST_FILE por la ruta de acceso al archivo de manifiesto de tu Pod.

Para que GKE restablezca el Pod a partir de la instantánea especificada, el PodSnapshot debe existir en el mismo espacio de nombres que el Pod y tener una condición de estado Ready. Si el PodSnapshot no cumple con estos requisitos, el Pod se inicia desde un estado nuevo en lugar de restablecerse desde la instantánea.

Coincidencia y compatibilidad de instantáneas

Cuando GKE restablece un Pod a partir de una instantánea, GKE verifica si una instantánea disponible es compatible con el Pod. Para determinar la compatibilidad, GKE evalúa el orden de selección, los criterios de coincidencia para la ubicación de la instantánea whole-pod o rootfs-only configurada y las reglas de agrupación de instantáneas.

Para obtener más información sobre los requisitos de coincidencia, los criterios de compatibilidad y los campos de especificación de Pods que afectan la compatibilidad, consulta Coincidencia y compatibilidad de instantáneas.

Inhabilitar o borrar instantáneas

Si borras un PodSnapshotPolicy o un PodSnapshot, dependerá de si deseas inhabilitar las instantáneas para una carga de trabajo completa o borrar una instantánea guardada. Un PodSnapshotPolicy rige el comportamiento de las instantáneas para todos los Pods que coinciden con su selector, y cada PodSnapshot representa una sola instantánea.

Para inhabilitar las instantáneas de una carga de trabajo, borra la PodSnapshotPolicy que rige esos Pods. Si borras la política, GKE dejará de tomar instantáneas nuevas o restablecer Pods para esa carga de trabajo, pero no afectará a los Pods en ejecución. Sin embargo, si borras la política mientras GKE guarda o restablece un Pod, este podría entrar en un estado de error.

Para borrar un PodSnapshotPolicy, ejecuta el siguiente comando:

kubectl delete podsnapshotpolicies.podsnapshot.gke.io \
    SNAPSHOT_POLICY \
    --namespace NAMESPACE

Reemplaza lo siguiente:

  • SNAPSHOT_POLICY: Es el nombre de la PodSnapshotPolicy que deseas borrar, como example-pod-snapshot-policy.
  • NAMESPACE: Es el espacio de nombres de tus Pods.

También puedes borrar un PodSnapshot específico para que GKE ya no restablezca Pods a partir de esa instantánea. Si borras el PodSnapshot, también se borrarán los archivos de instantáneas correspondientes almacenados en Cloud Storage.

Para borrar un PodSnapshot específico, ejecuta el siguiente comando:

kubectl delete podsnapshots.podsnapshot.gke.io \
    POD_SNAPSHOT_NAME \
    --namespace NAMESPACE

Reemplaza POD_SNAPSHOT_NAME por el nombre del PodSnapshot que deseas borrar, como de334898-1e7a-4cdb-9f2e-7cc2181c29e4.

¿Qué sigue?