Een cron-expressie bouwen

Waarom een visuele cron builder?

Een cron-expressie bestaat uit vijf velden en blijft toch een van de meest bug-genererende in productie. Hoe vaak schreef een ontwikkelaar 0 0 * * 1 denkend "elke maandag", zonder zich te herinneren dat 1 zondag kan betekenen afhankelijk van de implementaties? Hoe vaak is */15 verward met 15? De cron builder beantwoordt deze behoefte: een crontab-expressie visueel samenstellen, op basis van gangbare voorinstellingen of individuele velden, en de uiteindelijke expressie verkrijgen klaar om te plakken in een Linux-crontab, een Kubernetes CronJob of een GitHub Actions-schedule.

De tool is het omgekeerde van onze cron decoder: waar de converter een expressie neemt en de volgende uitvoeringen toont, neemt de builder menselijke keuzes en produceert de bijbehorende cron-expressie.

Hoe het werkt

De grafische interface biedt twee complementaire compositiemodi:

• Voorinstellingsmodus: een frequentieselector (every minute, every hour, every day, every week, every month, every year, custom) die onmiddellijk een geldige cron-expressie genereert.
• Velden-modus: vijf bewerkbare velden (minuut, uur, dag van de maand, maand, dag van de week) waar u vrij *, een geheel getal, een bereik 1-5, een lijst 1,15,30 of een stap */15 invoert.

De builder werkt de expressie in real-time bij en toont een beknopte menselijke lezing ("elke dag om 3u", "elke 15 minuten") die als vangnet dient: als de zin niet bij uw bedoeling past, is de expressie waarschijnlijk verkeerd.

De vijf cron-velden, duidelijk

Een standaard cron-expressie bevat vijf velden gescheiden door spaties:

minute  heure  jour-du-mois  mois  jour-de-la-semaine
*       *      *             *     *

• minuut (0 tot 59);
• uur (0 tot 23);
• dag van de maand (1 tot 31);
• maand (1 tot 12 of afkortingen Jan, Feb, enz.);
• dag van de week (0 tot 7, waarbij 0 en 7 beide zondag betekenen in de meeste implementaties).

Elk veld accepteert meerdere vormen: * (alle waarden), een precies geheel getal (5), een lijst (1,3,5), een bereik (9-17), een stap (*/15 elke 15 waarden), of een combinatie (0-30/5).

Typische gebruiksgevallen

• Ontwikkelaar die cron leert: visualiseren hoe elk veld interageert, zonder het risico van een verkeerde expressie in productie.
• Sysadmin in een haast: in enkele seconden een schedule genereren voor een Linux-cron, een Kubernetes CronJob of een Ansible-job zonder de man page opnieuw te lezen.
• Ontwikkelaar zonder POSIX-ervaring: een geldige crontab-expressie produceren voor Symfony Scheduler, Laravel Scheduler of node-cron zonder de historische syntaxis te kennen.
• DevOps in review: snel een expressie prototypen om voor te stellen in een pull request, en deze vervolgens valideren met de cron decoder.
• Legacy-migratie: een historische cron-expressie herformuleren door de builder te gebruiken om zeker te zijn van de semantiek voordat deze elders wordt gepusht.

Gangbare voorinstellingen

Een voorinstelling selecteren overschrijft de individuele velden en produceert de bijbehorende expressie:

• Elke minuut: * * * * *. Te vermijden in productie behalve specifieke behoefte.
• Elk uur: 0 * * * *. Aan het begin van elk uur.
• Elke dag: 0 0 * * *. Om middernacht.
• Elke week: 0 0 * * 0. Elke zondag om middernacht.
• Elke maand: 0 0 1 * *. De 1e van de maand om middernacht.
• Elk jaar: 0 0 1 1 *. De 1e januari om middernacht.

Gangbare patronen om te kennen

Een aangepaste expressie samenstellen

Voor specifiekere gevallen biedt de assistent de vijf velden in vrije invoer. Enkele nuttige voorbeelden:

• Elke dag om 3u 's nachts: minuut=0, uur=3, andere velden *.
• Elke 15 minuten: minuut=*/15, andere velden *.
• Van maandag tot vrijdag om 9u: minuut=0, uur=9, dag-van-de-week=1-5.
• Elke 1e en 15e van de maand om 12u: minuut=0, uur=12, dag-van-de-maand=1,15.
• Elke 5 minuten tussen 9u en 17u: minuut=*/5, uur=9-17.

Hoe u de cron builder gebruikt

1. Kies een voorinstelling (every minute, every hour, every day, every week, every month, every year) die overeenkomt met de basis van uw behoefte.
2. Verfijn indien nodig door de vijf velden rechtstreeks te bewerken (minuut, uur, dag van de maand, maand, dag van de week).
3. Lees de door de tool gegenereerde menselijke zin om de bedoeling te bevestigen.
4. Kopieer de geproduceerde cron-expressie via de kopieerknop.
5. Valideer het schedule met onze cron decoder die de volgende werkelijke uitvoeringsdata berekent.
6. Plak de expressie in uw Linux-crontab, uw Kubernetes CronJob, uw Symfony Scheduler of uw GitHub Actions-workflow.

Klassieke valkuilen

• Dag van de maand en dag van de week gecombineerd: als beide niet * zijn, verschilt het gedrag afhankelijk van de implementaties. Linux/Vixie cron past een OF toe; de moderne bibliotheken hebben soms ander gedrag. Te vermijden.
• Dag 1 = maandag of zondag?: afhankelijk van het land en de conventie. De meeste cron Unix beschouwt zondag=0 en zaterdag=6. Controleer uw planner.
• Tijdzone: een Unix-cron gebruikt standaard de tijdzone van de server. De applicatieplanners (Symfony Scheduler, Quartz) staan vaak toe om een specifieke tijdzone vast te stellen.
• Ontbrekende minuut: * * * * * voert de taak elke minuut uit, wat zelden is wat we willen. Denk eraan om een precieze trigger (0) in te stellen voor uurlijkse taken.

Menselijke lezing en uitvoer

Naast de cron-expressie biedt de tool een beknopte menselijke lezing ("elke dag om middernacht", "elke 5 minuten"). Het is een vangnet: als de zin niet overeenkomt met uw bedoeling, is de expressie waarschijnlijk verkeerd. Voor een complexe zaak gebruikt u vervolgens onze cron decoder om de volgende werkelijke uitvoeringsdata te berekenen.

Veelgestelde vragen

Voorbeeldverzoek

curl -X POST https://cdrn.fr/api/v1/tools/cron-builder/execute \
  -H "Content-Type: application/json" \
  -d '{"preset":"none","minute":"*","hour":"*","day_of_month":"*","month":"*","day_of_week":"*"}'

Invoerschema

Endpoints

• GET https://cdrn.fr/api/v1/tools - toont alle beschikbare tools
• GET https://cdrn.fr/api/v1/tools/cron-builder - geeft het schema van deze tool terug
• POST https://cdrn.fr/api/v1/tools/cron-builder/execute - voert deze tool uit met een JSON-payload