Etapa 3: etapas de pós-implantação

Conclua as etapas de verificação e configuração pós-implantação após instalar o Automation Suite na infraestrutura do Azure.

Observação:

When using Azure Bastion, keep in mind that copy-pasting commands split over multiple lines using \ may not work as expected. To ensure new lines are interpreted correctly, use the console's clipboard widget.

Validando a instalação

To check if Automation Suite was installed successfully, you must go to the storage account, inside the flags container. The installation is complete if the contents of the auto-generated file called installResult (in the container) is successful. The contents will be failed if the installation failed.

Atualização de certificados

O processo de instalação gera certificados autoassinados em seu nome. Esses certificados são compatíveis com FIPS 140-2. O modelo de implantação do Azure também oferece a opção de fornecer um certificado de servidor emitido pela CA no momento da instalação, em vez de usar um certificado autoassinado gerado automaticamente.

Certificados autoassinados expirarão em 90 dias e você deverá substituí-los por certificados assinados por uma CA confiável assim que a instalação for concluída. Se você não atualizar os certificados, a instalação deixará de funcionar após 90 dias.

Se você instalou o Automation Suite em um host habilitado para FIPS 140-2 e deseja atualizar os certificados, verifique se são compatíveis com FIPS 140-2.

Para obter instruções, consulte Gerenciamento de certificados.

Habilitando o FIPS 140-2

Após concluir uma instalação do Automation Suite usando o modelo de implantação do Azure, você pode habilitar o FIPS 140-2 em suas máquinas. Para obter instruções, consulte Segurança e conformidade.

Exploring flags and logs

Se você precisar de mais informações sobre o processo de instalação do Automation Suite ou outras operações, um bom lugar para começar é a conta de armazenamento usada para armazenar vários sinalizadores e logs durante a implantação e manutenção do cluster.

Para localizar a conta de armazenamento, execute as seguintes etapas:

1. Navegue até o grupo de recursos em que a implantação foi executada.

2. Filter by resource type Storage Account.

3. Localize a conta de armazenamento cujo nome termina com st. Por exemplo:

   

4. Selecione a conta de armazenamento e, em seguida, selecione Contêineres. Suas opções são sinalizadores e logs.

   

Sinalizadores de contêiner

The flags container stores various flags or files needed for orchestration or just to report the status of various operations. On a new cluster, the flags container contents typically look as shown in the following example:

Files in the flags containers are used to orchestrate various operations, such as the Automation Suite installation process on the cluster, or specific cluster operations, such as Instance Refresh. For example:

• uipath-server-000000.success indica que a instalação da infraestrutura foi concluída com êxito nesse nó específico do cluster;
• installResult lê success se a instalação geral for bem-sucedida.

Contêiner de logs

When performing an operation, it typically produces a log file in the logs container. On a fresh cluster, the logs container contents typically look as shown in the following example:

Every file in the logs container represents the logs for a specific step of the installation process. For example:

• infra-uipath-server-000000.log armazena os logs de instalação da infraestrutura;
• fabric.log armazena os logs para a instalação da malha;
• services.log armazena os logs para a instalação de aplicativos e serviços.

Acessando saídas de implantação

Quando a instalação estiver concluída, você precisa acessar os Resultados de implantação na aba Resultados.

Para fazer isso, vá para o seu Grupo de Recursos e, em seguida, para Implantações → mainTemplate (ou algo como Microsoft.Template-DateTime) → Saídas.

Saídas da implantação

Saída	Description
Documentação	Um link para a documentação.
URL	A URL do balanceador de carga. Pode ser usado para acesso direto. Se os domínios personalizados forem habilitados, este é o domínio que você usaria para a associação CNAME.
KeyVaultURL	A URL do Portal do Azure para o Key Vault criado pela implantação. Ela contém todos os segredos (credenciais) usados ​​na implantação.
ArgoCDURL	A URL para acessar o ArgoCD. Isso está disponível na VNet. O acesso externo a essa URL deve ser configurado conforme descrito na: Etapa 4: Configuração do DNS.
ArgoCDPassword	A senha usada para fazer login no portal ArgoCD.
HostAdminUsername e HostAdminPassword	As credenciais usadas para Administração de Host.
ClusterAdministrationURL	A URL para o portal de administração de cluster.
DashboardMonitoringURL	O URL para ferramentas de monitoramento de painel (Grafana): https://monitoring.<fqdn>/dashboard. Certifique-se de substituir <fqdn> por seu FQDN.
MetricsMonitoringURL	O URL para ferramentas de monitoramento de métricas (Prometheus): https://monitoring.<fqdn>/metrics. Certifique-se de substituir <fqdn> por seu FQDN.
AlertmanagerMonitoringURL	O URL para ferramentas de monitoramento do Alertmanager: https://monitoring.<fqdn>/alertmanager. Certifique-se de substituir <fqdn> por seu FQDN.

