Een GitLab-instantie stuurt bij elke pipeline een webhook hierheen. Een browsertab die op de speakers staat aangesloten (bij ons een Raspberry Pi onder de kantoor-tv) speelt een geluidje en zegt hardop wat er gebeurd is: “Fix login redirect loop by Marthijn passed!”
Het is oorspronkelijk gemaakt als demo voor een module van mijn tv-dashboard en toen bleek het op zichzelf ook leuk genoeg om te laten staan.
Waarom
Een pipeline die faalt merk je meestal te laat. Je zit in iets anders, de mail komt binnen tussen dertig andere mails en tegen de tijd dat iemand het ziet heeft de collega die de boel brak alweer verder gewerkt.
Geluid werkt daar beter voor dan een melding. Het onderbreekt zonder dat iemand ergens naar hoeft te kijken en omdat de naam van de commit en van de auteur worden uitgesproken weet iedereen meteen of het over hem gaat. Bijkomend effect: een falende pipeline is gênant en dat is precies de bedoeling.
Hoe het werkt
Alles draait op Vercel en er is niets dat aan hoeft te blijven. De webhook komt binnen op een serverless route in Nuxt, het gebeurtenis-overzicht staat in Redis bij Upstash en de openstaande tabbladen halen dat op en maken het lawaai zelf. Het geluid gaat via de Web Audio API en het uitspreken gebeurt met de spraakfunctie die in de browser zit. Er is dus geen dienst nodig die audio genereert.
Elke repository krijgt dezelfde webhook-URL en hetzelfde secret. Het bord houdt ze zelf uit elkaar en geeft elke repo een eigen gekleurde badge, dus een nieuwe repo aansluiten is één instelling en verder niets. Zit alles onder één groep, dan volstaat één webhook op groepsniveau.
Kernpunten waar ik trots op ben
- Web Audio API voor gegenereerd geluid, plus browser-TTS voor de uitspraak. Er zijn geen audiobestanden: de tonen worden in de browser opgewekt en de tekst wordt daar ook uitgesproken.
- Serverless webhook-route op Vercel met Upstash Redis als event-store. Er draait niets dat aan hoeft te blijven; wat binnenkomt wordt opgeslagen en de openstaande tabbladen halen het op.
- Ontdubbeling van dubbel binnenkomende webhook-events. Dezelfde pipeline stuurt meerdere keren iets en zonder ontdubbeling roept het bord alles twee keer om.
Wat er nog niet in zit
Niets en dat is de bedoeling. Het moest in twee dagen af zijn en dat is precies waarom het af is.
Wat het opleverde
Ik wist niet dat je geluid met code kunt maken. Ik ging ervan uit dat je audiobestanden nodig had en die zou moeten aanleveren, terwijl je met de Web Audio API gewoon tonen genereert in de browser. Datzelfde geldt voor het uitspreken van tekst: dat zit er ook gewoon in. Dat was de grootste verrassing van dit project.
En hoe eenvoudig webhooks in GitLab zijn. Eén URL, één secret, een vinkje bij het soort gebeurtenis dat je wilt en klaar. Ik had daar meer werk achter verwacht.
Dit begon als demo voor een module van tv-dashboard en dat onderdeel is daar uiteindelijk ook terechtgekomen; zie het artikel over TV Dashboard.