En este documento, se describe cómo crear copias de seguridad de clústeres de administrador y de usuario de la versión 1.32 de Google Distributed Cloud y versiones posteriores, y cómo restablecerlos, si tienen habilitado el clúster avanzado.
El proceso de copia de seguridad y restablecimiento de gkectl no incluye volúmenes persistentes. Los volúmenes creados por el aprovisionador de volumen local (LVP) no se modifican.
Crea una copia de seguridad de un clúster
El comando gkectl backup cluster agrega la información del clúster del depósito de etcd y los certificados de PKI para el clúster especificado a un archivo tar. El almacén de etcd es el almacenamiento de copia de seguridad de Kubernetes para todos los datos del clúster y contiene todos los objetos de Kubernetes y objetos personalizados requeridos para administrar el estado del clúster. Los certificados de PKI se usan para la autenticación con seguridad de la capa de transporte (TLS).
Estos datos tienen copia de seguridad desde el plano de control del clúster o en uno de los planos de control para una implementación con alta disponibilidad (HA).
El archivo tar de copia de seguridad contiene credenciales sensibles, incluidas las claves de tu cuenta de servicio y la clave SSH. Almacena los archivos de copia de seguridad en una ubicación segura. Para evitar una exposición accidental de archivos, el proceso de copia de seguridad solo usa archivos en la memoria.
Realiza una copia de seguridad de tus clústeres con regularidad para asegurarte de que tus datos de instantáneas sean relativamente actuales. Ajusta la velocidad de las copias de seguridad para reflejar la frecuencia de los cambios significativos en los clústeres.
Antes de comenzar, asegúrate de que tu clúster funcione correctamente, con credenciales de trabajo y conectividad SSH a todos los nodos. El intent del proceso de copia de seguridad es capturar el clúster en un buen estado conocido para que puedas restablecer la operación si ocurre una falla catastrófica.
Para crear una copia de seguridad de un clúster, haz lo siguiente:
Ejecuta el siguiente comando para verificar tu clúster:
gkectl diagnose cluster --cluster-name CLUSTER_NAME \ --kubeconfig ADMIN_KUBECONFIGReemplaza lo siguiente:
CLUSTER_NAME: Es el nombre del clúster del que deseas crear una copia de seguridad.
ADMIN_KUBECONFIG por la ruta de acceso del archivo kubeconfig del clúster de administrador.
Ejecuta el comando correspondiente para crear una copia de seguridad del clúster:
Clúster de administrador
gkectl backup admin --kubeconfig ADMIN_KUBECONFIGClúster de usuario
gkectl backup cluster --cluster-name CLUSTER_NAME \ --kubeconfig ADMIN_KUBECONFIG
De forma predeterminada, el archivo tar de copia de seguridad se guarda en el directorio gkectl-workspace/backups de tu estación de trabajo de administrador. El archivo tar se llama CLUSTER_NAME_backup_TIMESTAMP.tar.gz, en el que CLUSTER_NAME es el nombre del clúster en el que se crea una copia de seguridad y TIMESTAMP es la fecha y hora en que se realizó la copia de seguridad. Por ejemplo, si el nombre del clúster es testuser, el archivo de copia de seguridad tiene un nombre como testuser_backup_2006-01-02T150405Z0700.tar.gz.
Para especificar un nombre y una ubicación diferentes para el archivo de copia de seguridad, usa la marca --backup-file.
El archivo de copia de seguridad se vence después de un año y el proceso de restablecimiento del clúster no funciona con los archivos de copia de seguridad vencidos.
El archivo de copia de seguridad también se puede subir a tu servidor de vCenter si la siguiente sección está configurada en el archivo de configuración del clúster de administrador: clusterBackup:
datastore: DATASTORE
Reemplaza DATASTORE por el almacén de datos en el que deseas almacenar la copia de seguridad. El almacén de datos debe estar en el mismo centro de datos que el clúster de administrador. Las copias de seguridad se encuentran en el directorio anthos/CLUSTER_NAME/backup del almacén de datos especificado.
Restablece un clúster
Restablecer un clúster desde una copia de seguridad es el último recurso y solo debe usarse cuando un clúster falla de manera catastrófica y no puede regresar al servicio de ninguna otra manera. Por ejemplo, los datos etcd están dañados o el Pod de etcd está en un bucle de falla.
El archivo tar de copia de seguridad contiene credenciales sensibles, incluidas las claves de tu cuenta de servicio y la clave SSH. Para evitar una exposición accidental de archivos, el proceso de restablecimiento de Google Distributed Cloud solo usa archivos en la memoria.
Antes de restablecer un clúster, asegúrate de que se cumplan las siguientes condiciones:
- Asegúrate de que todas las máquinas de nodo del plano de control que estaban disponibles para el clúster en el momento de la copia de seguridad funcionen de forma correcta y se pueda acceder a ellas.
- Asegúrate de que la conectividad SSH entre nodos funcione con las claves SSH que se usaron en el momento de la copia de seguridad. Estas claves SSH se restablecen como parte del proceso de restablecimiento.
- Asegúrate de que las claves de la cuenta de servicio que se usaron en el momento de la copia de seguridad aún estén activas. Estas claves de cuenta de servicio se restablecen para el clúster recuperado.
Para restablecer un clúster, haz lo siguiente:
Ejecuta el comando correspondiente para restablecer el clúster:
Clúster de administrador
gkectl restore admin --backup-file BACKUP_FILE \ --config ADMIN_CONFIGReemplaza lo siguiente:
BACKUP_FILE: la ruta de acceso y el nombre del archivo de copia de seguridad que usas.ADMIN_CONFIG: Es la ruta de acceso al archivo de configuración del clúster de administrador.
Clúster de usuario
gkectl restore cluster --cluster-name CLUSTER_NAME \ --backup-file BACKUP_FILE \ --kubeconfig ADMIN_KUBECONFIGReemplaza lo siguiente:
CLUSTER_NAME: el nombre del clúster que deseas restablecer.BACKUP_FILE: la ruta de acceso y el nombre del archivo de copia de seguridad que usas.ADMIN_KUBECONFIGes la ruta al archivo kubeconfig del clúster de administrador.
Al final del proceso de restablecimiento, se genera un archivo kubeconfig nuevo para el clúster restablecido en el directorio del espacio de trabajo
gkectl-workspace.Cuando finalice el restablecimiento, ejecuta el siguiente comando para verificar que se haya realizado correctamente:
gkectl diagnose cluster --cluster-name CLUSTER_NAME \ --kubeconfig GENERATED_KUBECONFIGReemplaza
GENERATED_KUBECONFIGpor el archivo kubeconfig generado.
Solucionar problemas
Si tienes problemas con el proceso de copia de seguridad o restablecimiento, las siguientes secciones podrían ayudarte a solucionarlos.
Si necesitas asistencia adicional, comunícate con el equipo de Atención al cliente de Cloud.
Se agota la memoria durante una copia de seguridad o un restablecimiento
Si la estación de trabajo en la que ejecutas el comando gkectl no tiene mucha RAM, es posible que no tengas suficiente memoria para realizar el proceso de copia de seguridad o restablecimiento. Si es necesario, crea y usa un disco de almacenamiento temporal para procesar las operaciones de copia de seguridad o restablecimiento con el parámetro --use-disk en el comando de copia de seguridad. Para preservar los permisos de los archivos, este parámetro modifica los permisos de los archivos, por lo que requiere que ejecutes el comando como usuario raíz (o uses sudo).
La actualización de la clave SSH después de una copia de seguridad interrumpe el proceso de restablecimiento.
Es posible que las operaciones relacionadas con SSH durante el proceso de restablecimiento fallen si la clave SSH se actualiza después de que se realizó una copia de seguridad. En este caso, la nueva clave SSH deja de ser válida para el proceso de restablecimiento. Para resolver este problema, puedes volver a agregar temporalmente la clave SSH original y, luego, realizar el restablecimiento. Una vez que se complete el proceso de restablecimiento, podrás rotar la clave de SSH.