Vídeos no horário: o Worker vira o despertador
Por que a rotina das páginas de vídeo deixou de depender do agendamento do GitHub e passou a ser acordada pelo Worker do site, minutos depois do vídeo sair.
- commit
bdf6e1e(williandsantos.com)- Author:
- Willian D. Santos
- Date:
Vídeos no horário: o Worker vira o despertador
registro 5 de 8 no ramo williandsantos.com
Contexto
Cada vídeo longo do canal ganha uma página no site, criada por uma rotina no GitHub Actions. Ela olha o canal, pega a legenda, escreve a página com IA e publica. Funcionava, mas o horário não era confiável. O agendamento do GitHub atrasa quando a fila está cheia, e em 17/11 a rotina marcada para as 8h só rodou às 16h27.
Os meus vídeos longos saem às 19h15. Com esse atraso, a página do vídeo podia aparecer no dia seguinte, justamente quando o movimento vindo do YouTube já tinha passado.
O que mudou
Quem acorda a rotina agora é o Worker da Cloudflare, o mesmo que serve o site. Ele dispara a rotina do GitHub por um comando que começa em segundos, em vez de esperar o agendamento.
- Às 19h20 e às 19h30 ele dispara sempre. A segunda tentativa cobre o caso de o YouTube demorar a publicar.
- Das 8h às 23h30, a cada 30 minutos, ele lê o feed público do canal, sem gastar cota da API, e só dispara se aparecer um vídeo longo novo que ainda não tem página.
- O agendamento do próprio GitHub ficou às 21h07, como rede de segurança.
A decisão
Mantive a rotina inteira no GitHub e passei para o Worker só o papel de despertador. A parte que decide o que vira página (Shorts ficam de fora, lives também, a legenda precisa existir) continua num lugar só, com os testes que já tinha.
Descartei ficar só com o agendamento do GitHub, apertando os horários: o atraso não é previsível, então não há horário que garanta a página no ar. Também não levei a rotina para dentro do Worker. Ela já funcionava e já passa pelos checks do repositório; o problema era só a hora de começar.
Para não disparar à toa, o Worker guarda no mesmo banco do Agora cada vídeo que viu e quantas vezes tentou. Um vídeo só ganha nova tentativa depois de duas horas sem página, até três vezes, e nada dispara se houve um disparo nos últimos 20 minutos.
Por que importa
A página do vídeo é onde o vídeo encontra o resto do site: o artigo do mesmo tema, os materiais e os cursos. Ela precisa estar no ar enquanto as pessoas ainda estão chegando, não horas depois. Com o Worker, assim que o token estiver cadastrado, a página deve sair poucos minutos depois do vídeo.
Pendências e próximo passo
- Cadastrar no Worker o token do GitHub que permite disparar a rotina. Sem ele, o despertador só registra que falta configurar e não gasta tentativas.
- Acompanhar os primeiros dias e conferir se a página sai entre 19h20 e 19h30.
Registro escrito depois da decisão, a partir dos commits e da documentação da rotina.
