En esta página se describe cómo restaurar una copia de seguridad en un clúster de Google Kubernetes Engine (GKE) mediante el servicio Copia de seguridad de GKE.
Esta página está dirigida a los administradores de copias de seguridad y recuperación tras fallos que gestionan y realizan copias de seguridad y recuperaciones en toda la organización. Para obtener más información sobre los roles habituales y las tareas de ejemplo a las que hacemos referencia en el contenido de Google Cloud , consulta Roles y tareas de usuario habituales de GKE.
Introducción
Una vez creada una copia de seguridad, los administradores pueden crear una restauración de esa copia, lo que inicia la restauración de una parte del contenido de esa copia en un clúster de destino (que puede ser diferente del clúster desde el que se creó originalmente la copia de seguridad).
Cuando se restaura una copia de seguridad, los recursos de Kubernetes se vuelven a crear en el clúster de destino. Una vez creados los recursos, la restauración real de la capacidad de la carga de trabajo está sujeta al proceso de conciliación de clústeres habitual (por ejemplo, los pods se programan en los nodos y, a continuación, se inician en esos nodos).
Antes de empezar
Planificar un conjunto de restauraciones.
Roles obligatorios
Para obtener los permisos que necesitas para crear y gestionar una restauración,
pide a tu administrador que te conceda el rol de gestión de identidades y accesos
Administrador de restauración de la función de copia de seguridad de GKE (roles/gkebackup.restoreAdmin
), que es un subconjunto del rol Administrador de la función de copia de seguridad de GKE (roles/gkebackup.admin
)
en tu proyecto.
Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.
También puedes conseguir los permisos necesarios a través de roles personalizados u otros roles predefinidos.
Crear una restauración
Puedes restaurar una copia de seguridad con la CLI de Google Cloud o con la Google Cloud consola.
gcloud
Para restaurar una copia de seguridad, ejecuta el siguiente comando:
gcloud beta container backup-restore restores create RESTORE \
--project=PROJECT_ID \
--location=LOCATION \
--restore-plan=RESTORE_PLAN \
--backup=BACKUP
Haz los cambios siguientes:
RESTORE
: el nombre de la restauración que quieras crear.PROJECT_ID
: el ID de tu proyecto de Google Cloud .LOCATION
: la región de cálculo del plan de restauración principal.RESTORE_PLAN
: el nombre del plan de restauración principal del que deriva esta restauración.BACKUP
: la copia de seguridad que se va a restaurar (debe estar ubicada en el plan de copia de seguridad al que hace referencia el plan de restauración principal):projects/PROJECT_ID/locations/LOCATION/backupPlans/BACKUP_PLAN/backups/BACKUP
Para ver la lista completa de opciones, consulta la documentación de gcloud beta container backup-restore restores create
.
La operación de restauración se completa cuando todos los recursos de Kubernetes se han restaurado correctamente a partir de la copia de seguridad. Debes validar que todas las aplicaciones se estén ejecutando después de la restauración.
Consola
Sigue estas instrucciones para crear una restauración en la consola: Google Cloud
Ve a la página Google Kubernetes Engine en la Google Cloud consola.
En el menú de navegación, haga clic en Backup for GKE.
Haz clic en la pestaña Copias de seguridad.
En la lista de copias de seguridad, busca la que quieras restaurar y haz clic en Configurar una restauración.
Elige un plan de restauración de la lista de planes que se aplican a esta copia de seguridad.
Introduce un nombre y, si quieres, una descripción de la restauración.
Haz clic en Restaurar.
La operación de restauración se completa cuando todos los recursos de Kubernetes se han restaurado correctamente a partir de la copia de seguridad. Debes validar que todas las aplicaciones se estén ejecutando después de la restauración.
Ver una restauración
Consulta una restauración y sus detalles mediante la CLI de gcloud o laGoogle Cloud consola.
gcloud
Para enumerar las restauraciones de un plan de restauración, ejecuta el siguiente comando:
gcloud beta container backup-restore restores list \
--project=PROJECT_ID \
--location=LOCATION \
--restore-plan=RESTORE_PLAN
En el caso de los comandos list
, puedes proporcionar -
como valor de cualquier parámetro, excepto PROJECT_ID
. El valor -
actúa como
un comodín. El valor -
es el predeterminado de cualquier parámetro si no especificas una opción de línea de comandos o no defines una propiedad.
Para ver la lista completa de opciones, consulta la documentación de gcloud beta container backup-restore restores list
.
Para ver los detalles de una restauración, ejecuta el siguiente comando:
gcloud beta container backup-restore restores describe RESTORE \
--project=PROJECT_ID \
--location=LOCATION \
--restore-plan=RESTORE_PLAN
Para ver la lista completa de opciones, consulta la documentación de gcloud beta container backup-restore restores describe
.
Consola
Sigue estas instrucciones para ver una restauración y sus detalles en la consola Google Cloud :
Ve a la página Google Kubernetes Engine en la Google Cloud consola.
En el menú de navegación, haga clic en Backup for GKE.
Haz clic en la pestaña Restauraciones.
En la lista de restauraciones, haz clic en el nombre de la restauración y consulta sus detalles.
Ver una restauración de un volumen
Una restauración de volumen es un registro de una restauración de volumen. El agente crea y gestiona automáticamente este recurso como parte de la operación de restauración.
Consulta una restauración de volumen y sus detalles mediante la CLI de gcloud.
gcloud
Para enumerar todas las restauraciones de volúmenes de una restauración, ejecuta el siguiente comando:
gcloud beta container backup-restore volume-restores list \
--project=PROJECT_ID \
--location=LOCATION \
--restore-plan=RESTORE_PLAN \
--restore=RESTORE
Para ver la lista completa de opciones, consulta la gcloud beta container backup-restore volume-restores list
documentación.
Para ver los detalles de una restauración de volumen, ejecuta el siguiente comando:
gcloud beta container backup-restore volume-restores describe VOLUME_RESTORE \
--project=PROJECT_ID \
--location=LOCATION \
--restore-plan=RESTORE_PLAN \
--restore=RESTORE
Para ver la lista completa de opciones, consulta la gcloud beta container backup-restore volume-restores describe
documentación.
Actualizar una restauración
Actualiza una restauración mediante la CLI de gcloud o laGoogle Cloud consola.
gcloud
Para actualizar una restauración (por ejemplo, añadiendo una descripción), ejecuta el siguiente comando:
gcloud beta container backup-restore restores update RESTORE\
--project=PROJECT_ID \
--location=LOCATION \
--restore-plan=RESTORE_PLAN \
--description=DESCRIPTION
Para ver la lista completa de opciones, consulta la documentación de gcloud beta container backup-restore restores update
.
Consola
Sigue estas instrucciones para actualizar una restauración en la Google Cloud consola:
Ve a la página Google Kubernetes Engine en la Google Cloud consola.
En el menú de navegación, haga clic en Backup for GKE.
Haz clic en la pestaña Restaurar.
En la lista de restauraciones, haz clic en el nombre de la restauración.
En el campo Descripción, haz clic en edit Editar. Actualiza la descripción y haz clic en Guardar cambios.
Eliminar una restauración
A diferencia de las copias de seguridad, las restauraciones no tienen artefactos asociados. Después de restaurar una copia de seguridad, puedes eliminar la restauración sin que afecte al clúster de destino ni a la copia de seguridad de origen.
Puedes eliminar una restauración con la CLI de gcloud o laGoogle Cloud consola.
gcloud
Para eliminar una restauración, ejecuta el siguiente comando:
gcloud beta container backup-restore restores delete RESTORE \
--project=PROJECT_ID \
--location=LOCATION \
--restore-plan=RESTORE_PLAN
Para ver la lista completa de opciones, consulta la documentación de gcloud beta container backup-restore restores delete
.
Consola
Sigue estas instrucciones para eliminar una restauración en la consola de Google Cloud :
Ve a la página Google Kubernetes Engine en la Google Cloud consola.
En el menú de navegación, haga clic en Backup for GKE.
Haz clic en la pestaña Restauraciones.
En la lista de restauraciones, haz clic en el nombre de la restauración.
Haz clic en delete Eliminar.
Escribe el nombre del plan de restauración y, a continuación, haz clic en Eliminar en el cuadro de diálogo de confirmación.
Cuestiones importantes
En las versiones de GKE 1.32.3-gke.1748000 y posteriores, si un PersistentVolumeClaim (PVC) usa un StorageClass con el modo de enlace de volumen WaitForFirstConsumer
y ningún pod hace referencia al PVC durante una restauración, el PersistentVolume (PV) se restaura y se vincula al PVC. Este comportamiento se aplica incluso si ningún pod está consumiendo el PVC.
Siguientes pasos
- Consulta más información sobre cómo planificar un conjunto de restauraciones.