Orquestração RPA: Como fazer deploy de qualquer tipo de automação no BotCity Maestro

Seguindo nossa série de artigos sobre Orquestração RPA, desta vez vamos entender como fazer a parte de deploy passo a passo dentro da nossa plataforma BotCity Maestro. E é importante ressaltar que podemos fazer o deploy de qualquer tipo de automação, seja ela construída em Python, Java, JavaScript, ou outras linguagens de programação, ou ainda outros frameworks como o Selenium.

Vamos quebrar esse mito de que não é possível orquestrar automações desenvolvidas em Python RPA ou quaisquer outras linguagens de programação e frameworks.

Setup e configuração do seu ambiente

Antes de mais nada, vamos configurar o ambiente para que você possa utilizar as ferramentas que vão te apoiar no deploy. Você deve acompanhar os passos indicados em nossa documentação, como a criação de uma conta (não se preocupe, essa conta é gratuita para que você possa testar as funcionalidades com a licença de comunidade).

Após isso, valide os pré-requisitos de instalação do Java e demais configurações e a instalação do BotCity SDK.

Deploy de sua automação

O nosso orquestrador BotCity Maestro oferece uma solução integrada para o gerenciamento de suas automações. Mais informações sobre ele podem ser encontradas em nossa documentação.

Para a demonstração, vamos utilizar como exemplo uma automação construída com Selenium. Caso queira utilizar o mesmo modelo, deixamos disponível em nosso GitHub neste repositório.

Preparando o robô para fazer o deploy

Basta compactar o projeto com todos os arquivos. Em nosso exemplo, podemos fazer isso de duas formas:

• Formando um novo arquivo compactado chamado bot-selenium.zip;
• Executando um dos scripts existentes na pasta de acordo seu sistema operacional: build.bat, build.ps1 ou build.sh. Esses scripts compactam os arquivos automaticamente.

Fazendo o deploy da automação pela opção “easy deploy”

Faça o login na plataforma developers.botcity.dev para ter acesso ao orquestrador e suas funcionalidades. Após fazer o login, você deverá ter acesso à página inicial que demonstra os primeiros passos com a ferramenta e ao lado esquerdo, terá um menu pelo qual vamos explorar as funcionalidades.

Identifique o botão nesse menu da lateral esquerda escrito “easy deploys”. Clique nesse botão para começarmos o processo.

A partir de agora, vamos começar a definir informações da nossa automação, do nosso robô e do runner, sendo este último o local onde será executado.

Automação (automation):

Na tela, identifique o campo disponível para preenchimento “what is the name of automation?”, que significa que está aguardando que seja digitado o nome da automação.

Neste exemplo, podemos chamar a nossa automação de “BotSelenium”. Em seguida, só clicar no botão “next”, localizado no canto inferior direito.

Robô (bot):

A tela que aparece a seguir nos pede para adicionar informações sobre o nosso robô.

Podemos preencher os campos da seguinte maneira:

• Bot ID: vamos manter como BotSelenium;
• Version: vamos deixar como 1.0 por ser a primeira versão do nosso robô;
• Bot technology: como estamos utilizando Selenium, vamos deixar com a opção Python;
• Repository: neste caso podemos deixar como default (padrão);
• Bot file upload: vamos arrastar o arquivo .zip que criamos até esse campo ou clicar nele para fazer o upload.

Após isso, clicamos diretamente no botão “next”, localizado na parte debaixo da tela.

Mais detalhes sobre o tipo de tecnologia e a opção Command:

No campo Bot technology existem as seguintes opções determinadas:

• Python;
• Java;
• JavaScript;
• Command.

Se o robô que você for fazer deploy não for feito em Python, nem em Java, nem em JavaScript, você poderá escolher a opção “Command”. Com essa opção selecionada, você poderá executar robôs diversos. Mais detalhes do passo a passo podem ser vistos neste artigo.

Runner:

A etapa final é a que vamos identificar o runner pelo qual o robô será executado.

No campo do lado esquerdo você pode selecionar um runner que já exista. Caso ainda não tenha ou caso seja necessário, você pode criar um novo runner pelo campo do lado direito. Então neste momento, você preencherá apenas um deles.

Após a seleção ou criação do runner, o botão “deploy”, localizado na parte debaixo da tela, será habilitado e você poderá clicar nele.

Neste momento, a próxima tela deverá ter uma notificação no canto superior do lado direito mostrando se o deploy aconteceu com sucesso. E, no centro, você terá o feedback dizendo que o a automação já está disponível para uso, tendo inclusive a opção de já criar tarefa para executá-la.

Saí da tela e perdi a chance de criar uma tarefa, o que eu faço?

Se você sair dessa tela, não se preocupe. Você ainda poderá criar tarefas relacionadas a essa automação que você fez deploy pela opção “New Task” no menu do BotCity Maestro, localizado na lateral esquerda da tela. Também veremos mais dessa parte nos próximos posts dessa série ou ainda pela nossa documentação.

 

Atualizar um robô existente

É bastante comum termos alterações e atualizações em nossos projetos, como parte do ciclo de desenvolvimento dos nossos robôs. E nós também podemos atualizar robôs existentes dentro da plataforma do BotCity Maestro.

Para isso, podemos acessar o menu da lateral esquerda e clicar na opção “Bots” dentro da categoria “Developer”.

Para facilitar, podemos pesquisar o robô pelo seu ID e identificar no lado direito da tela, o ícone com três pontos, clicar nele e identificar a opção “Edit”.

Ao clicar em “Edit”, vamos acessar uma tela parecida com uma das etapas de deploy, tendo apenas os seguintes campos para edição:

• bot technology, pelo qual configuramos a tecnologia utilizada na construção do robô;
• repository, pelo qual configuramos em qual repositório o robô deverá ficar;
• bot file upload, pelo qual podemos fazer upload do novo arquivo .zip gerado, após a alteração do código. E, neste caso, o único campo que de fato vamos atualizar.

Após subir o arquivo novo, o botão “save” é habilitado e podemos clicar nele para salvar as alterações. A partir disso, já teremos o robô atualizado para uso.

Controle de release de uma versão para produção

Também é bastante importante ter um controle das alterações dos seus robôs por releases. Então quando você executa atualizações importantes, seja para corrigir erros no seu código, ou para possibilitar novas funcionalidades no seu robô, você pode ter um controle de release. Ou seja, um controle de versão que deverá ser executada em produção.

O BotCity Runner executa apenas os robôs com versões marcadas como Release. Você pode determinar uma versão como release através do menu Meus robôs, clicando nas opções e marcando como Release o robô e versão desejados.

Em nosso exemplo do bot feito em Selenium, fizemos novos deploys de versões diferentes. Você pode fazer isso também pelo botão identificado com o nome de “Deploy” localizado na parte superior da lista de robôs.

Neste caso temos diversas versões e a que será considerada para execução em produção é aquela em que a coluna “Release Version” está preenchida. Essa seria a versão mais atualizada, identificada como 2.0.

Mas, se por algum motivo, for necessário voltar ou alterar alguma versão, clique no ícone de três pontos e em seguida clique na opção “release”.

Aparecerá uma nova tela para confirmação de alteração.

E a versão foi atualizada para a 1.0.

Utilizando GitHub Actions para atualizar o seu robô

Em nossa documentação, você também encontra um passo a passo para automatizar o processo de atualização do seu robô, caso utilize GitHub. Acompanhe por este link.

Dúvidas ou sugestões?

Fique à vontade para participar da nossa comunidade global no Slack ou ainda entrar em contato pelo nosso fórum. Qualquer dúvida, só chamar a gente!