Todas as credenciais usadas na implantação são armazenadas como segredos dentro de um Key Vault provisionado durante a implantação. Para acessar os segredos, filtre os recursos dentro do Grupo de Recursos, pesquise Vault e, em seguida, selecione Segredos.

Observação:

Se você vir o The operation "List" is not enabled in the key vault's access policyaviso na guia Segredos guia, siga os seguintes passos:

1. Vá para Políticas de acesso → Adicionar política de acesso → Configurar o modelo → Gerenciamento de segredo → Selecionar principal .
2. Selecione seu usuário e, em seguida, selecione Salvar.
3. Navegue de volta para Segredos . O aviso deve desaparecer e os segredos devem estar visíveis.

Como acessar VMs de cluster

As VMs são provisionadas dentro de uma VNet privada. Você pode acessá-los por meio do Azure Bastion seguindo estas etapas:

1. Navegue até o grupo de recursos em que você implantou o Automation Suite.

2. Como os agentes, agentes de GPU e VMs de servidor estão dentro dos conjuntos de dimensionamento, você precisa acessar o conjunto de dimensionamento que contém a instância desejada.

   

3. Vá para a seção Instâncias na guia Configurações.

   

4. Selecione o nome da VM que você deseja conectar.

   

5. Selecione o botão Conectar e, em seguida, escolha Bastion no menu suspenso.

   

6. Insira as credenciais fornecidas na implantação (parâmetros Nome de usuário do administrador e Senha do administrador , que você pode encontrar no cofre de chaves das credenciais, em Segredos) e selecione Conectar.

   

Requisitos de DNS

Como mencionado na Etapa 1: Preparação de sua implantação do Azure, a implantação do Automation Suite Azure cria um balanceador de carga com um IP público e um rótulo DNS associado. Esta etiqueta DNS é de propriedade da Microsoft.

A implantação também provisiona uma zona de DNS privado dentro da VNet do cluster e adiciona vários registros que são usados ​​durante o processo de instalação e configuração.

Se você optar por se conectar de uma máquina externa, não poderá usar a zona DNS privada para resolver o DNS de vários serviços, portanto, será necessário adicionar esses registros ao arquivo host.

Consulte Etapa 4: Configurando o DNS para mais detalhes.

Agora você deve conseguir se conectar a vários serviços em execução em seu cluster.

Acessando o portal de administração de cluster

O portal de administração de cluster é um local centralizado onde você pode encontrar todos os recursos necessários para concluir uma instalação do Automation Suite e executar operações pós-instalação comuns. Para obter detalhes, consulte Introdução ao portal de administração do cluster.

Para acessar o portal de Administração do Cluster, execute a seguinte etapa:

Acesse o seguinte URL: https://${CONFIG_CLUSTER_FQDN}/uipath-management.

Observação:

You do not need any credentials to access the Cluster Administration portal.

Acessando a interface geral do Automation Suite

A interface do usuário do Automation Suite de uso geral é usada como portal tanto para os administradores quanto para os usuários da organização. É um recurso comum ao nível de organização a partir do qual todos podem acessar todas as áreas do Automation Suite: páginas de administração, páginas ao nível de plataforma, páginas específicas de serviço e páginas específicas do usuário.

Para acessar o Automation Suite, execute as seguintes etapas:

1. Acesse a seguinte URL: https://${Loadbalancer_dns}, onde <loadbalancer_dns>é a etiqueta DNS para o balanceador de carga e é encontrado em resultados.
2. Altere para organização padrão.
3. O nome de usuário é orgadmin.
4. Recupere a senha acessando CofreDeChaves,Segredos e, então, Senha do admin do host.

