Redis Cache: één gedeelde objectcache voor elk Justflows-proces
Redis Cache is een nieuwe eigen plugin die de objectcache van Justflows naar Redis verplaatst. Zo delen alle applicatieprocessen dezelfde gecachte pagina's en invalidaties. Je stelt alles in vanuit de admin, test de verbinding, leegt de cache wanneer nodig, en pagina's blijven werken als Redis wegvalt.

Justflows cachet al langer weergegeven pagina's, content, menu's en themagegevens. Op één server staat die cache in het geheugen of op schijf, en dat werkt prima. Draait een site op meerdere Node-processen of servers, dan houdt elk proces een eigen kopie bij. Pas je een pagina aan, dan wordt die alleen gewist op het proces dat de wijziging opsloeg. De andere processen blijven de oude versie tonen tot die verloopt.
Redis Cache is een nieuwe eigen plugin die dat oplost. De objectcache verhuist naar Redis, zodat elk proces dezelfde items leest en schrijft. Een pagina die één proces opbouwt, is meteen een hit voor alle andere. Sla je op één proces iets op, dan verdwijnt het item voor allemaal.
Elke instelling in de admin
Onder Gereedschap → Redis-cache staat de hele configuratie op één pagina, in dezelfde stijl als de rest van de admin:
- Verbinding. Host, poort, database, een ACL-gebruikersnaam en een wachtwoord. Het wachtwoord wordt versleuteld opgeslagen en nooit teruggestuurd naar de browser.
- TLS. Zet het aan voor beheerde Redis-diensten, controleer het servercertificaat, stel de servernaam in of plak het certificaat van een eigen CA.
- Sleutels en items. Een sleutelprefix, zodat meerdere installaties één Redis-server kunnen delen, een maximale levensduur voor elk item en gzip-compressie voor grote waarden.
- Time-outs en opnieuw verbinden. Time-outs voor opdrachten en verbinden, TCP keep-alive en hoe lang er tussen pogingen om opnieuw te verbinden wordt gewacht.
Verbinding testen probeert de waarden uit het formulier voordat je ze opslaat, en meldt de Redis-versie en de reactietijd. Een verkeerd wachtwoord wordt gemeld zonder het te herhalen. Na het opslaan verbindt het proces dat de wijziging verwerkte direct opnieuw, en volgen alle andere processen binnen 15 seconden. Een herstart is niet nodig.
Configureer je servers liever van buitenaf? Zet
REDIS_CACHE_URL en de andere REDIS_CACHE_*-variabelen, dan toont de pagina die waarden alleen-lezen. Werkt de verbinding, kies dan Redis (shared by every process) als driver onder Gereedschap → Prestatiesuite.Zie wat er in de cache staat, en leeg hem
Dezelfde pagina toont actuele cijfers van de server: versie, reactietijd, geheugengebruik ten opzichte van de limiet, het verwijderbeleid, sleutels in deze cache en in de database, hits, missers, verdrongen sleutels en een paar voorbeeldsleutels. Staat Redis op
noeviction, dan zegt de pagina dat, want schrijfacties mislukken dan zodra het geheugen vol is.- Deze cache legen verwijdert elke sleutel onder je prefix, voor alle sites, en laat sleutels van andere toepassingen met rust.
- Sleutels legen die beginnen met verwijdert één laag, zoals
page:html:voor weergegeven pagina's, op elke site. - FLUSHDB uitvoeren leegt de hele Redis-database. Die knop staat apart en werkt pas als je
FLUSHDBen het databasenummer intypt.
Valt Redis weg, dan blijven pagina's werken
Een cache hoort een site sneller te maken en mag hem nooit platleggen. Een storing kost dus snelheid, geen pagina's:
- Zolang Redis verbindt of onbereikbaar is, falen opdrachten meteen in plaats van te wachten, en worden pagina's zonder cache opgebouwd.
- Een mislukte leesactie telt als misser. Een mislukte schrijfactie wordt overgeslagen.
- Kan een invalidatie niet worden afgeleverd, dan gebruikt Justflows de cache niet meer tot die geleegd kan worden. Geen enkel proces blijft dan een pagina tonen die gewist had moeten zijn.
- De plugin verbindt vanzelf opnieuw, en Gereedschap, Status en Diagnostiek laten zien wat er speelt.
Toegang volgt je rollen
Redis Cache registreert vier rechten: de instellingen bekijken, ze beheren, de cache legen en de database leegmaken. Beheerders hebben ze alle vier. Onder Gebruikers → Rollen en rechten geef je ze aan een andere rol of aan een API-sleutel, en een recht dat tot bepaalde sites beperkt is, geldt alleen daar. De pagina biedt alleen de acties aan die je mag gebruiken.
Omdat de cache de hele installatie bedient, werkt de plugin alleen zolang hij actief is op de hoofdsite. Beheerders van een gehoste site zien hem niet en kunnen hem niet wijzigen.
Voor pluginontwikkelaars
Redis Cache gebruikt alleen de openbare plugin-SDK, en de kern van Justflows bevat geen Redis-code. De kern kreeg in plaats daarvan één algemeen uitbreidingspunt: een plugin met de nieuwe permissie
cache:store kan een opslag aanbieden voor de hele objectcache.export function activate(ctx: PluginContext) {
ctx.cache.registerStore?.({
id: "shared",
label: "My shared store",
// Called only when an operator picks this store as the cache driver.
create: ({ defaultTtlSeconds }) => connectToMyStore(defaultTtlSeconds),
});
}
De opslag implementeert
get, set, delete, invalidate, clear en status. De kern past de storingsregels hierboven toe op elke opslag, dus een toekomstige opslag voor Memcached of Valkey Cluster zou hetzelfde gedrag gratis meekrijgen. Het uitbreidingspunt komt met SDK 0.1.9.Wat het nog niet doet
- De plugin praat met één Redis-server. Redis Cluster en Sentinel worden nog niet ondersteund. Redis 5 of nieuwer werkt, net als compatibele servers zoals Valkey, KeyDB en Dragonfly.
- Ingelogde bezoekers slaan de paginacache altijd over, dus je ziet het effect als je als bezoeker door de site gaat.
- Justflows host Redis niet voor je. Je gebruikt je eigen server of een beheerde dienst.
Probeer het
Redis Cache is gratis, valt onder de GPL en komt naar de marketplace. Het vereist de Justflows-release die plugin-cacheopslag toevoegt. Een basisinstallatie heeft nog steeds niets extra's nodig: caching in het geheugen en op schijf blijft ingebouwd.
Je kunt de voortgang volgen in issue #18. Vragen of problemen kun je kwijt op support.justflows.com.
Bekijk Redis Cache in de marketplace✌️
Thanks for reading!
Find more posts on the blog or star Justflows on GitHub.