automation-suite
2023.10
false
Guia de instalação do Automation Suite no Linux
- Visão geral
- Requisitos
- Modelos de implantação
- Manual: preparando a instalação
- Manual: preparando a instalação
- Etapa 2: configuração do registro compatível com OCI para instalações offline
- Etapa 3: configuração do objectstore externo
- Etapa 4: configuração do High Availability Add-on
- Etapa 5: configuração de bancos de dados SQL
- Etapa 6: configuração do balanceador de carga
- Etapa 7: configuração do DNS
- Etapa 8: configuração dos discos
- Etapa 9: configuração dos ajustes do nível do kernel e do sistema operacional
- Etapa 10: configuração das portas do nó
- Etapa 11: aplicação de configurações diversas
- Etapa 12: validação e instalação dos pacotes RPM necessários
- Etapa 13: geração de cluster_config.json
- Configuração de Certificados
- Configuração do Banco de Dados
- Configuração externa do Objectstore
- Configuração de URL pré-assinada
- Configuração da autenticação do Kerberos
- Configuração de registro externo compatível com OCI
- Disaster Recovery: configurações Ativo/Passivo e Ativo/Ativo
- Configuração do High Availability Add-on
- Configuração específica do Orchestrator
- Configuração específica do Insights
- Process Mining-specific configuration
- Configuração específica do Document Understanding
- Automation Suite Robots-specific configuration
- Configuração do monitoramento
- Opcional: configuração do servidor proxy
- Opcional: habilitação da resiliência a falhas zonais em um cluster de produção pronto para alta disponibilidade de vários nós
- Opcional: transmitindo resolv.conf personalizado
- Optional: Increasing fault tolerance
- Parâmetros do install-uipath.sh
- Adicionando um nó de agente dedicado com suporte a GPU
- Adição de um nó de agente dedicado ao Task Mining
- Conexão do aplicativo Task Mining
- Adicionando um nó de agente dedicado para robôs do Automation Suite
- Etapa 15: configuração do registro temporário do Docker para instalações offline
- Etapa 16: validação dos pré-requisitos para a instalação
- Manual: realizando a instalação
- Pós-instalação
- Administração de cluster
- Gerenciando produtos
- Introdução ao portal de administração do cluster
- Migração do High Availability Add-on no cluster para externo
- Migração de um registro no cluster para um registro externo compatível com OCI
- Mudança para o cluster secundário manualmente em uma configuração Ativo/Passivo
- Disaster Recovery: executando operações pós-instalação
- Convertendo uma instalação existente para configuração multi-local
- Diretrizes sobre atualização de uma implantação Ativo/Passivo ou Ativo/Ativo
- Diretrizes sobre backup e restauração de uma implantação Ativo/Passivo ou Ativo/Ativo
- Redirecionamento do tráfego dos serviços não compatíveis para o cluster principal
- Escalando uma implantação de nó único (avaliação) para uma implantação de vários nós (HA)
- Monitoramento e alertas
- Migração e atualização
- Etapa 1: mover os dados da organização do Identity, de independente para o Automation Suite
- Etapa 2: restauração do banco de dados de produtos independente
- Etapa 3: backup do banco de dados da plataforma no Automation Suite
- Etapa 4: mesclando organizações no Automation Suite
- Etapa 5: atualização das strings de conexão do produto migradas
- Etapa 6: migração do Orchestrator independente
- Etapa 7: migração do Insights independente
- Etapa 8: migração do Test Manager independente
- Etapa 9: exclusão do tenant padrão
- Executando uma migração de único tenant
- Migração do Automation Suite no Linux para o Automation Suite no EKS/AKS
- Atualizando o Automação Suite
- Download dos pacotes de instalação e obtenção de todos os arquivos no primeiro nó do servidor
- Recuperação da mais recente configuração aplicada do cluster
- Atualização da configuração de cluster
- Configuração do registro compatível com OCI para instalações offline
- Execução da atualização
- Realização de operações pós-atualização
- Configuração específica do produto
- Uso da ferramenta de configuração do Orchestrator
- Configuração de parâmetros do Orchestrator
- Configurações de aplicativo 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 dos repositórios de credenciais
- Configuração da chave de criptografia por tenant
- Limpeza do banco de dados do Orchestrator
- Melhores práticas e manutenção
- Solução de problemas
- Como solucionar problemas dos serviços durante a instalação
- Como desinstalar o cluster
- Como limpar os artefatos offline para melhorar o espaço em disco
- Como limpar os dados do Redis
- Como habilitar o registro em log do Istio
- Alterando o modo somente leitura do Ceph
- Como limpar logs antigos armazenados no bucket do sf-logs
- Como desabilitar os logs de streaming para o AI Center
- Como depurar instalações do Automation Suite com falha
- Como excluir imagens do instalador antigo após a atualização
- Como desabilitar o descarregamento de soma de verificação do TX
- Como atualizar do Automation Suite 2022.10.10 e 2022.4.11 para 2023.10.2
- Como definir manualmente o nível de log do ArgoCD como Info
- Como expandir o armazenamento do AI Center
- Como gerar o pull_secret_value codificado para registros externos
- Como lidar com cifras fracas no TLS 1.2
- Como trabalhar com certificados
- Como encaminhar logs do aplicativo para o Splunk
- Como limpar imagens do Docker não usadas dos pods de registro
- Como coletar dados de uso de DU com objectstore (Ceph) no cluster
- Como instalar o RKE2 SELinux em ambientes air-gapped
- Como limpar backups diferenciados antigos em um servidor NFS
- Não é possível executar uma instalação offline no SO RHEL 8.4
- Erro ao baixar o pacote
- A instalação offline falha devido a um binário ausente
- Verificação de pré-requisito para o módulo iscsid do selinux falha
- Azure disk not marked as SSD
- Falha após a atualização do certificado
- Antivírus causa problemas de instalação
- Automation Suite not working after OS upgrade
- O Automation Suite requer que backlog_wait_time seja definido como 0
- Não é possível montar o volume devido a não estar pronto para cargas de trabalho
- Falha na coleta de logs do pacote de suporte
- A cadeia de caracteres de conexão SQL da Automação de Teste é ignorada
- Configurações de DNS não honradas pelo CoreDNS
- Perda de dados ao reinstalar ou atualizar o Insights após a atualização do Automation Suite
- A atualização de nó único falha no estágio de malha
- Upgrade fails due to unhealthy Ceph
- O volume não pode ser montado e permanece no estado de loop anexar/desanexar
- A atualização falha devido a objetos clássicos no banco de dados do Orchestrator
- Um cluster do Ceph foi encontrado em um estado degradado após atualização lado a lado
- Um componente sem integridade do Insights causa uma falha na migração
- A atualização do serviço falha para o Apps
- Tempos limite de atualização no local
- Migração de registro do Docker presa no estágio de exclusão do PVC
- Falha no provisionamento do AI Center após a atualização para a 2023.10 ou posterior
- Falha de atualização em ambientes offline
- A validação de SQL falha durante a atualização
- pod snapshot-controller-crds no estado CrashLoopBackOff após a atualização
- Erro de upgrade/reinstalação do endpoint da API REST do Longhorn
- Falha de atualização devido aos tamanhos de PVC do Insights substituídos
- Falha de atualização de serviço durante a execução de script pré-serviço
- Configurando um intervalo de tempo limite para os portais de gerenciamento
- Autenticação não funciona após migração
- kinit: não é possível encontrar o KDC para o realm <AD Domain> ao obter credenciais iniciais
- kinit: o Keytab não contém chaves adequadas para *** ao obter credenciais iniciais
- Falha na operação GSSAPI devido a código de status inválido
- Alarme recebido para trabalho com falha do Kerberos-tgt-update
- Provedor de SSPI: servidor não encontrado no banco de dados Kerberos
- Falha de login para usuário do AD devido a conta desabilitada
- ArgoCD login failed
- Falha ao obter a imagem do sandbox
- Os pods não são exibidos na UI do ArgoCD
- Falha de teste do Redis
- O servidor RKE2 falha ao iniciar
- O ArgoCD entra em estado Em andamento após a primeira instalação
- Migreção manual do ArgoCD NetworkPolicy (GHSA-47m3-95c7-g2g8)
- Unhealthy services after cluster restore or rollback
- Métricas Ceph-rook ausentes nos painéis de monitoramento
- Os pods não podem se comunicar com o FQDN em um ambiente de proxy
- Falha ao configurar alertas por e-mail após a atualização
- Nenhum problema upstream íntegro
- Falha ao adicionar nós de agente em ambientes offline
- O acesso ao FQDN retorna RBAC: erro de acesso negado
- O Document Understanding não está no menu de navegação esquerdo do Automation Suite
- Status de Falha ao criar uma sessão de rotulagem de dados
- Status de Falha ao tentar implantar uma habilidade de ML
- Trabalho de migração falha no ArgoCD
- Reconhecimento de escrita com o Extrator de formulários inteligente não está funcionando
- Falha na implantação de habilidade de ML devido à expiração do token
- Execução de alta disponibilidade com o Process Mining
- Falha na ingestão do Process Mining ao fazer logon usando o Kerberos
- Após a recuperação de desastres, o Dapr não está funcionando corretamente para Process Mining
- Configurando o Dapr com o Redis no modo de cluster
- Não é possível conectar-se ao banco de dados AutomationSuite_ProcessMining_Warehouse usando uma string de conexão em formato pyodbc.
- A instalação do Airflow falha com sqlalchemy.exc.ArgumentError: não foi possível analisar o URL rfc1738 da string ''
- Como adicionar uma regra de tabela de IP para usar a porta 1433 do SQL Server
- O certificado do Automation Suite não é confiável para o servidor em que o CData Sync está sendo executado
- Execução da ferramenta de diagnóstico
- Usando o pacote de suporte do Automation Suite
- Exploração de logs
Importante :
A localização de um conteúdo recém-publicado pode levar de 1 a 2 semanas para ficar disponível.
Arquitetura de implantação do AWS Marketplace
Arquitetura de implantação do AWS Marketplace para Automation Suite, incluindo componentes de pilha e funções Lambda.
Diagrama de arquitetura
Complete component list
Pontos de Entrada
A implantação do UiPath AWS Marketplace tem um único Entry Point.
Nested stacks
- Uipath-sf:
- pilha SSL
- pilha de roteamento
- pilha de servidores
- pilha de banco de dados
- pilha de backup
- pilha de gerenciamento
- Funções lambda (
AWS::Lambda::Function):FindAMIFunction— para encontrar um ID de AMI correspondente.CreateInputJsonFunction- para criar a configuração usada pelo instalador do Automation Suite.ComputeResourceSizeFunction- para calcular a configuração de hardware mínima de instâncias EC2 necessária, com base nos serviços selecionados e tipo de implantação.
- Funções do IAM (
AWS::IAM::Role) para as funções do Lambda para fornecer permissões mínimas:FindAmiLambdaRoleCreateInputJsonLambdaRoleComputeResourceSizeLambdaRole
- Segredos (
AWS::SecretsManager::Secret) para armazenar informações confidenciais:RDSPasswordOrgSecretPlatformSecretArgoCdSecretArgoCdUserSecretInputJsonSecretKubeconfigSecret
- Pilha SSL (opcional)
- Pilha de rede (opcional)
- Backup stack (optional):
ClusterBackupStorage(AWS::EFS::FileSystem) - Sistema de Arquivos Amazon Elastic usado para armazenar o backup.SharedStorageSecurityGroup(AWS::EC2::SecurityGroup) - Grupo de segurança usado para permitir conexões de rede NFS dos nós do cluster.SharedStorageMountTargetOne(AWS::EFS::MountTarget) - Recurso que cria o destino de montagem para o sistema de arquivos EFS e a primeira sub-rede privada.SharedStorageMountTargetTwo(AWS::EFS::MountTarget) - Recurso que cria o destino de montagem para o sistema do arquivo EFS e a segunda sub-rede privada.SharedStorageMountTargetThree(AWS::EFS::MountTarget) - Recurso opcional que cria o destino de montagem para o sistema de arquivos EFS e a segunda sub-rede privada.
- Database stack:
RDSDBInstance(AWS::RDS::DBInstance) - A instância de banco de dados do Amazon RDS. O DB SKU édb.m5.2xlarge.DBSubnetGroup(AWS::RDS::DBSubnetGroup) - Grupo de sub-rede privada que contém as sub-redes privadas.DbSecurityGroup(AWS::EC2::SecurityGroup) - Grupo de segurança que permite acesso à instância do Banco de Dados.PMRDSDBInstance(AWS::RDS::DBInstance) - Instância de banco de dados do Amazon RDS dedicada para o Process Mining. Implantado apenas quando o Process Mining está habilitado e a implantação estáMulti Node. O DB SKU édb.m5.4xlarge.
- Pilha de roteamento:OBSERVAÇÃO: as pilhas ALB e NLB são configurações mutuamente exclusivas
- Pilha Alb:
ExternalLoadBalancer(AWS::ElasticLoadBalancingV2::LoadBalancer) - Balanceador de carga do aplicativo usado para distribuir o tráfego do Automation Suite. Ele pode ser interno ou com acesso pela internet.ELBSecurityGroup(AWS::EC2::SecurityGroup) - O grupo de segurança aplicado ao balanceador de carga.HttpsTargetGroup(AWS::ElasticLoadBalancingV2::TargetGroup) - O grupo de destino do balanceador de carga.HttpsListener(AWS::ElasticLoadBalancingV2::Listener) - O ouvinte do balanceador de carga.
- Pilha do NLB:
ExternalLoadBalancer(AWS::ElasticLoadBalancingV2::LoadBalancer) - Balanceador de carga de rede usado para distribuir o tráfego do Automation Suite. Ele pode ser interno ou com acesso pela internet.TcpTargetGroup(AWS::ElasticLoadBalancingV2::TargetGroup) - O grupo de destino do balanceador de carga.TcpListener(AWS::ElasticLoadBalancingV2::Listener) - O ouvinte do balanceador de carga.
KubeLoadBalancer(AWS::ElasticLoadBalancingV2::LoadBalancer) - Balanceador de carga de rede privada usado para o registro de nó.KubeApiTcpTargetGroup(AWS::ElasticLoadBalancingV2::TargetGroup) - O grupo de destino para o tráfego de registro de nó doKubeLoadBalancer.KubeApiTcpListener(AWS::ElasticLoadBalancingV2::Listener) - O ouvinte do tráfego de registro de nós doKubeLoadBalancer.Rke2RegistrationTcpTargetGroup(AWS::ElasticLoadBalancingV2::TargetGroup) - O grupo de destino para o tráfego de registro de nó doKubeLoadBalancer.Rke2RegistrationTcpListener(AWS::ElasticLoadBalancingV2::Listener) - O ouvinte do tráfego de registro de nós doKubeLoadBalancer.RootRecordSet(AWS::Route53::RecordSet) - Registro de DNS para o FQDN.SubdomainRecordSet(AWS::Route53::RecordSet) - Registro Um DNS para os subdomínios do FQDN.
- Pilha Alb:
- Management stack:
LifecycleAutomationLogs(AWS::Logs::LogGroup) - Grupo de logs para registrar eventos da automação do SSM.ClusterOperationsAutomationLogs- Grupo de logs para registrar eventos relacionados a operações de cluster.OnDemandRestoreStateMachine(AWS::StepFunctions::StateMachine) - Função de etapa usada para orquestrar o fluxo de restauração.- Documentos SSM (
AWS::SSM::Document) conjuntos de etapas usadas para fornecer remoção de nó normal:ServerRemoveInstanceDocumentAgentRemoveInstanceDocumentUpdateAMIDocument- Atualiza o ID do AMI para os grupos de dimensionamento automático.RegisterAiCenter- Registra o AI Center em um Orchestrator externo fornecido no momento da implantação.OnDemandBackup- Cria um instantâneo manual do cluster do Automation Suite.GetBackupList- Recupera todos os instantâneos disponíveis para o cluster do Automation Suite.OnDemandRestoreDocument- Restaura o cluster do Automation Suite a partir de um determinado instantâneo.
- Hooks Lyfecycle de escalonamento automático (
AWS::AutoScaling::LifecycleHook) que nos permitem executar os documentos SSM quando uma instância EC2 recebe um evento de encerramento de instância:ServerAsgLifeCycleHookTerminatingAgentAsgLifeCycleHookTerminatingAsRobotsAsgLifeCycleHookTerminating
- Regras de evento (
AWS::Events::Rule) que acionam a execução dos Documentos SSM:ServerTerminateEventRuleAgentTerminateEventRuleAsRobotsTerminateEventRule
- Funções IAM (
AWS::IAM::Role) necessárias para executar documentos SSM e adicionar logs ao grupo de logs:AutomationAssumeRoleEventsBridgeAssumeRoleStateMachinesAssumeRole
Observação:AutomationAssumeRoleeStateMachinesAssumeRolepermitem acesso completo ao Amazon SSN. Para obter mais informações, consulte AmazonSSMFullAccess. - Server stack:
ServerLaunchConfiguration(AWS::EC2::LaunchTemplate) - Configuração de instância do EC2 para os nós de servidor. Configuração do disco:- Disco do sistema operacional - sku gp3, capacidade 256GB
- Disco do cluster - sku gp3, capacidade 300 GB
- disco etcd - sku io1, capacidade 32GB
- Disco de dados - sku gp3, capacidade 512GB independentemente dos serviços selecionados.
- Disco Objectstore - sku gp3, capacidade 512GB
- Disco opcional para cache de pacotes do Automation Suite Robots - sku gp3, capacidade 32 GB. O disco é implantado apenas se o serviço Automation Suite Robots estiver habilitado em uma implantação de nó único
AgentLaunchConfiguration(AWS::EC2::LaunchTemplate) - Configuração de instância do EC2 para os nós de agentes. Configuração do disco:- Disco do sistema operacional - sku gp3, capacidade 128GB
- Disco do cluster - sku gp3, capacidade 256GB
ASRobotsLaunchTemplate(AWS::EC2::LaunchTemplate) - Configuração de instância do EC2 para os nós do ASRobots. Configuração do disco:- Disco do sistema operacional - sku gp3, capacidade 128GB
- Disco do cluster - sku gp3, capacidade 256GB
- Disco de cache do pacote do robô - sku gp3, capacidade 32 GB
GpuEnabledNode(AWS::EC2::Instance) - Nó opcional da GPU. Ele tem a mesma configuração de disco de um agente.TaskMiningNode(AWS::EC2::Instance) - Nó opcional de Task Mining. Implantado somente se o serviço Task Mining for selecionado. Ele tem a mesma configuração de disco de um agente.BastionHost(AWS::EC2::Instance) - Instância EC2 opcional usada para fazer SSH para nós de cluster. Ele tem o tipo de instânciat3.largee um disco gp3 de 200 GB.ServerAutoScalingGroup(AWS::AutoScaling::AutoScalingGroup) - Grupo de escalonamento automático para os servidores.AgentAutoScalingGroup(AWS::AutoScaling::AutoScalingGroup) - Grupo de escalonamento automático para os agentes.ASRobotsAutoScalingGroup- Grupo de escalonamento automático para nós dedicados do Automation Suite Robots. A capacidade deste grupo de dimensionamento é 1 se a implantação estiverMulti Nodee o serviço Automation Suite Robots estiver habilitado, e 0 caso contrário.- Opcional
ServiceFabricIamRole(AWS::IAM::Role) que tem permissões para:- gravar logs
- leia as configurações das instâncias do EC2
- baixar recursos do AWS Quickstart
- acessar o segredo de configuração de instalação do Automation Suite
- acesse o segredo de configuração do cluster kubeconfig
ServiceFabricSecurityGroup(AWS::EC2::SecurityGroup) - Grupo de segurança que permite acesso aos aplicativos da UiPath®.BastionSecurityGroup(AWS::EC2::SecurityGroup) - Grupo de segurança opcional que permite acesso SSH ao BastionAsgProcessModifierFunction(AWS::Lambda::Function) - Usado para modificar os processos ASG durante a criação da pilha de CF.AsgProcessModificationRole(AWS::IAM::Role) - função de IAM para fornecer permissões mínimas para oAsgProcessModifierFunction- Parâmetros SSM (
AWS::SSM::Parameter):InstanceAMIIdSSMParameter- Armazena o ID do AMI dos nós.InstanceAMIImageNameSSMParameter- Contém o Nome da Imagem usado no momento da implantação ou atualizado por meio doUpdateAMIDocument.
- Hooks Lyfecycle de escalonamento automático (
AWS::AutoScaling::LifecycleHook) que nos permitem fazer a transição de instâncias do EC2 para o estado InService após o instalador ser bem-sucedido:ServerAsgLifeCycleHookLaunchingAgentAsgLifeCycleHookLaunchingASRobotsAsgLifeCycleHookLaunching
Deployment and instance type mapping
O modelo calcula dinamicamente o hardware necessário para a implantação da seguinte maneira:
- Dependendo dos serviços instalados, ele define os requisitos mínimos no nível do cluster.
- Dependendo do perfil de implantação (perfil de vários nós ou de um único nó), ele define os requisitos mínimos para uma única VM.
- Seleciona os tipos de instância com base em sua disponibilidade na região que você implanta e nos requisitos mencionados acima.
A tabela a seguir mostra os mapeamentos entre a implantação e os possíveis tipos de instância:
| Tipo de implantação | Tipos de instâncias |
|---|---|
| Seleção de serviços de nó único que precisa de menos de 16 CPUs | c5.4xlarge, c5a.4xlarge, m5.4xlarge, m5a.4xlarge |
| Seleção de serviços de nó único que precisa de mais de 16 CPUs | c5a.8xlarge, c5.9xlarge, m5.8xlarge |
| Multi-nó, seleção de serviços que precisa de menos de 48 CPUs | c5.4xlarge, c5a.4xlarge, m5.4xlarge, m4.4xlarge |
| Multi-nó, seleção de serviços que precisa de mais de 48 CPUs | c5a.8xlarge, c5.9xlarge, m5.8xlarge, m5a.8xlarge |