Acessando a administração do host

O portal do host é onde os administradores do sistema configuram a instância do Automation Suite. As configurações definidas neste portal são herdadas por todas as suas organizações e algumas podem ser substituídas no nível da organização.

Para acessar a administração do host, execute as seguintes etapas:

1. Acesse a seguinte URL: https://${Loadbalancer_dns}, onde <loadbalancer_dns> é a etiqueta DNS para o balanceador de carga e é encontrado em Saídas.
2. Alterne para a organização do Host.
3. Enter the username you previously specified as a value for the UiPath Admin Username parameter.
4. Insira a senha que você especificou anteriormente como um valor para o parâmetro Senha de administrador da UiPath. Recupere a senha acessando CofreDeChaves,Segredos e, então, Senha do admin do host.

Acessando o ArgoCD

Você pode usar o console do ArgoCD para gerenciar produtos instalados.

Para acessar o ArgoCD, siga as seguintes etapas:

1. Acesse a seguinte URL: https://alm.${Loadbalancer_dns}, onde <loadbalancer_dns> é a etiqueta DNS para o balanceador de carga e é encontrado em Saídas. Observe que você deve configurar o acesso externo a essa URL, conforme descrito na Etapa 4: configuração do DNS.
2. O nome de usuário é admin.
3. Para acessar a senha, acesse o Resultados guia ou o Keyvault da credencial.

Acessando as ferramentas de monitoramento

Para acessar as ferramentas de monitoramento pela primeira vez, faça login como administrador com as seguintes credenciais padrão:

• Nome de usuário: admin
• Senha: para recuperar a senha, execute o seguinte comando:

  kubectl get secrets/dex-static-credential -n uipath-auth -o "jsonpath={.data['password']}" | base64 -d
  

Para atualizar a senha padrão usada para autenticação Dex ao acessar as ferramentas de monitoramento, execute as seguintes etapas.

1. Execute o seguinte comando substituindo newpassword por sua nova senha:

   password="newpassword"
   password=$(echo -n $password | base64)
   kubectl patch secret dex-static-credential -n uipath-auth --type='json' -p="[{'op': 'replace', 'path': '/data/password', 'value': '$password'}]"
   

2. Execute o seguinte comando para atualizar a senha:

   ./install-uipath.sh -i /opt/UiPathAutomationSuite/cluster_config.json -o ./output.json -f --accept-license-agreement
   

Escalonando seu cluster

Os recursos de computação provisionados da implantação consistem em conjuntos de escalonamento do Azure, que permitem fácil escalonamento.

Você pode adicionar mais recursos manualmente a um conjunto de dimensionamento específico, incluindo a adição de nós de servidor, nós de agente ou nós de agente especializados (como nós de GPU).

Você pode executar uma escala manual identificando o conjunto de escala específico e adicionar recursos diretamente.

Para fazer isso, siga os seguintes passos:

1. Vá para o Portal do Azure e filtre no conjunto de escalonamento específico:

   

2. Selecione o conjunto de escalonamento apropriado e selecione Escala.

   

3. Modifique o campo Contagem de instâncias usando o controle deslizante ou o campo de entrada ao lado dele e, em seguida, selecione Salvar.

   Observação:

   Para conjuntos de escalonamento de servidor, a contagem de instâncias precisa ser um número ímpar.

4. A operação de escalonamento deve começar em segundo plano e novos recursos ficam disponíveis após a conclusão.

Concluindo uma atualização

Após realizar uma atualização de cluster do Automation Suite, as implantações de modelos do Azure exigem algumas alterações para garantir que um novo nó entre no cluster corretamente. Para automatizar as alterações, recomendamos usar o script dedicado. Para obter instruções, consulte a documentação do Modelo de implantação do Azure.

Operações de ciclo de vida da VM do Azure

Dica:

