O GitHub Actions é uma ferramenta poderosa que permite automatizar tarefas dentro do fluxo de trabalho de desenvolvimento. Uma aplicação útil disso é a capacidade de enviar notificações para diferentes plataformas, como o Telegram, sempre que ocorrerem eventos específicos em seus repositórios do GitHub. Neste artigo, vamos explorar como configurar e utilizar o GitHub Actions para enviar notificações via Telegram.
O que é o GitHub Actions?
O GitHub Actions é um serviço de automação integrado diretamente no GitHub, permitindo que você crie fluxos de trabalho personalizados para automatizar processos de desenvolvimento, desde a construção e teste até a implantação e notificação.
Configurando o Telegram Bot
Antes de começarmos com o GitHub Actions, é necessário criar um bot no Telegram e obter seu token de acesso. Siga os passos abaixo:
- Abra o Telegram e pesquise por
BotFather
. - Inicie uma conversa com o
BotFather
. - Use o comando
/newbot
para criar um novo bot. - Siga as instruções do
BotFather
, fornecendo um nome e um nome de usuário para o seu bot. - Após a criação, o
BotFather
irá fornecer um token de acesso para o seu bot. Mantenha esse token seguro, pois será usado posteriormente.
Configurando o GitHub Actions
Agora que temos o token do nosso bot, vamos configurar o GitHub Actions para enviar notificações para o Telegram sempre que ocorrerem eventos específicos em nosso repositório.
- No seu repositório do GitHub, crie um diretório chamado
.github/workflows
se ainda não existir. Dentro deste diretório, crie um arquivo YAML com o nome que desejar, por exemplo,
telegram-notification.yml
.Adicione o seguinte conteúdo ao arquivo YAML:
name: Telegram Notification
on:
push:
branches:
- main
jobs:
telegram-notification:
runs-on: ubuntu-latest
steps:
- name: Send Telegram Notification
uses: appleboy/telegram-action@master
with:
to: ${{ secrets.TELEGRAM_TO }}
token: ${{ secrets.TELEGRAM_TOKEN }}
message: "New commit pushed to the repository."
Neste exemplo, configuramos o fluxo de trabalho para enviar uma notificação para o Telegram sempre que houver um push para a branch principal (main
). Você pode personalizar os eventos e as branches conforme necessário.
- Agora, precisamos adicionar as variáveis de ambiente
TELEGRAM_TO
eTELEGRAM_TOKEN
como segredos em nosso repositório.
-
TELEGRAM_TO
: Este é o ID do chat para o qual a mensagem será enviada. Você pode obter isso iniciando uma conversa com seu bot no Telegram e usando a API do Telegram para recuperar o ID do chat. -
TELEGRAM_TOKEN
: Este é o token de acesso que obtivemos anteriormente doBotFather
.
Para adicionar esses segredos:
- Navegue até as configurações do seu repositório no GitHub.
- Selecione "Secrets" no menu lateral.
- Clique em "New repository secret" e adicione as variáveis
TELEGRAM_TO
eTELEGRAM_TOKEN
com seus valores correspondentes.
Testando o Fluxo de Trabalho
Com tudo configurado, você pode testar o fluxo de trabalho fazendo um push para a branch principal do seu repositório. Após o push, você deve receber uma notificação no Telegram informando sobre a nova alteração no repositório.
Conclusão
O GitHub Actions oferece uma maneira conveniente de automatizar tarefas repetitivas, como enviar notificações para plataformas externas como o Telegram. Neste artigo, vimos como configurar o GitHub Actions para enviar notificações via Telegram sempre que ocorrerem eventos específicos em um repositório do GitHub. Essa automação pode ajudar a manter equipes informadas sobre o progresso do desenvolvimento e a agilizar o fluxo de trabalho de desenvolvimento de software.
Top comments (0)