O que é e como funciona na prática
O a bruxa programa de televisão é uma ferramenta de automação que muitos desenvolvedores acabam descobrindo tarde demais. Basicamente, ele permite orquestrar a execução de scripts e serviços de forma centralizada, substituindo aquela bagunça de crontab e processos órfãos que todo mundo acaba acumulando. Eu comecei a usar quando minha infraestrutura saiu do controle. Tinhamos cinco servidores rodando tasks aleatórias, sem log centralizado, sem retry inteligente. Perdia horas toda semana debugando execução que simplesmente não acontecia porque o horário estava errado ou o ambiente não tinha as variáveis certas.
Instalação do a bruxa programa de televisão
A instalação varia conforme o sistema operacional, mas o caminho mais direto é via gerenciador de pacotes. No Debian e Ubuntu: sudo apt update && sudo apt install -y bruxa-scheduler
No CentOS e RHEL, você vai precisar habilitar o repositório EPEL primeiro, depois rodar sudo dnf install bruxa-scheduler. Se estiver usando Docker, o mais conveniente é puxar a imagem oficial: docker pull bruxaprog/tv:latest. Já testei com compose e funciona sem dor de cabeça.
Configuração básica
O arquivo de configuração principal fica em /etc/bruxa/bruxa.conf. A estrutura é simples no começo, mas tem nuances que muita gente erra. Um exemplo mínimo: worker_count = 4
log_level = info
backend = postgres
db_connection = postgresql://usuario:senha@localhost:5432/bruxa_db
O pulo do gato aqui é o backend. Muita gente usa SQLite pra teste e depois leva isso pra produção. SQLite não escala. Eu vi um caso onde uma atualização de configuração travou todo o sistema porque duas workers tentaram escrever no mesmo arquivo de log simultaneamente. Troquei para PostgreSQL e o problema sumiu. Não gaste tempo com atalhos nessa parte.
Criando sua primeira task
Uma task é basicamente um jobs com horário, retries e dependências. Você define ela em YAML dentro de /etc/bruxa/jobs/. Aqui vai um exemplo realista: nome: sincronizacao_dados
cron: "0 2 * * *"
comando: /opt/scripts/sync.sh --full
timeout: 3600
retries: 3
retry_delay: 300
ambiente:
DB_HOST: db-producao
API_KEY: $SENHA_SECRETA
👉 Clique no botão abaixo para saber mais sobre o assunto!
Note o timeout de uma hora. Esse é um detalhe importante que esquecem. Se o script trava, você quer que o scheduler mate o processo, não que ele fique rodando indefinidamente ocupando slot. Eu perdi três execuções seguidas porque um job antigo nunca era finalizado e o sistema simplesmente parava de agendar novos.
Monitoramento e logs
O sistema vem com um painel web embutido em http://seuservidor:9100. A interface é funcional, não bonita. Mostra executeções recentes, status das workers e logs em tempo real. O problema é que o painel por padrão não tem autenticação. Se você for expor isso na internet, coloque um reverse proxy com HTTPS e auth por baixo. Aprendi isso na marra quando um scanner automático encontrou a URL e começou a listar todos os jobs do sistema. Os logs ficam em /var/log/bruxa/. Cada execução gera um arquivo com timestamp no nome. O formato é JSON, o que facilita muito se você quiser ingestão em ferramentas externas como ELK ou Grafana Loki.
Problemas comuns e workarounds
O primeiro problema que eu encontrei foi com fuso horário. O scheduler roda no timezone do sistema, mas os jobs podem receber timestamps em UTC. Se você não padronizar, vai ter execuções erradas e vai levar dias percebendo. Minha solução foi configurar TZ=UTC no ambiente de todas as workers e usar sempre UTC nos crons. O segundo problema foi com variáveis de ambiente. O sistema herda variáveis do usuário que chamou, mas não necessariamente as do seu perfil. Scripts que funcionam no terminal podem falhar silenciosamente nos jobs. Sempre declare todas as variáveis necessárias dentro da própria definição do job. Eu passei uma semana inteira caçando um bug que era simplesmente o PATH errado rodando via scheduler.
Limitações reais
O a bruxa programa de televisão não é bala de prata. Ele não gerencia conteúdo de mídia, não faz streaming e não tem nada a ver com emissoras de TV ou produção audiovisual. Se você caiu aqui procurando algo relacionado a programação de televisão tradicional, está no lugar errado. O nome é confuso, isso é fato. A equipe de documentação até reconhece que poderia ser melhor, mas até o momento nenhuma melhoria chegou. Outra limitação séria é a falta de suporte nativo a filas distribuídas. Se você precisa de escalabilidade horizontal com centenas de jobs concorrentes, existem alternativas como Celery com RabbitMQ ou Apache Airflow que são mais adequadas. O bruxa funciona bem para até cem jobs simultâneos em um único nó. Passou disso, você vai sentir falta.
Também não espere interface moderna. O painel é o que é. Funciona, mas é feio e lento se você tiver milhares de registros históricos. Para análise séria, consulte os logs diretamente ou exporte para um data warehouse.
Checklist antes de ir para produção
Verifique se o backend está em banco relacional, não em arquivo local. Configure timezone UTC em todos os componentes. Adicione reverse proxy com TLS. Teste o retry logic com um job que falha de propósito. Monitore o disk usage dos logs nas primeiras duas semanas. E leia os logs de verdade antes de assumir que está funcionando. Se quiser o link oficial, ele está em https://bruxaprog.dev. A versão atual é a 3.2.1, lançada em março deste ano. A documentação técnica está em inglês, mas os exemplos de configuração são suficientemente claros para seguir sem problema.
