- Visão geral
- Requisitos
- Pré-instalação
- Preparação da instalação
- Baixando os pacotes de instalação
- Configuração do registro compatível com OCI
- Concessão de permissões de instalação
- Instalação e configuração do service mesh
- Instalando e configurando a ferramenta GitOps
- Instalando o operador de segredos externos no Kubernetes
- Aplicação de configurações diversas
- Executando o uipathctl
- Instalação
- Pós-instalação
- Migração e atualização
- Monitoramento e alertas
- Administração de cluster
- Configuração específica do produto
- Configuração avançada do Orchestrator
- Configuração de parâmetros do Orchestrator
- Configuração do AppSettings
- Configuração do tamanho máximo da solicitação
- Substituição da configuração de armazenamento no nível do cluster
- Configuração do NLog
- Salvando logs do robô no Elasticsearch
- Configuração dos repositórios de credenciais
- Configuração da chave de criptografia por tenant
- Limpeza do banco de dados do Orchestrator
- Ignorar a instalação da biblioteca do host
- AI Trust Layer
- Solução de problemas
- Falha no provisionamento do AI Center após a atualização para a 2023.10 ou posterior
- Volumes do Insights criados em duas zonas diferentes após a migração
- Falha de atualização devido aos tamanhos de PVC do Insights substituídos
- Os componentes de backup do Velero permanecem após a atualização no AKS do Automation Suite 2024.10.x
- A configuração de backup não funciona devido a uma falha na conexão com o Azure Government
- Pods no namespace uipath travaram ao habilitar taints de nó personalizado
- Não é possível iniciar o Automation Hub e o Apps com configuração de proxy
- O backup do Velero falha com o erro FailedValidation
- Solução de problemas de segredos externos
- Solução de problemas de Temporal como um serviço
- Os pods do AI Center e do Document Understanding falham ao iniciar com a verificação do certificado TLS habilitada
- Erros de validação de certificado TLS
- O Fluentd não exporta logs em ambientes IPv6
- O Studio Desktop não pode carregar conectores e atividades do Integration Service
- Migreção manual do ArgoCD NetworkPolicy (GHSA-47m3-95c7-g2g8)
- Configuração de solicitações e limites de recursos para cargas de trabalho criadas pelo uipathctl
Backup e restauração do EKS
Configure backups do Velero e procedimentos de restauração para o Automation Suite no EKS.
O Amazon EKS é compatível com backup e restauração por meio do AWS Backup, que protege os recursos de cluster e volumes persistentes do Kubernetes e permite restaurações baseadas em políticas para clusters do EKS existentes ou novos. Para obter detalhes, consulte Backups do Amazon EKS.
Além do AWS Backup, ferramentas nativas do Kubernetes, como o Velero, podem ser usadas para fazer backup e restaurar recursos de cluster do EKS, especialmente para cenários que exigem controle mais granular no nível do Kubernetes ou políticas de backup personalizadas para seu caso de uso e requisitos de conformidade.
Para obter detalhes, consulte os seguintes recursos da AWS:
- Perguntas frequentes de backup e restauração do Amazon EKS
- Backup e restauração de recursos de cluster do Amazon EKS usando o Velero
O Automation Suite no EKS usa dois tipos de armazenamento principais:
- Amazon EBS (Elastic Block Store) - fornece armazenamento em nível de bloco para cargas de trabalho do Kubernetes.
- Amazon EFS (Elastic File System) - fornece armazenamento de arquivos compartilhados para cargas de trabalho que exigem acesso simultâneo.
Para oferecer suporte aos tipos de armazenamento e à recuperação de desastres entre regiões, a UiPath recomenda usar o Velero File System Backup (FSB) com Amazon S3 e Replicação entre regiões (CRR).
Com essa configuração, os backups são armazenados no bucket S3 designado e a CRR os replica automaticamente para uma região AWS secundária para resiliência.
Pré-requisitos
Antes de configurar o Velero, certifique-se de que os seguintes pré-requisitos sejam atendidos:
- Instalação do Velero: você deve implantar o Velero no cluster do EKS usando o Helm ou o Velero CLI.
- Permissões do IAM: você deve conceder à conta de serviço do Velero as permissões necessárias para gravar no Amazon S3.
- Bucket do S3: você deve criar um bucket do Amazon S3 com o versionamento habilitado.
Para obter instruções detalhadas de configuração, consulte o guia oficial de configuração do Velero File System Backup .
Configuração das políticas do Velero
O Velero é compatível com políticas flexíveis que determinam quais recursos e volumes estão incluídos nos backups. Para obter mais informações sobre a configuração das políticas de backup do Velero, consulte a documentação oficial do Velero .
Ao definir uma política de backup, considere as seguintes diretrizes:
- Exclusão do PVC: você deve excluir qualquer
PersistentVolumeClaim(PVC) rotulado comvelero.io/exclude-from-backup: "true". O Velero ignora qualquer PVC com esse rótulo durante o processo de backup. - Configuração do backup do sistema de arquivos: você deve aplicar backups do sistema de arquivos a PVCs que usam classes de armazenamento compatíveis. As seguintes classes de armazenamento são compatíveis com backups de sistemas de arquivos:
- Classe de armazenamento EFS (
efs-sc) - Classe de armazenamento do EBS (
ebs-sc)Use a seguinte política amostral para configurar exclusões e backups do sistema de arquivos para essas classes de armazenamento:
policy: | version: v1 volumePolicies: - conditions: pvcLabels: velero.io/exclude-from-backup: "true" action: type: skip - conditions: csi: driver: efs.csi.aws.com storageClass: - efs-sc action: type: fs-backup - conditions: csi: driver: ebs.csi.aws.com storageClass: - ebs-sc action: type: fs-backuppolicy: | version: v1 volumePolicies: - conditions: pvcLabels: velero.io/exclude-from-backup: "true" action: type: skip - conditions: csi: driver: efs.csi.aws.com storageClass: - efs-sc action: type: fs-backup - conditions: csi: driver: ebs.csi.aws.com storageClass: - ebs-sc action: type: fs-backup - Classe de armazenamento EFS (
- Destino de backup: com o backup do sistema de arquivos, todos os dados de backup são carregados para o bucket do Amazon S3 configurado. Se a Replicação entre regiões (CRR) estiver habilitada, os backups são replicados automaticamente em todas as regiões para uma resiliência melhorada.
Execução de backups e restaurações
Para criar um backup no Velero:
- Siga o guia de backup do Velero .
- Configurar um Recurso personalizado de backup (CR) para definir os namespaces e os recursos incluídos no backup.
Os namespaces do Automation Suite são rotulados automaticamente com created-by=uipath. Você pode fazer backup seletivamente apenas de namespaces relacionados à UiPath, incluindo apenas aqueles rotulados com essa chave. Isso garante que seja feito backup de todos os recursos específicos da UiPath com segurança.
Para obter detalhes, consulte Filtragem de recursos do Velero.
Para restaurar cargas de trabalho a partir de um backup:
- Siga o guia de restauração do Velero .
- Faça referência a um recurso personalizado de restauração (CR) que especifica os recursos de backup e de destino.
Ao restaurar em um cluster que tenha o Dimensionador automático de cluster habilitado, o Velero pode relatar falhas parciais de restauração. Você pode ver um erro como node-agent pod is not running in node: daemonset pod not found in running state in node.
Se você encontrar esse problema, deve verificar o status dos objetos podvolumerestore (PVR) . Se todos os PVRs mostrarem Success, você pode considerar que a restauração foi bem-sucedida.
Para obter detalhes, consulte o problema #7170 e o problema #9203 do Velero.