Configure bots de UiPath RPA automaticamente na Amazon EC2 usando a AWS CloudFormation

PDF

Criado pelo Dr. Rahul Sharad Gaikwad (AWS) e Tamilselvan P (AWS)

Resumo

Esse padrão explica como você pode implantar bots de automação robótica de processos (RPA) em instâncias do Amazon Elastic Compute Cloud (Amazon EC2). Ele usa um pipeline do EC2 Image Builder para criar uma Amazon Machine Image (AMI) personalizada. Uma AMI é uma imagem de máquina virtual (VM) pré-configurada que contém o sistema operacional (OS) e o software pré-instalado para implantar instâncias. EC2 Esse padrão usa CloudFormation modelos da AWS para instalar a edição UiPath Studio Community na AMI personalizada. UiPath é uma ferramenta de RPA que ajuda você a configurar robôs para automatizar suas tarefas.

Como parte dessa solução, as instâncias EC2 do Windows são iniciadas usando a AMI básica e o aplicativo UiPath Studio é instalado nas instâncias. O padrão usa a ferramenta Microsoft System Preparation (Sysprep) para duplicar uma instalação personalizada do Windows. Depois disso, ele remove as informações do host e cria uma AMI final da instância. Em seguida, você pode executar as instâncias sob demanda usando a AMI final com suas próprias convenções de nomenclatura e configuração de monitoramento.

nota Esse padrão não fornece nenhuma informação sobre o uso de bots de RPA. Para obter essas informações, consulte a UiPath documentação. Você também pode usar esse padrão para configurar outros aplicativos de bot RPA personalizando as etapas de instalação com base em seus requisitos.

Esse padrão fornece as seguintes automações e benefícios:

• Implantação e compartilhamento de aplicativos: você pode criar a Amazon EC2 AMIs para implantação de aplicativos e compartilhá-los em várias contas por meio de um pipeline do EC2 Image Builder, que usa CloudFormation modelos da AWS como scripts de infraestrutura como código (IaC).

• EC2 Provisionamento e escalabilidade da Amazon: os modelos de CloudFormation IaC fornecem sequências personalizadas de nomes de computadores e automação de junção do Active Directory.

• Observabilidade e monitoramento: o padrão configura os CloudWatch painéis da Amazon para ajudar você a monitorar as EC2 métricas da Amazon (como uso de CPU e disco).

• Benefícios da RPA para sua empresa: a RPA melhora a precisão porque os robôs podem realizar tarefas atribuídas de forma automática e consistente. A RPA também aumenta a velocidade e a produtividade porque remove operações que não agregam valor e lida com atividades repetitivas.

Pré-requisitos e limitações

Pré-requisitos

• Uma conta AWS ativa

• Permissões do AWS Identity and Access Management (IAM) para implantação de modelos CloudFormation

• Políticas do IAM para configurar a distribuição de AMI entre contas com o EC2 Image Builder

Arquitetura

1. O administrador fornece a AMI básica do Windows no ec2-image-builder.yaml arquivo e implanta a pilha no CloudFormation console.

2. A CloudFormation pilha implanta o pipeline do EC2 Image Builder, que inclui os seguintes recursos:

   • Ec2ImageInfraConfiguration

   • Ec2ImageComponent

   • Ec2ImageRecipe

   • Ec2AMI

3. O pipeline do EC2 Image Builder inicia uma EC2 instância temporária do Windows usando a AMI básica e instala os componentes necessários (nesse caso, o UiPath Studio).

4. O EC2 Image Builder remove todas as informações do host e cria uma AMI do Windows Server.

5. Você atualiza o ec2-provisioning yaml arquivo com a AMI personalizada e executa várias EC2 instâncias com base em seus requisitos.

6. Você implanta a macro Count usando um CloudFormation modelo. Essa macro fornece uma propriedade Count para CloudFormation recursos para que você possa especificar facilmente vários recursos do mesmo tipo.

