{"id":5940,"date":"2023-06-13T11:24:45","date_gmt":"2023-06-13T14:24:45","guid":{"rendered":"https:\/\/blog.botcity.dev\/?p=5940"},"modified":"2023-06-13T15:41:48","modified_gmt":"2023-06-13T18:41:48","slug":"como-utilizar-o-github-actions-para-manter-seu-projeto-python-rpa-atualizado","status":"publish","type":"post","link":"https:\/\/blog.botcity.dev\/pt-br\/2023\/06\/13\/como-utilizar-o-github-actions-para-manter-seu-projeto-python-rpa-atualizado\/","title":{"rendered":"Como utilizar o GitHub Actions para manter seu projeto Python RPA atualizado"},"content":{"rendered":"

\u00c9 poss\u00edvel que voc\u00ea j\u00e1 tenha ouvido falar sobre o GitHub Actions. E caso ainda n\u00e3o tenha tido a oportunidade de conhecer essa funcionalidade, aproveite e explore a documenta\u00e7\u00e3o sobre ela neste\u00a0link<\/a>.<\/p>\n

E para aproveitar a praticidade de realizar diversas a\u00e7\u00f5es em projetos a partir desta funcionalidade, n\u00f3s criamos uma fun\u00e7\u00e3o do GitHub Actions para automatizar a atualiza\u00e7\u00e3o dos bots, chamada BotCity Actions, e voc\u00ea pode encontr\u00e1-la dispon\u00edvel neste\u00a0reposit\u00f3rio<\/a>.<\/p>\n

Por que utilizar o BotCity Actions?<\/h2>\n

Sempre que podemos automatizar um processo para facilitar o nosso dia-a-dia, faz sentido aprendermos como faz\u00ea-lo e entendermos se faz sentido em nosso contexto e necessidade. Ent\u00e3o, caso voc\u00ea tenha um processo cont\u00ednuo de desenvolvimento dos seus bots, por que n\u00e3o facilitar o seu dia-a-dia e automatizar n\u00e3o apenas os processos de neg\u00f3cio e produto, mas tamb\u00e9m o deploy e atualiza\u00e7\u00e3o de suas releases?<\/p>\n

Como funciona o BotCity Actions?<\/h2>\n

A nossa fun\u00e7\u00e3o realiza updates, deploys e releases de forma autom\u00e1tica para o nosso orquestrador, BotCity Maestro, sem a necessidade de implementa\u00e7\u00f5es manuais. Inclusive, caso voc\u00ea ainda n\u00e3o tenha familiaridade com a API do BotCity Maestro, para melhor aproveitamento, fique \u00e0 vontade para consultar nossa documenta\u00e7\u00e3o neste\u00a0link<\/a>.<\/p>\n

Aplicando a fun\u00e7\u00e3o BotCity Actions em seu projeto<\/h2>\n

Acompanhe o passo-a-passo abaixo. No exemplo, estamos considerando projetos constru\u00eddos com a linguagem Python. Contudo, fique \u00e0 vontade para utilizar outras linguagens e, caso tenha interesse, temos exemplos em nossa\u00a0documenta\u00e7\u00e3o<\/a>\u00a0para configura\u00e7\u00e3o de projetos em Java, JavaScript e TypeScript.<\/p>\n

<\/a>[0] Configura\u00e7\u00e3o do projeto<\/h3>\n

Como primeiro passo, voc\u00ea precisa adicionar uma estrutura de pastas em seu projeto. Primeiramente crie a pasta com o exato nome\u00a0.github<\/code>\u00a0na raiz do seu projeto. Dentro dessa pasta, crie outra com o exato nome\u00a0workflows<\/code>.<\/p>\n

Essa especifica\u00e7\u00e3o vem diretamente do GitHub e \u00e9 dessa forma que ser\u00e1 interpretado onde est\u00e3o as fun\u00e7\u00f5es que precisam ser executadas. Para maiores esclarecimentos, lembre-se de consultar a\u00a0documenta\u00e7\u00e3o<\/a>.<\/p>\n

[1] Cria\u00e7\u00e3o do primeiro workflow<\/h3>\n

Neste ponto, estamos considerando que voc\u00ea j\u00e1 tenha bots desenvolvidos. Mas se quiser uma ajuda, d\u00e1 uma olhada nesse link da nossa\u00a0documenta\u00e7\u00e3o<\/a>. Temos um tutorial bem interessante sobre como desenvolver um bot com os nossos frameworks Open Source.<\/p>\n

Ainda assim, ressaltamos que voc\u00ea pode usar bots constru\u00eddos com outras tecnologias em nosso orquestrador, por exemplo, Java, JavaScript, Selenium, scripts bash, entre muitos outros.<\/p>\n

Um dos eventos que podemos considerar em nossa action seria o\u00a0push<\/code>\u00a0na branch\u00a0main<\/code>. Isso significa que toda vez que ocorrer uma altera\u00e7\u00e3o na branch principal, voc\u00ea quer que um novo deploy seja feito no BotCity Maestro para atualizar o bot. Funciona dessa forma caso voc\u00ea esteja considerando algumas regras e boas pr\u00e1ticas do Git Flow, em que a branch\u00a0main<\/code>\u00a0\u00e9 a branch de produ\u00e7\u00e3o.<\/p>\n

Neste passo, dentro da pasta\u00a0workflows<\/code>, vamos criar o arquivo\u00a0update_bot.yml<\/code>. E voc\u00ea dever\u00e1 adicionar o c\u00f3digo abaixo para considerar justamente as altera\u00e7\u00f5es explicadas acima do evento\u00a0push<\/code>\u00a0na branch\u00a0main<\/code>:<\/p>\n

\n
name: Update the latest version bot on BotCity Maestro.\r\n\r\non:\r\n    push:\r\n      branches:\r\n        - main\r\n<\/code><\/pre>\n
\n
[2] Gerando o bot pela fun\u00e7\u00e3o BotCity Actions<\/span><\/div>\n<\/div>\n<\/div>\n
Para saber o que precisa ser adicionado na fun\u00e7\u00e3o, \u00e9 necess\u00e1rio tamb\u00e9m entender o \u00e9 necess\u00e1rio para o deploy do seu bot.<\/p>\n
Por exemplo, considerando que voc\u00ea desenvolveu sua automa\u00e7\u00e3o com o nosso framework Open Source, precisamos atender o seguinte pr\u00e9-requisito: gerar um arquivo zipado com o c\u00f3digo e as depend\u00eancias do bot, que pode ser criado a partir da execu\u00e7\u00e3o do script\u00a0.\/build.sh<\/code>\u00a0ou\u00a0.\/build.bat<\/code>, dependendo do sistema operacional. Esse script fica localizado na raiz do projeto criado a partir do nosso template do framework\u00a0desktop<\/a>\u00a0ou\u00a0web<\/a>.<\/p>\n
Ent\u00e3o, precisamos adicionar em nossa fun\u00e7\u00e3o as seguintes a\u00e7\u00f5es:<\/p>\n