Ir para o conteúdo

Lab 2.2: Deploy de uma Automação

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

Nesta etapa do treinamento focaremos no build e deploy de nosso robô, criação de uma tarefa e execução via BotCity Runner.

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

Build do robô

Para realizar o processo de build, basta executar um dos scripts existentes na pasta do projeto. Dependendo do seu sistema, 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

Após o término do processo, o arquivo chamado BotYoutube.zip será criado na pasta raiz do projeto.

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. Criando a automação

Nesta etapa, escolha a opção Criar nova automação e preencha o formulário com as informações da sua automação:

  • Nome da automação: BotYoutube
  • Repositório: DEFAULT
  • Descrição da automação: Automação que busca inscritos e visualizações de canais do Youtube

Easy Deploy 1

Após preenchido, clique em Próximo.

Passo 2. Enviando o robô

Nesta etapa vamos enviar nosso robô para a plataforma, preenchendo algumas informações adicionais:

  • Upload do robô: BotYoutube.zip | Arquivo gerado no processo de build
  • ID do robô: BotYoutube
  • Versão do robô: 1.0
  • Tecnologia: Python

Easy Deploy 2.1

Clique em Próximo.

Passo 3. Onde executar

Nesta etapa vamos definir em quais instâncias de BotCity Runner nossa automação pode ser executada:

Easy Deploy 3

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

Importante

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

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

Seu formulário deve ficar conforme a imagem abaixo: Easy Deploy 3.1

Clique em Próximo.

Deploy realizado com sucesso! 🏆

Agora, clique em Nova Tarefa para criá-la no Orquestrador BotCity Maestro.

Easy Deploy Sucesso

Criar uma tarefa

Para criar uma nova tarefa, podemos preencher algumas informações:

  • Tarefa de Teste: marcada enquanto estamos desenvolvendo e testando a automação
  • Data de execução mínima: data e hora minima para que ela seja criada
  • Prioridade: Niveis de prioridade de 0 (menor) a 10 (maior)
  • Params: Parâmetros que podem ser passados para a execução

Easy Deploy Sucesso

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

Nesta tela, vamos selecionar Tarefa de Teste e clicar em Criar, isso significa que esta tarefa pode ser reiniciada quantas vezes quisermos.

Dica

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

Assim uma nova tarefa será enfileirada para execução. Na Fila de Tarefas, podemos ver a tarefa com o status Aguardando:

Fila Tarefas

Atualizar um robô existente

Como parte do ciclo de desenvolvimento, é comum modificarmos o código de um robô.

Para fazer a atualização de um robô existente podemos sobrescrever o código existente ou criar uma nova versão.

Importante

Lembre-se de executar a operação de build para garantir que o arquivo de seu robô está atualizado com as últimas modificações antes de fazer o upload.

Sobrescrever uma versão

Se você deseja sobrescrever uma versão existente, acesse o menu Robôs, encontre o robô pelo ID, clique nas opções e selecione Editar:

Editar Robo

Faça o build do projeto e o upload do novo arquivo de seu robô no formulário. Clique em Salvar para que o código seja atualizado:

Editar Robo

Criar uma nova versão

Passo 1. Escollher uma automação existente

Se você deseja criar uma nova versão do robô e ainda manter a anterior, acesse o menu Easy Deploy selecione a opção Escolher uma automação existente e siga os passos:

  • Repositório: DEFAULT
  • Automação: BotYoutube

Easy Deploy

Clique em Próximo.

Passo 2. Enviar o robô

Nesta etapa, faça o build de seu robô e preencha as informações adicionais:

  • Upload do robô: BotYoutube.zip | Arquivo gerado no processo de build
  • Versão do robô: 1.1

Marque a opção Fazer release desta versão para que a nova versão seja executada pelo BotCity Runner.

Easy Deploy 2.1

Passo 3. Onde executar

Aqui podemos adicionar ou remover Runners que podem executar essa automação. Mas para manter a mesma configuração, clique em Próximo.

Easy Deploy 3.1

Atualização realizada com sucesso! 🏆

Podemos verificar todas as versões de um robô acessando o menu Robôs e pesquisando pelo seu ID:

Editar Robo

Dica

A versão marcada como Release será executada pelo BotCity Runner.

Você pode determinar uma versão como release através do menu Robôs, clicando nas opções e marcando como Release o robô e versão desejados:

Editar Robo