7. Você atualiza o nome da macro no CloudFormation ec2-provisioning.yaml arquivo e implanta a pilha.

8. O administrador atualiza o arquivo ec2-provisioning.yaml com base nos requisitos e inicia a pilha.

9. O modelo implanta EC2 instâncias com o aplicativo UiPath Studio.

Ferramentas

Serviços da AWS

• CloudFormationA AWS ajuda você a modelar e gerenciar recursos de infraestrutura de forma automatizada e segura.

• CloudWatchA Amazon ajuda você a observar e monitorar recursos e aplicativos na AWS, no local e em outras nuvens.

• A Amazon Elastic Compute Cloud (Amazon EC2) fornece capacidade computacional segura e redimensionável na Nuvem AWS. Você poderá iniciar quantos servidores virtuais precisar e escalá-los na vertical rapidamente.

• EC2 O Image Builder simplifica a criação, o teste e a implantação de máquinas virtuais e imagens de contêineres para uso na AWS ou localmente.

• EventBridgeA Amazon ajuda você a criar aplicativos orientados por eventos em grande escala na AWS, em sistemas existentes ou em aplicativos de software como serviço (SaaS).

• O AWS Identity and Access Management (IAM) ajuda você a controlar de modo seguro o acesso a recursos da AWS. Com o IAM, é possível gerenciar, de maneira centralizada, permissões que controlam quais recursos da AWS os usuários poderão acessar. Você usa o IAM para controlar quem é autenticado (fez login) e autorizado (tem permissões) a usar os recursos.

• O AWS Lambda é um serviço computacional com tecnologia sem servidor e orientado a eventos que permite executar o código em praticamente qualquer tipo de aplicativo ou serviço de backend sem o provisionamento ou gerenciamento de servidores. Você chama as funções do Lambda a partir de mais de 200 serviços da AWS e aplicativos de SaaS e pagar somente pelo que usar.

• O Amazon Simple Storage Service (Amazon S3) é um serviço de armazenamento de objetos baseado na nuvem que ajuda você a armazenar, proteger e recuperar qualquer quantidade de dados.

• O AWS Systems Manager Agent (SSM Agent) ajuda o Systems Manager a atualizar, gerenciar e configurar EC2 instâncias, dispositivos periféricos, servidores locais e máquinas virtuais ()VMs.

Repositórios de códigos

O código desse padrão está disponível na configuração do bot GitHub UiPath RPA usando o CloudFormation repositório. O padrão também usa uma macro que está disponível no repositório de CloudFormation macros da AWS.

Práticas recomendadas

• A AWS lança um novo Windows AMIs todo mês. Elas contêm os drivers, agentes de execução e patches do SO mais recentes. Recomendamos utilizar o AMI mais recente ao executar novas instâncias ou ao criar suas próprias imagens personalizadas.

• Aplique todos os patches de segurança disponíveis para Windows ou Linux durante a criação de imagens.

Épicos

Implementar um pipeline de imagens para a imagem base