O Azure permite uma janela de 15 minutos no máximo para se preparar para o desligamento, enquanto o encerramento normal de um nó do Automation Suite varia de 20 minutos (para nós de agente e agente de GPU) a horas (no caso de nós de servidor).
Para evitar a perda de dados, a política de atualização do VMSS do servidor é definida como manual, e as VMs do servidor têm a proteção para as ações de conjunto de escala habilitadas. Como resultado, recomendamos gerenciar o ciclo de vida dos servidores por meio dos Runbooks fornecidos.
The InstanceRefresh, RemoveNodes, RemoveServers, and CheckServerZoneResilience runbooks are supported only for multi-node HA-ready production deployments.
O número de servidores após a execução de qualquer runbook deve ser ímpar e maior que três (por exemplo, você não pode executar uma atualização de instância se tiver 4 servidores; não pode remover um servidor se tiver um total de cinco).
Todas as VMs em VMSSes devem estar no estado Running .
Somente um runbook deve ser executado por vez.

Importante:

Os runbooks InstanceRefresh, RemoveNodes e RemoveServers são afetados por um problema que faz com que as operações de remoção de nós falhem se você usar o Azure para o Governo dos EUA.

Trabalhadores híbridos

Todas as nossas contas de armazenamento e servidores SQL têm endpoints privados. Um grupo de trabalhadores híbridos executa as operações automatizadas existentes para que elas funcionem sem problemas.

Um trabalho híbrido é uma VM que fica dentro da VNET e na qual as várias automações serão executadas.

A VM é normalmente uma Standard_D2s_v3 ou uma Standard_F2s_v2, dependendo de qual você escolher para as VMs do seu servidor e se a cota permite. A VM é encerrada quando a implantação é concluída para minimizar os custos.

Os runbooks são divididos em duas categorias: runbooks regulares e runbooks híbridos. Você usa os runbooks regulares para iniciar uma operação e reunir todos os dados. O runbook regular então inicia a VM do Worker Híbrido e o runbook do runbook, com este último concluindo a operação.

Quando a operação for concluída, você poderá desativar a VM do híbrido de trabalho para limitar os custos.

A tabela a seguir descreve o detalhamento do runbook:

Runbooks regulares	Runbooks híbridos
AddGpuNode	HybridAddGpuNode
BackupCluster	HybridBackupCluster
GetAllBackups	HybridGetAllBackups
InstanceRefresh	HybridInstanceRefresh (+HybridCheckServerZoneRezilience)
RegisterAiCenterExternalOrchestrator	HybridRegisterAiCenterExternalOrchestrator
RemoveNodes	HybridRemoveNodes
RemoveServers	HybridRemoveServers
RestoreClusterInitialize	HybridRestoreClusterInitialize + HybridRestoreClusterSnapshot
ValidateFullInstall	Execução no final da implantação para validar a instalação completa.

InstanceRefresh

Description

The InstanceRefresh runbook has the following use cases:

• Atualize o VMSS OS SKU nos conjuntos de dimensionamento de servidor, agente e GPU.
• Execute uma operação de rotação de nó para um/mais VMSSes.
• Outras alterações de configuração do VMSS que foram aplicadas ao VMSS anteriormente.

Uso

1. Go to the Azure Portal and search for the resource called InstanceRefresh.
2. Selecione o botão para abrir a lista de parâmetros. Complete os parâmetros considerando:
   • Uma operação de rotação de nó é executada em um VMSS somente se o parâmetro REFRESH<node_type> estiver configurado como True. Se vários parâmetros REFRESH<node_type> forem definidos como True, a ordem de rotação do nó VMSS será Servidores -> Agentes -> Agentes de GPU.
   • Você deve fornecer o parâmetro NEWOSVERSION para atualizar o VMSS OS SKU. Você pode encontrar o SKU de imagem de VMs do Azure Marketplace disponível usando az vm image list-skus --location <deployment_location> --offer RHEL --publisher RedHat --output table. As VMs atuais não são atualizadas automaticamente para o modelo mais recente (uma operação de rotação de nós é necessária para isso).

Selecione o botão OK para iniciar o runbook.

Detalhes da implementação

O runbook InstanceRefresh é um wrapper para o runbook RemoveNodes . Como resultado, o status é rastreado durante a execução do RemoveNodes. Ele atualiza todas as versões do sistema operacional VMSS (se necessário) e extrai, com base nos parâmetros recebidos, o nome do host para a operação de rotação de nós e os encaminha para o RemoveNodes.

