Ir para o conteúdo

Lab 6: Deploy de uma Automação

O Orquestrador BotCity Maestro oferece uma solução integrada para o gerenciamento de suas automações.

Esta etapa do workshop é focada no build e deploy do robô, criação de uma tarefa e execução via BotCity Runner.

Mais informações sobre o BotCity Maestro podem ser encontradas aqui.

Build do robô

Para realizar o processo de build, basta compactar o projeto com os arquivos bot.py, requirements.txt e qualquer outro arquivo ou pasta que esteja utilizando no código, formando um novo arquivo chamado bot-fakturama.zip.

Atenção

Se você estiver utilizando um ambiente virtual para desenvolvimento, como um venv, não há necessidade de incluí-lo no arquivo bot-fakturama.zip.

Outra opção é executar um dos scripts existentes na pasta de acordo seu sistema operacional, você pode executar o build.bat, build.ps1 ou build.sh

Atenção - Linux e macOS

Caso você receba uma mensagem de erro relacionada a permissões, certifique-se que seu arquivo build.sh tem as permissões de execução configuradas.

Para atribuir permissão de execução faça:

chmod +x build.sh

Deploy de uma automação

O Orquestrador BotCity Maestro possui um modo guiado para o deploy de novas automações chamado Easy Deploy.

Você pode acessar essa funcionalidade através do botão Easy Deploy no menu principal da aplicação:

Easy Deploy

Passo 1. Criar a automação

Nessa etapa, você vai selecionar a opção Criar nova automação preencher as informações sobre a automação que será enviada para a plataforma.

  • Nome da automação: BotFakturama
  • Descrição: Automação para extração de dados do Fakturama
  • Repositório: DEFAULT

Easy Deploy 1

Passo 2. Enviar o robô

Nesta etapa, preencha as seguintes informações, selecione o aquivo para enviar nosso robô para a plataforma e clique em Próximo:

  • ID do robô: BotFakturama
  • Versão: 1.0
  • Tecnologia: Python
  • Envio do arquivo: Selecione o bot-fakturama.zip

Seu formulário deve ficar semelhante à imagem abaixo:

Easy Deploy 2.1

Boa Prática

A BotCity permite a alocação de diferentes versões de robôs, o que é uma vantagem significativa permitindo transitar entre as versões facilmente. No entanto, é crucial tratar o desenvolvimento e o gerenciamento dos robôs como iniciativas de software propriamente ditas.

Para garantir a integridade e a eficiência no desenvolvimento e deploy de robôs, você pode adotar as seguintes práticas:

  • Controle de Versão com Ferramentas Apropriadas: Utilize ferramentas de controle de versão como Git para gerenciar o código dos robôs. Isso permite manter um histórico completo das alterações, colaborar de forma eficaz com a equipe e reverter mudanças quando necessário.

  • Versionamento e Branching: Crie branches para diferentes versões ou funcionalidades dos robôs. Utilize tags para marcar lançamentos ou marcos importantes. Isso facilita a gestão das versões e a integração de novas funcionalidades ou correções.

  • Documentação e Revisão de Código: Documente claramente cada versão do robô, incluindo alterações e melhorias feitas. Realize revisões de código regulares para garantir a qualidade e a segurança do código.

  • Integração Contínua e Deploy: Configure pipelines de integração contínua (CI) e deploy contínuo (CD) para automatizar a construção, teste e deploy dos robôs. Isso assegura que as versões dos robôs sejam testadas e implantadas de forma consistente e confiável. Veja mais como utilizar o GitHub Actions em suas iniciativas RPA alocados no Orquestrador da BotCity nesse link.

  • Gerenciamento de Configuração: Mantenha arquivos de configuração e variáveis de ambiente separados do código-fonte. Isso facilita a adaptação dos robôs a diferentes ambientes e cenários de execução sem modificar o código principal.

Passo 3. Onde executar

Nesta etapa defina em quais instâncias de BotCity Runner a automação pode ser executada e clique em Deploy

Easy Deploy 3

Nesse momento, você pode selecionar o Runner que foi criado na etapa de instalação do SDK: Lab 2: Setup e configuração - BotCity Studio SDK.

Caso desejar, você também pode criar um novo Runner, preenchendo um identificador no campo abaixo.

Importante

O valor configurado acima deve ser indicado na propriedade machineId do arquivo conf.bcf.

Mais detalhes no Lab 2: Setup e configuração - BotCity Studio SDK

Seu formulário deve ficar semelhante à imagem abaixo: Easy Deploy 3.1

Deploy realizado com sucesso! 🏆

Easy Deploy Sucesso

Agora, crie uma tarefa para ser executada através do BotCity Maestro.

Criar uma tarefa

Partindo da tela anterior, clique no botão Nova tarefa para ser redirecionado para o formulário de criação de tarefa para a automação:

Easy Deploy Sucesso

Acesse a documentação para ver mais detalhes sobre as opções que podem ser definidas ao criar uma nova tarefa.

Nesta tela, marque o campo Tarefa de Teste e clique em Criar, isso significa que esta tarefa pode ser reiniciada quantas vezes forem necessárias.

Dica

Tarefas de teste são extremamente úteis durante o processo de desenvolvimento de uma automação.

Assim uma nova tarefa entra para a fila de execução. Acompanhe no menu Fila de Tarefas:

Fila Tarefas

Atualizar um robô existente

Como parte do ciclo de desenvolvimento, é comum sobrescrever uma versão ou atualizar um código de um robô existente no Orquestrador BotCity Maestro.

Para isso, siga as instruções da documentação: atualizar um robô existente.