Tarefa	Descrição	Habilidades necessárias
Configure um pipeline do EC2 Image Builder.	Clone a configuração do bot UiPath RPA usando o CloudFormation repositório ou baixe o ec2-image-builder.yaml modelo do repositório. Faça login no Console de Gerenciamento da AWS e abra o CloudFormation console da AWS. Selecione Criar pilha. Na seção Specify template (Especificar modelo) escolha Upload a template file (Fazer upload de um arquivo de modelo). Localize e carregue o modelo ec2-image-builder.yaml do seu computador e escolha Próximo. Forneça os parâmetros de entrada para a pilha ou aceite os valores padrão. Escolha Próximo. nota O número e os valores dos parâmetros podem variar dependendo dos valores de entrada. Opcionalmente, configure as opções de pilha e escolha Próximo. Revise os detalhes da sua pilha. No final da tela, marque a caixa de seleção para reconhecer os recursos e, em seguida, escolha Enviar. Monitore o progresso da pilha. Quando o status estiver CREATE_COMPLETE, a implantação estará pronta.	AWS DevOps
Veja as configurações do EC2 Image Builder.	As configurações do EC2 Image Builder incluem configuração de infraestrutura, configurações de distribuição e configurações de verificação de segurança. Para ver as configurações: Abra o console do EC2 Image Builder. No painel de navegação, navegue até várias configurações do Image Builder. nota Como prática recomendada, você deve fazer qualquer atualização no EC2 Image Builder somente por meio do CloudFormation modelo.	AWS DevOps
Visualize o pipeline de imagens.	Para ver o pipeline de imagens implantado: No console do EC2 Image Builder, escolha Image pipelines no painel de navegação. Selecione o pipeline de imagens que você criou. Veja os detalhes de configuração das imagens de saída, da receita da imagem, da configuração da infraestrutura, das configurações de distribuição, EventBridge das regras e das tags da Amazon.	AWS DevOps
Veja os logs do Image Builder.	EC2 Os registros do Image Builder são agregados em grupos de CloudWatch registros. Para ver os logins CloudWatch: Abra o console de CloudWatch . No painel de navegação, selecione Logs, Grupos de log. Escolha o nome do grupo de registros. EC2 Os registros do Image Builder são agregados no grupo /aws/imagebuilder/XXX de registros. Verifique os logs mais recentes no respectivo fluxo de logs para ver se há erros encontrados ao executar o pipeline de imagens. EC2 Os registros do Image Builder também são armazenados em um bucket do S3. Para visualizar os logs no bucket: Abra o console Amazon S3. Na lista Buckets (Buckets), escolha o nome do bucket. Os logs são agregados no bucket do S3 <stack-name>-XXXXXX.	AWS DevOps
Faça upload do UiPath arquivo em um bucket do S3.	Baixe o .msi arquivo para o UiPath Studio no local https://download.uipath.comUiPathStudioCommunity/.msi. Faça upload do arquivo em um bucket do S3. Atualize o nome do bucket e a chave do arquivo no modelo ec2-image-builder.yaml, na seção de dados do usuário, linha número 310.	AWS DevOps

Implementar um pipeline de imagens para a imagem base

Tarefa	Descrição	Habilidades necessárias
Configure um pipeline do EC2 Image Builder.	Clone a configuração do bot UiPath RPA usando o CloudFormation repositório ou baixe o ec2-image-builder.yaml modelo do repositório. Faça login no Console de Gerenciamento da AWS e abra o CloudFormation console da AWS. Selecione Criar pilha. Na seção Specify template (Especificar modelo) escolha Upload a template file (Fazer upload de um arquivo de modelo). Localize e carregue o modelo ec2-image-builder.yaml do seu computador e escolha Próximo. Forneça os parâmetros de entrada para a pilha ou aceite os valores padrão. Escolha Próximo. nota O número e os valores dos parâmetros podem variar dependendo dos valores de entrada. Opcionalmente, configure as opções de pilha e escolha Próximo. Revise os detalhes da sua pilha. No final da tela, marque a caixa de seleção para reconhecer os recursos e, em seguida, escolha Enviar. Monitore o progresso da pilha. Quando o status estiver CREATE_COMPLETE, a implantação estará pronta.	AWS DevOps
Veja as configurações do EC2 Image Builder.	As configurações do EC2 Image Builder incluem configuração de infraestrutura, configurações de distribuição e configurações de verificação de segurança. Para ver as configurações: Abra o console do EC2 Image Builder. No painel de navegação, navegue até várias configurações do Image Builder. nota Como prática recomendada, você deve fazer qualquer atualização no EC2 Image Builder somente por meio do CloudFormation modelo.	AWS DevOps
Visualize o pipeline de imagens.	Para ver o pipeline de imagens implantado: No console do EC2 Image Builder, escolha Image pipelines no painel de navegação. Selecione o pipeline de imagens que você criou. Veja os detalhes de configuração das imagens de saída, da receita da imagem, da configuração da infraestrutura, das configurações de distribuição, EventBridge das regras e das tags da Amazon.	AWS DevOps
Veja os logs do Image Builder.	EC2 Os registros do Image Builder são agregados em grupos de CloudWatch registros. Para ver os logins CloudWatch: Abra o console de CloudWatch . No painel de navegação, selecione Logs, Grupos de log. Escolha o nome do grupo de registros. EC2 Os registros do Image Builder são agregados no grupo /aws/imagebuilder/XXX de registros. Verifique os logs mais recentes no respectivo fluxo de logs para ver se há erros encontrados ao executar o pipeline de imagens. EC2 Os registros do Image Builder também são armazenados em um bucket do S3. Para visualizar os logs no bucket: Abra o console Amazon S3. Na lista Buckets (Buckets), escolha o nome do bucket. Os logs são agregados no bucket do S3 <stack-name>-XXXXXX.	AWS DevOps
Faça upload do UiPath arquivo em um bucket do S3.	Baixe o .msi arquivo para o UiPath Studio no local https://download.uipath.comUiPathStudioCommunity/.msi. Faça upload do arquivo em um bucket do S3. Atualize o nome do bucket e a chave do arquivo no modelo ec2-image-builder.yaml, na seção de dados do usuário, linha número 310.	AWS DevOps

