En Google Kubernetes Engine (GKE), puedes usar la función de instantánea de volumen de Kubernetes para volúmenes persistentes en los clústeres de GKE.
Las instantáneas de volumen te permiten crear una copia del volumen en un momento específico. Puedes usar esta copia para hacer que un volumen vuelva a su estado anterior o para aprovisionar un volumen nuevo.
A partir de la versión 1.17 o posterior de GKE, puedes aprovisionar y adjuntar instantáneas de volumen con los siguientes componentes:
Requisitos
Para usar instantáneas de volumen en GKE, debes cumplir con los siguientes requisitos:
Usa un controlador CSI que admita instantáneas. El controlador de disco persistente en el árbol no admite instantáneas.
- El controlador CSI de disco persistente de Compute Engine se instala de forma predeterminada en los clústeres nuevos de Linux que ejecutan la versión 1.18.10-gke.2100 o posterior, o la versión 1.19.3-gke.2100 o posterior. También puedes habilitar el controlador de CSI de disco persistente de Compute Engine en un clúster existente.
- También puedes implementar de forma automática el controlador CSI de Filestore. Para obtener una lista de todos los controladores CSI que admiten instantáneas, consulta la columna “Other features” en Controladores en la documentación de Kubernetes.
Usa las versiones 1.17 o posteriores del plano de control. Para usar el controlador CSI de disco persistente de Compute Engine en una VolumeSnapshot, usa la versión de GKE 1.17.6-gke.4 o posteriores. Para usar el controlador CSI de Filestore en una VolumeSnapshot, usa la versión de GKE 1.21 o posterior.
Tienes un
PersistentVolumeClaim
existente para usar en una instantánea. ElPersistentVolume
que usas para una fuente de instantáneas debe ser administrado por un controlador CSI. Puedes verificar que usas un controlador CSI si verificas que la especificación dePersistentVolume
tenga una seccióncsi
condriver: pd.csi.storage.gke.io
ofilestore.csi.storage.gke.io
. Si el controlador CSI aprovisiona de forma dinámica el PersistentVolume como se describe en las siguientes secciones, entonces lo administra el controlador CSI.
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
- Si deseas usar Google Cloud CLI para esta tarea, instala y, luego, inicializa la CLI de gcloud.
Crea y usa una instantánea de volumen
En los ejemplos de este documento, se muestra cómo hacer las siguientes tareas:
- Crear un
PersistentVolumeClaim
y Deployment. - Agregar un archivo al recurso PersistentVolume que usa el Deployment.
- Crear un
VolumeSnapshotClass
para configurar la instantánea. - Crear una instantánea de volumen del PersistentVolume.
- Borrar el archivo de prueba.
- Restablecer el
PersistentVolume
en la instantánea que creaste. - Verificar que la restauración funcionó.
Para usar una instantánea de volumen, debes completar los siguientes pasos:
- Crea un objeto
VolumeSnapshotClass
a fin de especificar el controlador CSI y la política de eliminación para tu instantánea. - Crea un objeto
VolumeSnapshot
para solicitar una instantánea de un PersistentVolumeClaim existente. - Haz referencia a
VolumeSnapshot
en unaPersistentVolumeClaim
para restablecer un volumen en esa instantánea o crear un volumen nuevo con la instantánea.
Crea un PersistentVolumeClaim y un Deployment
Para crear el objeto
PersistentVolumeClaim
, guarda el siguiente manifiesto comomy-pvc.yaml
:apiVersion: v1 kind: PersistentVolumeClaim metadata: name: my-pvc spec: storageClassName: standard-rwo accessModes: - ReadWriteOnce resources: requests: storage: 1Gi
Para
spec.storageClassName
, puedes especificar cualquier clase de almacenamiento que use un controlador CSI compatible. En este ejemplo, se usa la clase de almacenamientostandard-rwo
instalada de forma predeterminada con el controlador CSI del disco persistente de Compute Engine. Para obtener más información, consulta Usa el controlador CSI del disco persistente de Compute Engine.Aplica el manifiesto
kubectl apply -f my-pvc.yaml
Para crear un Deployment, guarda el siguiente manifiesto como
my-deployment.yaml
:apiVersion: apps/v1 kind: Deployment metadata: name: hello-app spec: selector: matchLabels: app: hello-app template: metadata: labels: app: hello-app spec: containers: - name: hello-app image: google/cloud-sdk:slim args: [ "sleep", "3600" ] volumeMounts: - name: sdk-volume mountPath: /usr/share/hello/ volumes: - name: sdk-volume persistentVolumeClaim: claimName: my-pvc
Aplica el manifiesto
kubectl apply -f my-deployment.yaml
Verifica el estado del Deployment:
kubectl get deployment hello-app
Es posible que el Deployment tarde un poco en estar listo. Puedes ejecutar el comando anterior hasta que veas un resultado similar al siguiente:
NAME READY UP-TO-DATE AVAILABLE AGE hello-app 1/1 1 1 2m55s
Agrega un archivo de prueba al volumen
Enumera los Pods en el Deployment:
kubectl get pods -l app=hello-app
El resultado es similar a este:
NAME READY STATUS RESTARTS AGE hello-app-6d7b457c7d-vl4jr 1/1 Running 0 2m56s
Crea un archivo de prueba en un pod:
kubectl exec POD_NAME \ -- sh -c 'echo "Hello World!" > /usr/share/hello/hello.txt'
Reemplaza
POD_NAME
con el nombre del pod.Verifica que el archivo exista:
kubectl exec POD_NAME \ -- sh -c 'cat /usr/share/hello/hello.txt'
El resultado es similar al siguiente:
Hello World!
Crea un objeto VolumeSnapshotClass
Crea un objeto VolumeSnapshotClass
a fin de especificar el controlador CSI y deletionPolicy
para la instantánea de volumen. Puedes hacer referencia a objetos VolumeSnapshotClass
cuando creas objetos VolumeSnapshot
.
Guarda el siguiente manifiesto como
volumesnapshotclass.yaml
.v1
Usa la versión de la API
v1
para clústeres que ejecutan la versión 1.21 o posterior.apiVersion: snapshot.storage.k8s.io/v1 kind: VolumeSnapshotClass metadata: name: my-snapshotclass driver: pd.csi.storage.gke.io deletionPolicy: Delete
v1beta1
Usa la versión de la API
v1beta1
para clústeres que ejecutan las versiones 1.21 o anteriores.apiVersion: snapshot.storage.k8s.io/v1beta1 kind: VolumeSnapshotClass metadata: name: my-snapshotclass driver: pd.csi.storage.gke.io deletionPolicy: Delete
En este ejemplo:
El controlador de CSI usa el campo
driver
para aprovisionar la instantánea. En este ejemplo,pd.csi.storage.gke.io
usa el controlador CSI del disco persistente de Compute Engine.El campo
deletionPolicy
le indica a GKE qué hacer con el objetoVolumeSnapshotContent
y la instantánea subyacente cuando se borra el objetoVolumeSnapshot
vinculado. EspecificaDelete
para borrar el objetoVolumeSnapshotContent
y la instantánea subyacente. EspecificaRetain
si deseas conservarVolumeSnapshotContent
y la instantánea subyacente.
Para usar una ubicación de almacenamiento personalizada, agrega un parámetro
storage-locations
a la clase de instantánea. Para usar este parámetro, tus clústeres deben usar la versión 1.21 o posterior.apiVersion: snapshot.storage.k8s.io/v1 kind: VolumeSnapshotClass metadata: name: my-snapshotclass parameters: storage-locations: us-east2 driver: pd.csi.storage.gke.io deletionPolicy: Delete
Aplica el manifiesto
kubectl apply -f volumesnapshotclass.yaml
Crea una VolumeSnapshot
Un objeto VolumeSnapshot
es una solicitud de una instantánea de un objeto PersistentVolumeClaim
existente. Cuando creas un objeto VolumeSnapshot
, GKE lo crea y lo vincula de forma automática con un objeto VolumeSnapshotContent
, que es un recurso en el clúster similar a un objeto PersistentVolume
.
Guarda el siguiente manifiesto como
volumesnapshot.yaml
.v1
Usa la versión de la API
v1
para clústeres que ejecutan la versión 1.21 o posterior.apiVersion: snapshot.storage.k8s.io/v1 kind: VolumeSnapshot metadata: name: my-snapshot spec: volumeSnapshotClassName: my-snapshotclass source: persistentVolumeClaimName: my-pvc
v1beta1
Usa la versión de la API
v1beta1
para clústeres que ejecutan las versiones 1.21 o anteriores.apiVersion: snapshot.storage.k8s.io/v1beta1 kind: VolumeSnapshot metadata: name: my-snapshot spec: volumeSnapshotClassName: my-snapshotclass source: persistentVolumeClaimName: my-pvc
Aplica el manifiesto
kubectl apply -f volumesnapshot.yaml
Después de crear una instantánea de volumen, GKE crea un objeto
VolumeSnapshotContent
correspondiente en el clúster. Este objeto almacena la instantánea y las vinculaciones de objetosVolumeSnapshot
. No se interactúa directamente con los objetosVolumeSnapshotContents
.Confirma que GKE creó el objeto
VolumeSnapshotContents
:kubectl get volumesnapshotcontents
El resultado es similar a este:
NAME AGE snapcontent-cee5fb1f-5427-11ea-a53c-42010a1000da 55s
Después de crear el contenido de la instantánea de volumen, el controlador CSI que especificaste en VolumeSnapshotClass
crea una instantánea en el sistema de almacenamiento correspondiente. Una vez que GKE crea una instantánea en el sistema de almacenamiento y la vincula a un objeto de VolumeSnapshot
del clúster, la instantánea está lista para usarse. Para verificar el estado, ejecuta el siguiente comando:
kubectl get volumesnapshot \
-o custom-columns='NAME:.metadata.name,READY:.status.readyToUse'
Si la instantánea está lista para usarse, el resultado es similar al siguiente:
NAME READY
my-snapshot true
Borra el archivo de prueba
Borra el archivo de prueba que creaste:
kubectl exec POD_NAME \ -- sh -c 'rm /usr/share/hello/hello.txt'
Verifica que el archivo ya no exista:
kubectl exec POD_NAME \ -- sh -c 'cat /usr/share/hello/hello.txt'
El resultado es similar al siguiente:
cat: /usr/share/hello/hello.txt: No such file or directory
Restablece la instantánea de volumen
Puedes hacer referencia a una VolumeSnapshot
en un PersistentVolumeClaim
para aprovisionar un volumen nuevo con datos de un volumen existente o restablecer un volumen a un estado que capturaste en la instantánea.
Para hacer referencia a una VolumeSnapshot
en un PersistentVolumeClaim
, agrega el campo dataSource
a tu PersistentVolumeClaim
.
En este ejemplo, debes hacer referencia a la VolumeSnapshot
que creaste en un PersistentVolumeClaim
nueva y actualizar el Deployment para que use la reclamación nueva.
Guarda el siguiente manifiesto como
pvc-restore.yaml
:apiVersion: v1 kind: PersistentVolumeClaim metadata: name: pvc-restore spec: dataSource: name: my-snapshot kind: VolumeSnapshot apiGroup: snapshot.storage.k8s.io storageClassName: standard-rwo accessModes: - ReadWriteOnce resources: requests: storage: 1Gi
Aplica el manifiesto
kubectl apply -f pvc-restore.yaml
Actualiza el archivo
my-deployment.yaml
para usar elPersistentVolumeClaim
nuevo:... volumes: - name: my-volume persistentVolumeClaim: claimName: pvc-restore
Aplica el manifiesto actualizado:
kubectl apply -f my-deployment.yaml
Verifica que la instantánea se haya restablecido correctamente
Obtén el nombre del Pod nuevo que GKE crea para la Deployment actualizada:
kubectl get pods -l app=hello-app
Verifica que el archivo de prueba exista:
kubectl exec NEW_POD_NAME \
-- sh -c 'cat /usr/share/hello/hello.txt'
Reemplaza NEW_POD_NAME
con el nombre del pod de GKE nuevo creado.
El resultado es similar a este:
Hello World!
Limpia
Sigue estos pasos para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que usaste en esta página.
Borra
VolumeSnapshot
:kubectl delete volumesnapshot my-snapshot
Borra
VolumeSnapshotClass
:kubectl delete volumesnapshotclass my-snapshotclass
Borra la implementación:
kubectl delete deployments hello-app
Borra los objetos
PersistentVolumeClaim
:kubectl delete pvc my-pvc pvc-restore
¿Qué sigue?
- Lee la documentación de Instantáneas de volumen de Kubernetes.
- Obtenga información sobre volume expansion (expansión de volumen).
- Obtén más información sobre cómo instalar un controlador CSI forma manual.