Se o cluster tiver exatamente três servidores, o runbook InstanceRefresh criará três novos servidores; caso contrário, o RemoveNodes lida com a escalabilidade para manter pelo menos um servidor em cada Zona de Disponibilidade de cada vez.

RemoveNodes

Description

O runbook RemoveNodes tem os seguintes casos de uso:

• Remova os nós especificados do cluster do Automation Suite.
• Execute uma operação de rotação de nós para uma ou duas VMs.

Uso

1. Pesquise os nomes de computador dos nós que você deseja remover. Para fazer isso, vá para um VMSS e selecione Instances na seção Settings .

   

2. Go to the Azure Portal and search for the resource called RemoveNodes.

3. Selecione o botão para abrir a lista de parâmetros. Complete os parâmetros considerando o seguinte:

• NODESTOBEREMOVEDCOMPUTERNAME é uma lista separada por vírgulas de nomes de computador das VMs que você deseja excluir (por exemplo, pxlqw-agent-000009,pxlqw-agent-00000A) e é o único parâmetro obrigatório. Recomendamos remover os nós de um único VMSS por vez.
• ISINSTANCEREFRESH and THREESERVERSSCENARIO are flags populated by the InstanceRefresh wrapper.

Selecione o botão OK para iniciar o runbook.

Detalhes da implementação

O runbook RemoveNodes tem uma abordagem recursiva para superar o tempo limite de 3 horas de quota justa . Isso remove ou repõe o primeiro ou os dois primeiros nós (o número é escolhido para atender à restrição de número ímpar de servidores) da lista recebida e executa novamente outra instância do runbook com a lista restante.

A operação de reparação de nó requer as seguintes etapas:

1. Expanda o VMSS com uma ou duas VMs com base no número de nós que serão removidos.
2. Execute a remoção do nó para as instâncias antigas.

A operação de remoção de nó para um nó requer a execução das seguintes etapas:

1. Isolar e drenar as instâncias. A operação expira após 20 minutos para um agente e number_of_instances * 60 minutos para servidores.
2. Pare o serviço rke nas instâncias. A operação expira após 5 minutos.
3. Remova os nós do cluster do Automation Suite e exclua as VMs. A operação expira após 20 minutos para agentes e number_of_instances * 60 minutos para servidores.

RemoveServers

Description

The RemoveServers runbook has the following use case:

• remova os servidores do cluster do Automation Suite.

Uso

1. Go to the Azure Portal and search for the resource called RemoveServers.
2. Selecione o botão para abrir a lista de parâmetros. Complete os parâmetros considerando o seguinte:

• REMOVEDSERVERSCOUNT é o número de servidores que serão removidos. Recomendamos remover não mais do que 2 servidores de cada vez para não atingir o tempo limite de quota justa .

  

Detalhes da implementação

The RemoveServers runbook removes the number of servers received as a parameter from the Availability Zones with the most VMs.

CheckServerZoneResilience

Description

The CheckServerZoneResilience runbook scales out the server VMSS and uses the RemoveServers runbook to balance the servers across Availability Zones. This is part of the InstanceRefresh flow and should not be run manually.

AddGpuNode

Description

No cenário em que a implantação inicial foi criada sem um nó de GPU, criamos o Conjunto de Escalonamento de VMs, mas temos um SKU diferente para evitar problemas de disponibilidade de zona/SKU. Esse runbook altera o SKU para um SKU de GPU e adiciona um nó.

Importante:

Do not scale the initial GPU VMSS created before running this runbook if the initial deployment was created without GPU nodes.

Uso

Para usar este runbook, execute as seguintes etapas:

1. Navegue até o grupo de recursos em que você implantou o Automation Suite, identifique e selecione Conta de automação.
2. Selecione Runbooks e, em seguida, o runbook AddGPUNode .
3. Forneça um nome para o SKU que você deseja ter e selecione Iniciar.

Parâmetros:

skuName – o SKU para os nós de GPU VMSS.

Valores permitidos:

• Standard_NC8as_T4_v3
• Standard_NC12s_v3
• Standard_NC24s_v3