Implantar e testar a macro Count

Tarefa	Descrição	Habilidades necessárias
Implantar a macro Count.	Clone ou baixe a CloudFormation macro Count. Navegue para a pasta Count. Você precisará de um bucket S3 para armazenar os CloudFormation artefatos. Se você ainda não tiver um bucket do S3, crie um com o nome aws s3 mb s3://<bucket name>. Empacote o modelo de macro Count. O modelo usa o AWS Serverless Application Model (SAM), portanto, ele deve ser transformado antes que você possa implantá-lo. aws cloudformation package \ --template-file template.yaml \ --s3-bucket <your bucket name here> \ --output-template-file packaged.yaml Por exemplo: aws cloudformation package \ --template-file template.yaml \ --s3-bucket count-macro-ec2 \ --output-template-file packaged.yaml Implante o modelo empacotado para criar uma CloudFormation pilha. aws cloudformation deploy \ --stack-name Count-macro \ --template-file packaged.yaml \ --capabilities CAPABILITY_IAM Se você quiser usar o console, siga as instruções no épico anterior ou na CloudFormation documentação.	DevOps engenheiro
Testar a macro Count.	Para testar os recursos da macro, tente iniciar o modelo de exemplo fornecido com a macro.  aws cloudformation deploy \ --stack-name Count-test \ --template-file test.yaml \ --capabilities CAPABILITY_IAM	DevOps engenheiro

Implantar e testar a macro Count

Tarefa	Descrição	Habilidades necessárias
Implantar a macro Count.	Clone ou baixe a CloudFormation macro Count. Navegue para a pasta Count. Você precisará de um bucket S3 para armazenar os CloudFormation artefatos. Se você ainda não tiver um bucket do S3, crie um com o nome aws s3 mb s3://<bucket name>. Empacote o modelo de macro Count. O modelo usa o AWS Serverless Application Model (SAM), portanto, ele deve ser transformado antes que você possa implantá-lo. aws cloudformation package \ --template-file template.yaml \ --s3-bucket <your bucket name here> \ --output-template-file packaged.yaml Por exemplo: aws cloudformation package \ --template-file template.yaml \ --s3-bucket count-macro-ec2 \ --output-template-file packaged.yaml Implante o modelo empacotado para criar uma CloudFormation pilha. aws cloudformation deploy \ --stack-name Count-macro \ --template-file packaged.yaml \ --capabilities CAPABILITY_IAM Se você quiser usar o console, siga as instruções no épico anterior ou na CloudFormation documentação.	DevOps engenheiro
Testar a macro Count.	Para testar os recursos da macro, tente iniciar o modelo de exemplo fornecido com a macro.  aws cloudformation deploy \ --stack-name Count-test \ --template-file test.yaml \ --capabilities CAPABILITY_IAM	DevOps engenheiro

