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 updatepara 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.
Prepara tu clúster y entorno de almacenamiento, y activa una instantánea de tu carga de trabajo. Para cumplir con estos requisitos, completa las tareas de los siguientes documentos en orden:
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:
Borra el Pod:
kubectl delete pod POD_NAME \ --namespace NAMESPACEReemplaza lo siguiente:
POD_NAME: es el nombre del Pod.NAMESPACE: Es el espacio de nombres de tus Pods.
Vuelve a implementar el Pod:
kubectl apply -f MANIFEST_FILEReemplaza
MANIFEST_FILEpor la ruta de acceso al archivo de manifiesto de tu Pod.Para confirmar que GKE restableció el Pod a partir de la instantánea, consulta los registros del Pod:
kubectl logs POD_NAME \ --namespace NAMESPACEEl 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: restorecuando 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:
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 NAMESPACEReemplaza
NAMESPACEpor el espacio de nombres de tus Pods.En el manifiesto del Pod, agrega la anotación
podsnapshot.gke.io/ps-namey 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 hereReemplaza 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.
Aplica el manifiesto
kubectl apply -f MANIFEST_FILEReemplaza
MANIFEST_FILEpor 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, comoexample-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.