RegisterAiCenterExternalOrchestrator

Description

O runbook registra o AI Center no Orchestrator externo fornecido no momento da implantação.

Uso

O documento expõe um único parâmetro obrigatório, IdentityToken, que é um token de acesso de instalação gerado pelo serviço de Identidade externo. Como o token tem uma breve disponibilidade (aproximadamente 1 a 2 horas), recomendamos gerá-lo antes de executar o runbook. Para obter instruções, consulte Chave de instalação.

BackupCluster

Description

O runbook BackupCluster ajuda você a fazer backup do seu cluster.

Uso

1. Navegue até o grupo de recursos em que você implantou o Automation Suite, identifique e selecione a Conta do Automation.

   

2. Selecione Runbooks e, em seguida, o runbook BackupCluster .

   

3. Forneça um nome para o backup que você deseja criar.

   

4. Para iniciar uma operação de backup para o cluster do Automation Suite, selecione o botão Iniciar na parte superior da página.

   

5. Assim que o status da tarefa runbook for Completed, a operação de backup será concluída. Se o status do trabalho de runbook for Failed, você poderá verificar os logs na conta de armazenamento para obter mais informações.

   

GetAllBackups

Description

The GetAllBackups runbook helps you view a list of all available backups, both scheduled and manual.

RestoreClusterInitialize, RestoreSnapshot

Description

Esses runbooks ajudam a executar uma restauração do cluster.

Uso

Observação:

When starting the restore process, we put the cluster in maintenance mode. Once the restore process is successful, we take the cluster out of maintenance mode.

Para executar uma operação de restauração, execute as seguintes etapas:

1. Identify the restore files you want to use. To do this, navigate to your Automation Suite deployment Automation Account, and run the GetAllBackups runbook.

   

   

2. When the runbook job is complete, check the bottom of the Output tab for a list of available backups. Select the one you want to use in the restore operation and copy it.

3. Navigate back to the Automation Account and run the RestoreClusterInitialize runbook. For the parameter, paste the name of the previously copied backup file. At this point, the restore process is started.

   

4. The RestoreSnapshot job is started automatically. When the job is done, the restore process is complete.

   Observação:

   Logs are present in the storage account (ending with st), in the backups container, under the restores/<backup-name>/ folder, where backup-name is the name of the backup used to perform the restore.

5. Após uma restauração, você deve confirmar que o cluster está em um bom estado (consulte Validação da instalação ou qualquer link de solução de problemas do ArgoCD). Depois disso, você tem a opção de habilitar o backup no cluster executando o runbook RestoreClusterFinalize com o mesmo parâmetro que na etapa anterior. Isso habilita os backups para o cluster.

Solução de problemas

• Caso uma VM não entre no cluster do Automation Suite, uma reversão será tentada. As VMs recém-criadas seguirão as mesmas etapas que uma remoção de nó habitual (associar, drenar, interromper o serviço rke, remover o nó do cluster e excluir as VMs). Você pode encontrar os logs do procedimento de associação de nó na conta de armazenamento, dentro do contêiner de logs , em blobs como infra-<hostname>.log.
• In case of a failure while deleting nodes, any runbook will stop and display the logs for the step that failed. Fix the issue, complete the process manually or using the RemoveNodes runbook. You can find all the logs in the storage account, inside the logs container, as follows:
  • Isolamento e drenagem - <timestamp>-<runbook_abreviation>-drain_nodes.log
  • Interrompa o serviço do rke - <timestamp>-<runbook_abreviation>-stop_rke.log
  • Remova o nó do cluster - <timestamp>-<runbook_abreviation>-remove_nodes.log
• Em caso de tempo limite, você deve aguardar a etapa finalizar sua execução, verificar os logs e concluir o processo manualmente ou usando o runbook RemoveNodes . Todos os runbooks usam a funcionalidade Comando de Execução do Azure para executar código no contexto das VMs. Uma limitação desse método é que ele não retorna o status da execução. Portanto, as etapas para isolar, drenar e interromper o serviço rke são executadas de forma assíncrona, e o status é mantido com blobs no seguinte formato: <timestamp>-<runbook_abreviation>-<step_name>.<success/fail>.