Implante a CloudFormation pilha para provisionar instâncias com a imagem personalizada

Tarefa	Descrição	Habilidades necessárias
Implante o modelo de EC2 provisionamento da Amazon.	Para implantar o EC2 Image Pipeline usando CloudFormation: Baixe o ec2-provisioning.yaml modelo do GitHub repositório ou localize-o em seu computador se você clonou o repositório. Abra o console de CloudFormation . Repita as etapas do primeiro épico (ou siga as instruções na CloudFormation documentação) para implantarec2-provisioning.yaml.	AWS DevOps
Veja as EC2 configurações da Amazon.	As EC2 configurações da Amazon incluem configurações de segurança, rede, armazenamento, verificações de status, monitoramento e tags. Para ver essas configurações: Abra o EC2 console da Amazon. No painel de navegação, escolha Instâncias e, em seguida, selecione a EC2 instância que foi criada pelo modelo de EC2 provisionamento da Amazon. No resumo da instância, selecione as guias para ver as EC2 configurações correspondentes da Amazon.	AWS DevOps
Veja o CloudWatch painel.	Abra o console de CloudWatch . No painel de navegação, escolha Painéis. Escolha o painel que tem o nome da sua pilha. nota Depois de provisionar a pilha, leva tempo para preencher o painel com métricas. O painel fornece essas métricas:CPUUtilization, DiskUtilization, MemoryUtilization, NetworkIn, NetworkOut, StatusCheckFailed.	AWS DevOps
Visualizar métricas personalizadas para uso de memória e disco.	No CloudWatch console, escolha Painéis. No painel de navegação, escolha Métricas, Todas as métricas. Escolha namespaces personalizados,. CWAgent	AWS DevOps
Visualizar os alarmes para uso da memória e do disco.	No CloudWatch console, no painel de navegação, escolha Painéis. Escolha Todos os alarmes.	AWS DevOps
Verificar a regra do ciclo de vida do snapshot.	Abra o EC2 console da Amazon. No painel de navegação, escolha Gerenciador de ciclo de vida. Verifique as configurações do ciclo de vida da AMI.	AWS DevOps

Implante a CloudFormation pilha para provisionar instâncias com a imagem personalizada

Tarefa	Descrição	Habilidades necessárias
Implante o modelo de EC2 provisionamento da Amazon.	Para implantar o EC2 Image Pipeline usando CloudFormation: Baixe o ec2-provisioning.yaml modelo do GitHub repositório ou localize-o em seu computador se você clonou o repositório. Abra o console de CloudFormation . Repita as etapas do primeiro épico (ou siga as instruções na CloudFormation documentação) para implantarec2-provisioning.yaml.	AWS DevOps
Veja as EC2 configurações da Amazon.	As EC2 configurações da Amazon incluem configurações de segurança, rede, armazenamento, verificações de status, monitoramento e tags. Para ver essas configurações: Abra o EC2 console da Amazon. No painel de navegação, escolha Instâncias e, em seguida, selecione a EC2 instância que foi criada pelo modelo de EC2 provisionamento da Amazon. No resumo da instância, selecione as guias para ver as EC2 configurações correspondentes da Amazon.	AWS DevOps
Veja o CloudWatch painel.	Abra o console de CloudWatch . No painel de navegação, escolha Painéis. Escolha o painel que tem o nome da sua pilha. nota Depois de provisionar a pilha, leva tempo para preencher o painel com métricas. O painel fornece essas métricas:CPUUtilization, DiskUtilization, MemoryUtilization, NetworkIn, NetworkOut, StatusCheckFailed.	AWS DevOps
Visualizar métricas personalizadas para uso de memória e disco.	No CloudWatch console, escolha Painéis. No painel de navegação, escolha Métricas, Todas as métricas. Escolha namespaces personalizados,. CWAgent	AWS DevOps
Visualizar os alarmes para uso da memória e do disco.	No CloudWatch console, no painel de navegação, escolha Painéis. Escolha Todos os alarmes.	AWS DevOps
Verificar a regra do ciclo de vida do snapshot.	Abra o EC2 console da Amazon. No painel de navegação, escolha Gerenciador de ciclo de vida. Verifique as configurações do ciclo de vida da AMI.	AWS DevOps

