Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Restaurar un clúster de Amazon EKS
Puede restaurar las copias de seguridad del clúster de EKS mediante la AWS Backup consola o la CLI. Las copias de seguridad de EKS son puntos de recuperación compuestos que incluyen tanto las copias de seguridad del estado del clúster de EKS como las de los volúmenes persistentes.
AWS Backup admite múltiples experiencias de restauración, incluidas las restauraciones granulares a nivel de espacio de nombres. Las restauraciones no son destructivas y no sobrescribirán ningún objeto de Kubernetes existente en el clúster de EKS de destino. Las restauraciones tampoco sobrescribirán las versiones de Kubernetes del clúster de EKS de destino.
Las copias de seguridad de EKS deben restaurarse en un clúster de EKS de destino, es decir, en un clúster de Amazon EKS que se haya aprovisionado previamente. Como parte del flujo de trabajo de restauración, puede optar por crear un nuevo clúster de EKS que AWS Backup se creará en su nombre.
AWS Backup proporcionará un conjunto limitado de opciones para crear un nuevo clúster de EKS como parte de una restauración. Para todas las funciones de creación de clústeres de EKS, los clientes pueden crear un nuevo clúster de EKS mediante la consola
Capacidades de restauración para Amazon EKS
| Tipo de restauración | Restaurar el destino | Restaurar el comportamiento |
|---|---|---|
| Restauración de clústeres existentes | Restaure al clúster EKS de origen o al clúster EKS existente | Restaura todos los recursos y volúmenes persistentes de Kubernetes en los clústeres de EKS existentes. Todas las restauraciones no son destructivas y los objetos existentes no se sobrescriben. En el caso de los objetos que se omiten, puede suscribirse a las notificaciones de SNS |
| Restauración de un nuevo clúster | Crea un nuevo clúster de Amazon EKS como parte de la restauración de EKS | La restauración crea un nuevo clúster de EKS y restaura todos los recursos y volúmenes persistentes de Kubernetes en un clúster recién creado |
| Restauración del espacio de nombres | Clúster Amazon EKS existente | Restaura solo los espacios de nombres específicos; sus recursos de Kubernetes y las correspondientes restauraciones de almacenamiento persistente no son destructivas y los objetos existentes no se sobrescriben. También se restaurarán todos los recursos del ámbito del clúster. En el caso de los objetos que se omiten, puede suscribirse a las notificaciones de SNS |
| Restauración de almacenamiento persistente | Depende del almacenamiento persistente | Restaure el almacenamiento persistente individual como restauraciones independientes. Consulte Restaurar el comportamiento de Amazon EBS, Amazon S3 y Amazon EFS. |
Permisos
Los permisos necesarios dependen del tipo de restauración y del destino de destino.
-
AWS Backup La política gestionada AWSBackupServiceRolePolicyForRestorescontiene los permisos necesarios para restaurar el clúster de Amazon EKS y el almacenamiento persistente de EBS y EFS.
-
Si su clúster EKS contiene un bucket de S3 o si va a restaurar el punto de recuperación de S3 secundario por sí solo, tendrá que asegurarse de que las siguientes políticas o permisos estén asignados a su función AWSBackupServiceRolePolicyForS3Restore.
Consideraciones antes de la restauración
Antes de comenzar un trabajo de restauración de EKS, revise lo siguiente. Si va a restaurar una copia de seguridad de EKS que se ha copiado en una cuenta o región, asegúrese de tener en cuenta estas consideraciones antes de realizar la restauración para evitar errores en la restauración.
-
Funciones de IAM: al restaurar en un clúster diferente, las funciones de IAM utilizadas en el clúster de origen (como Pod identity o IRSA). El OIDC (configuraciones de proveedor, etc.) debe estar presente en la cuenta o región como clúster de destino.
-
Compruebe la versión y la compatibilidad de EKS: las versiones de API de los objetos que desee restaurar deben ser de la misma versión (o lo más parecidas posible) y ser compatibles con el nuevo clúster. AWS Backup hará todo lo posible por restaurar entre versiones de EKS, aunque pueden surgir problemas de compatibilidad al restaurar entre versiones muy diferentes.
-
Clases de almacenamiento coincidentes: para realizar restauraciones en un clúster EKS existente, asegúrese de instalar los complementos del controlador de almacenamiento CSI adecuados antes de la restauración
-
Depósitos de S3: al restaurar un clúster de EKS con cubos de S3, asegúrese de que el depósito de S3 esté versionado y sea accesible en la cuenta o región de destino.
-
Repositorio de imágenes: al restaurar un clúster de EKS, asegúrese de que la cuenta o región del clúster de EKS de destino tenga acceso a las imágenes a las que se hace referencia como parte de la restauración. Compruebe que su registro tenga los permisos necesarios para la política entre regiones y cuentas.
-
Grupos de seguridad: los grupos de seguridad deben crearse previamente para ALB, Pod Identities, grupos de nodos EKS, etc. en la cuenta y región de destino si va a crear un nuevo clúster de EKS como parte de la restauración
-
Nodos y zonas de disponibilidad de EBS: las zonas de disponibilidad en las que se recuperan los volúmenes de EBS deben asignarse a la zona de disponibilidad de un nodo de EKS existente
-
Non-destructive restauraciones: todas las restauraciones de EKS no serán destructivas y no sobrescribirán los objetos de Kubernetes de la restauración de destino.
-
Habilite los registros de auditoría de EKS: habilite los registros de auditoría de EKS para realizar más registros y solucionar problemas antes de la restauración. También puede suscribirse a las notificaciones de SNS para notificar los objetos omitidos o defectuosos durante la restauración.
-
Búfer de creación y restauración de nuevos clústeres de EKS: al crear un nuevo clúster de EKS durante la restauración, se AWS Backup introduce un búfer de 15 minutos después de que el clúster de EKS alcance un estado disponible, pero antes de crear recursos de EKS adicionales. Este búfer garantiza que todos los componentes de EKS subyacentes se inicialicen por completo antes de que se creen los recursos dependientes.
-
Datos de usuario en la plantilla de lanzamiento: al crear un grupo de nodos mediante una plantilla de lanzamiento, no los especifique
spec.clusteren la sección de datos de usuario de la plantilla de lanzamiento. Amazon EKS inyecta automáticamente los parámetros de identidad del clúster (apiServerEndpointcertificateAuthority, yserviceIpv4Cidr) y los combina con cualquier configuración adicional definida en los datos del usuario. -
Amazon EKS Auto Mode y volúmenes de Amazon EBS restaurados: si el clúster tiene activado Amazon EKS Auto Mode, Auto Mode solo adjunta un volumen de Amazon EBS cuya
eks:eks-cluster-nameetiqueta coincida con el nombre del clúster. AWS Backup no actualiza esta etiqueta en los volúmenes restaurados, por lo que los pods que hacen referencia a los volúmenes restaurados podrían seguir apareciendoFailedAttachVolumeerrores al restaurarlos enContainerCreatingun clúster diferente, incluso si el trabajo de restauración se realiza correctamente. Para resolver este problema, etiquete manualmente cada volumen de Amazon EBS restaurado con el nombre del clúster de destino con el siguiente comando:aws ec2 create-tags --resources vol-123456abcdef --tags Key=eks:eks-cluster-name,Value=destination-cluster-name
Configuraciones de EKS
Cuando restauras el Amazon compuesto AWS Backup, eliges el tipo de restauración y el destino de destino. Puede optar por restaurar en el clúster de EKS de origen, en un clúster de EKS existente o crear un nuevo clúster de EKS como destino de la restauración. En el caso de los nuevos clústeres de EKS, puede optar por utilizar la misma configuración de infraestructura existente (por ejemplo, VPC o subredes) que el clúster del que se hizo la copia de seguridad o configurar otros nuevos. AWS Backup está diseñado para realizar una restauración no destructiva que no sobrescriba los recursos existentes.
Para las restauraciones de espacios de nombres, puedes especificar hasta 5 espacios de nombres para restaurarlos de forma selectiva. También restauraremos todos los recursos del ámbito del clúster.
Como configuración avanzada, puedes optar por cambiar el orden de restauración de los objetos de Kubernetes. De forma predeterminada, AWS Backup restaurará todos los objetos de Kubernetes en el siguiente orden:
Recursos de Kubernetes con alcance de clúster
-
Definiciones de recursos personalizadas
-
Espacios de nombres (el espacio de nombres en sí, no los recursos dentro de ese espacio de nombres)
-
StorageClasses
-
PersistentVolumes
Recursos de Kubernetes con ámbito de espacio de nombres
-
PersistentVolumeClaims
-
Secretos
-
ConfigMaps
-
ServiceAccounts
-
LimitRanges
-
Pods
-
ReplicaSets
Configuraciones de almacenamiento persistente
Como parte de la restauración de la copia de seguridad compuesta de Amazon EKS, el segundo paso consistirá en configurar las configuraciones de almacenamiento persistente. Esto variará en función del almacenamiento persistente del que se haga una copia de seguridad como parte del clúster de EKS.
Para las instantáneas de Amazon EBS, debe proporcionar una zona de disponibilidad en la que se restaurará y creará el volumen de Amazon EBS. AWS Backup A continuación, intentará crear el pod de EKS en la misma zona de disponibilidad que la seleccionada para poder volver a montar el volumen en el clúster de EKS como parte de la restauración.
Como parte de la restauración, AWS Backup volverá a montar los volúmenes de Amazon EBS y los buckets de Amazon S3 en el clúster de EKS restaurado. Los sistemas de archivos Amazon EFS se restauran con prefijos aleatorios y requieren la creación manual de puntos de acceso después de la restauración para volver a montarlos en el clúster de EKS. AWS Backup no crea puntos de acceso ni monta objetivos en su nombre; consulte esta guía para obtener información sobre los puntos de acceso y los objetivos de montaje.
Procedimiento de restauración de Amazon EKS
Siga estos pasos para restaurar las copias de seguridad de Amazon EKS mediante la AWS Backup consola o AWS CLI:
Puede suscribirse a los eventos de notificación de los objetos omitidos o fallidos para restaurarlos. Para obtener más información, consulte Opciones de notificación con AWS Backup.
Mensajes de estado de restauración de Amazon EKS
Cuando se complete un trabajo de restauración, es posible que vea los siguientes mensajes de estado. En la tabla se muestran los posibles escenarios y sus valores de estado de trabajo correspondientes:
| Escenario | Estado del trabajo | Ejemplo de mensaje |
|---|---|---|
| Todos los objetos se restauraron correctamente | COMPLETED | — |
| No se pudieron restaurar uno o más objetos | COMPLETED | «No se pudieron restaurar uno o más objetos de Kubernetes. To get notified of these failures, enable SNS event notifications”. |
| No se ha podido completar la restauración | ERROR | (detalles del error) |
Objetos omitidos durante la restauración
Los siguientes objetos de Kubernetes se restauran haciendo el mejor esfuerzo posible. Si no se restauran, se mueven a la lista omitida. Estos objetos los administra el sistema y los recrea Kubernetes o Amazon EKS:
-
FlowSchemas con la anotación
apf.kubernetes.io/autoupdate-spec: "true" -
PriorityLevelConfigurations con la anotación
apf.kubernetes.io/autoupdate-spec: "true" -
El
eks-exemptFlowSchema (EKS-managed, hace referencia al exento PriorityLevelConfiguration protegido) -
El
kubernetesservicio en el espacio dedefaultnombres (punto final del servidor API) -
El
kube-dnsservicio en el espacio dekube-systemnombres (CoreDNS)
Los siguientes objetos de Kubernetes siempre se omiten durante una restauración. Estos objetos incluyen la infraestructura de nodos y los componentes de red. Hacen referencia al estado específico del clúster. Los controladores de Kubernetes recrean automáticamente estos objetos cuando los nodos y los servicios se activan en el clúster de destino. Si restauras estos objetos a partir de una copia de seguridad, podrían provocar conflictos o errores. Estos conflictos se producen porque los objetos restaurados hacen referencia a recursos que no existen en el clúster de destino.
-
Puntos finales (
v1/endpoints): puntos finales de red que definen las direcciones IP de los servicios. El controlador de puntos finales los gestiona automáticamente en función de los selectores de servicios. -
EndpointSlices (
discovery.k8s.io/v1/endpointslices) - El EndpointSlice controlador gestiona automáticamente estos objetos. -
IPAddresses (
networking.k8s.io/v1/ipaddresses): las redes de Kubernetes administran estas asignaciones de IP internas del clúster. -
CSINodes (
storage.k8s.io/v1/csinodes): el kubelet crea automáticamente estos objetos cuando los controladores CSI se registran en un nodo. -
VolumeAttachments (
storage.k8s.io/v1/volumeattachments) - El attach/detach controlador crea automáticamente estos objetos cuando los pods requieren volúmenes.
También se omiten los objetos que ya existen en el clúster de destino. Las restauraciones de EKS no son destructivas: los objetos existentes nunca se sobrescriben ni se eliminan.
Para recibir notificaciones sobre objetos omitidos o defectuosos durante la restauración, suscríbase a las notificaciones de eventos de SNS. Para obtener más información, consulte Opciones de notificación con. AWS Backup
Consideraciones sobre OIDC e IRSA para la restauración entre clústeres
Al restaurar una copia de seguridad de Amazon EKS en un clúster diferente al de origen, los objetos de Kubernetes que hacen referencia a las funciones de IAM para las cuentas de servicio (IRSA) conservan el punto de enlace del proveedor OIDC del clúster de origen. Estas referencias existen en las anotaciones de las cuentas de servicio y en las políticas de confianza de IAM. AWS Backup no las actualiza automáticamente durante la restauración.
Si sus cargas de trabajo utilizan IRSA, una restauración entre clústeres requiere:
-
El clúster de destino debe tener configurado un proveedor de OIDC.
-
Todas las funciones de IAM a las que hacen referencia las cuentas de servicio de Kubernetes deben tener sus políticas de confianza actualizadas para incluir el punto final del proveedor de OIDC del clúster de destino.
-
Las anotaciones de las cuentas de servicio (
eks.amazonaws.com/role-arn) seguirán haciendo referencia a las funciones originales; compruebe que coincidan con las funciones válidas de la cuenta de destino.
Si no se cumplen estas dependencias, los pods dejarán de asumir las funciones de IAM tras la restauración y es posible que los trabajos de restauración notifiquen errores durante la validación.
Recomendación: Para las cargas de trabajo que requieren la portabilidad de restauración entre clústeres o cuentas, recomendamos utilizar EKS Pod Identity en lugar de IRSA. EKS Pod Identity no depende de proveedores de OIDC específicos para clústeres y simplifica los escenarios de restauración entre clústeres.