As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Restaurar um cluster Amazon EKS
Você pode restaurar os backups do cluster EKS usando o AWS Backup console ou a CLI. Os backups do EKS são pontos de recuperação compostos que incluem tanto o estado do cluster EKS quanto os backups de volume persistentes.
AWS Backup oferece suporte a várias experiências de restauração, incluindo restaurações granulares em nível de namespace. As restaurações não são destrutivas e não substituirão nenhum objeto Kubernetes existente no cluster EKS de destino. As restaurações também não substituirão as versões do Kubernetes do cluster EKS de destino.
Os backups do EKS precisam ser restaurados em um cluster EKS de destino, ou seja, um cluster Amazon EKS que tenha sido pré-provisionado. Como parte do fluxo de trabalho de restauração, você pode optar por criar um novo cluster EKS que AWS Backup será criado em seu nome.
AWS Backup fornecerá um conjunto limitado de opções para criar um novo cluster EKS como parte de uma restauração. Para todas as funcionalidades de criação de clusters EKS, os clientes podem criar um novo cluster EKS usando o console EKS
Recursos de restauração para o Amazon EKS
| Tipo de restauração | Destino da restauração | Restaurar comportamento |
|---|---|---|
| Restauração de cluster existente | Restaurar no cluster EKS de origem ou no cluster EKS existente | Restaura todos os recursos e volumes persistentes do Kubernetes nos clusters EKS existentes. Todas as restaurações não são destrutivas e os objetos existentes não são substituídos. Para objetos que são ignorados, você pode assinar as Notificações do SNS |
| Nova restauração de cluster | Cria um novo cluster Amazon EKS como parte da sua restauração do EKS | Restore cria um novo cluster EKS e restaura todos os recursos e volumes persistentes do Kubernetes no cluster recém-criado |
| Restauração de namespace | Cluster Amazon EKS existente | Restaura somente namespaces especificados, seus recursos do Kubernetes e as restaurações de armazenamento persistente correspondentes não são destrutivas e os objetos existentes não são substituídos. Todos os recursos do escopo do cluster também serão restaurados. Para objetos que são ignorados, você pode assinar as Notificações do SNS |
| Restauração persistente do armazenamento | Depende do armazenamento persistente | Restaure o armazenamento persistente individual como restaurações autônomas. Consulte Comportamento de restauração do Amazon EBS, Amazon S3, Amazon EFS. |
Permissões
As permissões necessárias dependem do tipo de restauração e do destino de destino.
-
AWS Backup A política gerenciada da AWSBackupServiceRolePolicyForRestorescontém as permissões necessárias para restaurar seu cluster Amazon EKS e o armazenamento persistente do EBS e do EFS.
-
Se o seu cluster EKS contiver um bucket do S3, ou se você estiver restaurando o ponto de recuperação secundário do S3 sozinho, você precisará garantir que as seguintes políticas ou permissões sejam atribuídas à sua função. AWSBackupServiceRolePolicyForS3Restore
Considerações antes da restauração
Antes de iniciar um trabalho de restauração do EKS, revise o seguinte. Se você estiver restaurando um backup do EKS que foi copiado em toda a conta ou região, verifique essas considerações antes das restaurações para evitar falhas na restauração.
-
Funções do IAM: ao restaurar em um cluster diferente, as funções do IAM usadas no cluster de origem (como identidade do pod, IRSA). As configurações do provedor OIDC, etc.) devem estar presentes na conta/região como o cluster de destino.
-
Garanta a versão e a compatibilidade do EKS: as versões da API dos objetos que você deseja restaurar devem ser da mesma versão (ou a mais próxima possível) e compatíveis com o novo cluster. AWS Backup executará o melhor esforço de restauração entre as versões do EKS, embora possam surgir problemas de compatibilidade ao restaurar entre versões significativamente diferentes.
-
Classes de armazenamento correspondentes: para restaurações em um cluster EKS existente, certifique-se de que os complementos apropriados do driver de armazenamento CSI estejam instalados antes da restauração
-
S3 Buckets: ao restaurar um cluster EKS com S3 Buckets, certifique-se de que seu bucket S3 esteja versionado e acessível na conta ou região de destino.
-
Repositório de imagens: ao restaurar um cluster EKS, certifique-se de que a conta ou região do cluster EKS de destino tenha acesso às imagens que estão sendo referenciadas como parte da restauração. Verifique se seu registro tem permissões suficientes entre regiões e políticas de conta.
-
Grupos de segurança: os grupos de segurança devem ser pré-criados para ALB, Pod Identities, EKS Node Groups etc. na conta e região de destino se estiver criando um novo cluster EKS como parte de sua restauração
-
Zonas e nós de disponibilidade do EBS: as zonas de disponibilidade nas quais você recupera seus volumes do EBS devem ser mapeadas para a zona de disponibilidade de um nó EKS existente
-
Non-destructive restaurações: todas as restaurações do EKS não serão destrutivas e não substituirão os objetos Kubernetes da restauração de destino.
-
Ativar registros de auditoria do EKS: habilite os registros de auditoria do EKS para registro adicional e solução de problemas antes da restauração. Você também pode assinar as notificações do SNS para notificar objetos ignorados ou com falha na restauração.
-
Novo buffer de restauração de criação de cluster EKS: ao criar um novo cluster EKS durante a restauração, AWS Backup introduz um buffer de 15 minutos após o cluster EKS atingir um estado disponível, mas antes de criar quaisquer recursos adicionais do EKS. Esse buffer garante que todos os componentes EKS subjacentes sejam totalmente inicializados antes que os recursos dependentes sejam criados.
-
Dados do usuário no modelo de execução: ao criar um grupo de nós usando um modelo de execução, não especifique
spec.clusterna seção de dados do usuário do modelo de execução. O Amazon EKS injeta automaticamente os parâmetros de identidade do cluster (apiServerEndpointcertificateAuthority,, eserviceIpv4Cidr) e os mescla com qualquer configuração adicional definida nos dados do usuário. -
Modo automático do Amazon EKS e volumes restaurados do Amazon EBS: se o cluster tiver o modo automático do Amazon EKS ativado, o modo automático anexará somente um volume do Amazon EBS cuja
eks:eks-cluster-nametag corresponda ao nome do cluster. AWS Backup não atualiza essa tag nos volumes restaurados, portanto, os pods que fazem referência aos volumes restaurados podem permanecerContainerCreatingcomFailedAttachVolumeerros ao restaurar em um cluster diferente, mesmo que o trabalho de restauração seja bem-sucedido. Para resolver isso, marque manualmente cada volume restaurado do Amazon EBS com o nome do cluster de destino com o seguinte comando:aws ec2 create-tags --resources vol-123456abcdef --tags Key=eks:eks-cluster-name,Value=destination-cluster-name
Configurações do EKS
Ao restaurar o Amazon composto AWS Backup, você escolhe o tipo de restauração e o destino de destino. Você pode optar por restaurar no cluster EKS de origem, em um cluster EKS existente ou criar um novo cluster EKS como destino de restauração. Para novos clusters EKS, você pode optar por usar as mesmas configurações de infraestrutura existentes (por exemplo, VPC, sub-redes) do cluster de backup ou configurar novas. AWS Backup foi projetado para realizar uma restauração não destrutiva que não substitua os recursos existentes.
Para restaurações de namespaces, você pode especificar até 5 namespaces para restaurar seletivamente. Também restauraremos todos os recursos do escopo do cluster.
Como configuração avançada, você pode optar por alterar a ordem de restauração dos objetos do Kubernetes. Por padrão, AWS Backup restaurará todos os objetos do Kubernetes na seguinte ordem:
Recursos de Kubernetes com escopo de cluster
-
Definições de recursos personalizados
-
Namespaces (o namespace em si, não os recursos dentro desse namespace)
-
StorageClasses
-
PersistentVolumes
Recursos do Kubernetes com escopo de namespace
-
PersistentVolumeClaims
-
Segredos
-
ConfigMaps
-
ServiceAccounts
-
LimitRanges
-
Pods
-
ReplicaSets
Configurações de armazenamento persistente
Como parte da restauração de backup composta do Amazon EKS, a segunda etapa será configurar suas configurações de armazenamento persistente. Isso variará com base no armazenamento persistente de backup como parte do seu cluster EKS.
Para os snapshots do Amazon EBS, é necessário fornecer uma zona de disponibilidade, na qual o volume do Amazon EBS será restaurado e criado. AWS Backup em seguida, tentará criar o pod EKS na mesma zona de disponibilidade selecionada para que seu volume possa ser remontado em seu cluster EKS como parte da restauração.
Como parte da restauração, AWS Backup remontará seus volumes do Amazon EBS e buckets do Amazon S3 em seu cluster EKS restaurado. Os sistemas de arquivos do Amazon EFS são restaurados para prefixos aleatórios e exigem a criação manual de pontos de acesso após a restauração para serem remontados em seu cluster EKS. AWS Backup não cria pontos de acesso nem monta alvos em seu nome. Consulte as orientações aqui para pontos de acesso e alvos de montagem.
Procedimento de restauração do Amazon EKS
Siga estas etapas para restaurar os backups do Amazon EKS usando o AWS Backup console ou AWS CLI:
Você pode se inscrever em Eventos de Notificação de objetos falhados e ignorados para restauração. Para obter mais informações, consulte Opções de notificação com AWS Backup.
Mensagens de status de restauração do Amazon EKS
Quando um trabalho de restauração for concluído, você poderá ver as seguintes mensagens de status. A tabela mostra os cenários possíveis e seus valores de status de trabalho correspondentes:
| Cenário | Status do trabalho | Mensagem de exemplo |
|---|---|---|
| Todos os objetos foram restaurados com sucesso | CONCLUÍDO | — |
| Falha na restauração de um ou mais objetos | CONCLUÍDO | “Falha na restauração de um ou mais objetos do Kubernetes. Para receber um aviso sobre essas falhas, ative as notificações de eventos do SNS.” |
| A restauração não pôde ser concluída | FAILED | (detalhes do erro) |
Objetos ignorados durante a restauração
Os seguintes objetos do Kubernetes são restaurados com base no melhor esforço. Se não conseguirem restaurar, serão movidos para a lista ignorada. Esses objetos são gerenciados pelo sistema e recriados pelo Kubernetes ou pelo Amazon EKS:
-
FlowSchemas com a
apf.kubernetes.io/autoupdate-spec: "true"anotação -
PriorityLevelConfigurations com a
apf.kubernetes.io/autoupdate-spec: "true"anotação -
O
eks-exemptFlowSchema (EKS-managed, faz referência ao isento PriorityLevelConfiguration protegido) -
O
kubernetesserviço nodefaultnamespace (endpoint do servidor da API) -
O
kube-dnsserviço nokube-systemnamespace (CoreDNS)
Os seguintes objetos do Kubernetes são sempre ignorados durante uma restauração. Esses objetos incluem infraestrutura de nós e componentes de rede. Eles fazem referência ao estado específico do cluster. Os controladores Kubernetes recriam automaticamente esses objetos quando os nós e serviços se tornam ativos no cluster de destino. Se você restaurar esses objetos a partir de um backup, eles poderão causar conflitos ou erros. Esses conflitos ocorrem porque os objetos restaurados fazem referência a recursos que não existem no cluster de destino.
-
Endpoints (
v1/endpoints) - Pontos de extremidade de rede que definem endereços IP para serviços. O controlador de endpoints os gerencia automaticamente com base nos seletores de serviço. -
EndpointSlices (
discovery.k8s.io/v1/endpointslices) - O EndpointSlice controlador gerencia automaticamente esses objetos. -
ipAddresses (
networking.k8s.io/v1/ipaddresses) - A rede Kubernetes gerencia essas alocações de IP internas do cluster. -
CSinodes (
storage.k8s.io/v1/csinodes) - O kubelet cria automaticamente esses objetos quando os drivers CSI se registram em um nó. -
VolumeAttachments (
storage.k8s.io/v1/volumeattachments) - O attach/detach controlador cria automaticamente esses objetos quando os pods exigem volumes.
Os objetos que já existem no cluster de destino também são ignorados. As restaurações do EKS não são destrutivas — objetos existentes nunca são sobrescritos ou excluídos.
Para receber notificações sobre objetos ignorados ou com falha durante a restauração, assine as notificações de eventos do SNS. Para obter mais informações, consulte Opções de notificação com AWS Backup.
Considerações sobre OIDC e IRSA para restauração entre clusters
Ao restaurar um backup do Amazon EKS em um cluster diferente do de origem, os objetos do Kubernetes que fazem referência às funções do IAM para contas de serviço (IRSA) retêm o endpoint do provedor OIDC do cluster de origem. Essas referências existem nas anotações da conta de serviço e nas políticas de confiança do IAM. AWS Backup não os atualiza automaticamente durante a restauração.
Se suas cargas de trabalho usarem IRSA, uma restauração entre clusters exigirá:
-
O cluster de destino deve ter um provedor OIDC configurado.
-
Todas as funções do IAM referenciadas pelas contas de serviço do Kubernetes devem ter suas políticas de confiança atualizadas para incluir o endpoint do provedor OIDC do cluster de destino.
-
As anotações da conta de serviço (
eks.amazonaws.com/role-arn) ainda farão referência às funções originais — verifique se elas correspondem às funções válidas na conta de destino.
Se essas dependências não forem satisfeitas, os pods deixarão de assumir as funções do IAM após a restauração, e os trabalhos de restauração poderão relatar falhas durante a validação.
Recomendação: para cargas de trabalho que exigem portabilidade de restauração entre clusters ou entre contas, recomendamos usar o EKS Pod Identity em vez do IRSA. O EKS Pod Identity não depende de provedores OIDC específicos do cluster e simplifica os cenários de restauração entre clusters.