Excluir o ambiente (opcional)

Tarefa	Descrição	Habilidades necessárias
Exclua as pilhas.	Quando seu PoC ou projeto piloto estiver concluído, recomendamos que você exclua as pilhas criadas para garantir que não seja cobrado por esses recursos. Abra o CloudFormation console da AWS.  No painel de navegação, escolha Pilhas e selecione uma ou as duas pilhas que você criou anteriormente e que deseja excluir. A pilha deve estar em execução no momento. No painel de detalhes da pilha, escolha Excluir. Quando solicitado, escolha Excluir pilha. Importante A operação de exclusão da pilha não pode ser interrompida após o início. A pilha continua para o estado DELETE_IN_PROGRESS. Se houver falha ao excluir, a pilha estará no estado DELETE_FAILED. Para obter soluções, consulte Excluir falhas na pilha na documentação de solução de CloudFormation problemas da AWS. Para obter informações sobre como proteger pilhas de serem excluídas acidentalmente, consulte Como proteger uma pilha de ser excluída na documentação da AWS. CloudFormation	AWS DevOps

Excluir o ambiente (opcional)

Tarefa	Descrição	Habilidades necessárias
Exclua as pilhas.	Quando seu PoC ou projeto piloto estiver concluído, recomendamos que você exclua as pilhas criadas para garantir que não seja cobrado por esses recursos. Abra o CloudFormation console da AWS.  No painel de navegação, escolha Pilhas e selecione uma ou as duas pilhas que você criou anteriormente e que deseja excluir. A pilha deve estar em execução no momento. No painel de detalhes da pilha, escolha Excluir. Quando solicitado, escolha Excluir pilha. Importante A operação de exclusão da pilha não pode ser interrompida após o início. A pilha continua para o estado DELETE_IN_PROGRESS. Se houver falha ao excluir, a pilha estará no estado DELETE_FAILED. Para obter soluções, consulte Excluir falhas na pilha na documentação de solução de CloudFormation problemas da AWS. Para obter informações sobre como proteger pilhas de serem excluídas acidentalmente, consulte Como proteger uma pilha de ser excluída na documentação da AWS. CloudFormation	AWS DevOps

Solução de problemas

Problema	Solução
Ao implantar o modelo de EC2 provisionamento da Amazon, você recebe o erro: Received malformed response from transform 123xxxx: :Count.	Esse é um problema conhecido. (Veja a solução personalizada e o PR no repositório de CloudFormation macros da AWS.) Para corrigir esse problema, abra o console do AWS Lambda e atualize index.py com o conteúdo do GitHub repositório.

Recursos relacionados

GitHub repositórios

• UiPath Configuração do bot RPA usando CloudFormation

• CloudFormation Macro de contagem

Referências da AWS

• Criação de uma pilha no CloudFormation console da AWS (CloudFormation documentação)

• Solução de problemas CloudFormation (CloudFormation documentação)

• Monitore métricas de memória e disco para EC2 instâncias da Amazon ( EC2 documentação da Amazon)

• Como posso usar o CloudWatch agente para visualizar métricas do Monitor de Desempenho em um servidor Windows? (Artigo do AWS ref:Post)

Referências adicionais

• UiPath documentação

• Definindo o nome do host em uma SysPreped AMI (postagem no blog de Brian Beach)

• Como faço para que o Cloudformation reprocesse um modelo usando uma macro quando os parâmetros mudam? (Estouro de pilha)