Zostaviť cron výraz

Prečo vizuálny cron builder?

Cron expression drží na piatich poliach a napriek tomu zostáva jedným z najgenerujúcejších bugov v produkcii. Koľkokrát napísal vývojár 0 0 * * 1 mysliac si "každý pondelok", bez pripomenutia si, že 1 môže znamenať nedeľu podľa implementácií? Koľkokrát sme zamieňali */15 a 15? Cron builder odpovedá na túto potrebu: vizuálne skladať crontab expression, z bežných preset hodnôt alebo individuálnych polí, a získať finálny výraz pripravený na vloženie do Linux crontab, Kubernetes CronJob alebo GitHub Actions schedulu.

Nástroj je opakom nášho cron dekódera: tam, kde converter berie výraz a rozbaľuje ďalšie spustenia, builder berie ľudské voľby a produkuje zodpovedajúci cron výraz.

Ako to funguje

Grafické rozhranie navrhuje dva komplementárne módy zloženia:

• Preset mód: selektor frekvencie (every minute, every hour, every day, every week, every month, every year, custom), ktorý okamžite generuje validný cron expression.
• Field mód: päť editovateľných polí (minúta, hodina, deň mesiaca, mesiac, deň týždňa), kde voľne zadávate *, celé číslo, rozsah 1-5, zoznam 1,15,30 alebo krok */15.

Builder aktualizuje výraz v reálnom čase a zobrazuje stručné ľudské čítanie ("každý deň o 3h", "každých 15 minút"), ktoré slúži ako poistka: ak veta nesedí s vaším úmyslom, výraz je pravdepodobne nesprávny.

Päť cron polí, jasne

Štandardný cron expression obsahuje päť polí oddelených medzerami:

minuta  hodina  den-mesiaca  mesiac  den-tyzdna
*       *       *            *       *

• minúta (0 až 59);
• hodina (0 až 23);
• deň mesiaca (1 až 31);
• mesiac (1 až 12 alebo skratky Jan, Feb, atď.);
• deň týždňa (0 až 7, 0 a 7 reprezentujú nedeľu vo väčšine implementácií).

Každé pole akceptuje viacero foriem: * (všetky hodnoty), presné celé číslo (5), zoznam (1,3,5), rozsah (9-17), krok (*/15 každých 15 hodnôt), alebo kombinácia (0-30/5).

Typické prípady použitia

• Vývojár, ktorý sa učí cron: vizualizovať, ako každé pole interaguje, bez rizika nesprávneho výrazu v produkcii.
• Ponáhľajúci sa sysadmin: generovať za niekoľko sekúnd schedule pre Linux cron, Kubernetes CronJob alebo Ansible job bez opätovného čítania man page.
• Vývojár bez POSIX skúseností: produkovať validný crontab expression pre Symfony Scheduler, Laravel Scheduler alebo node-cron bez znalosti historickej syntaxe.
• DevOps v review: rýchlo prototypovať výraz na návrh v pull requeste, potom ho validovať cron dekóderom.
• Legacy migrácia: preformulovať historický cron výraz prechodom cez builder pre uistenie sa o sémantike pred jeho posunutím inam.

Bežné presety

Výber presetu prepisuje individuálne polia a produkuje zodpovedajúci výraz:

• Každú minútu: * * * * *. Vyhnúť sa v produkcii okrem konkrétnej potreby.
• Každú hodinu: 0 * * * *. Pri každom začiatku hodiny.
• Každý deň: 0 0 * * *. O polnoci.
• Každý týždeň: 0 0 * * 0. Každú nedeľu o polnoci.
• Každý mesiac: 0 0 1 * *. 1. v mesiaci o polnoci.
• Každý rok: 0 0 1 1 *. 1. januára o polnoci.

Bežné patterns na znalosť

Skomponovať vlastný výraz

Pre špecifickejšie prípady asistent exponuje päť polí vo voľnom vstupe. Niekoľko užitočných príkladov:

• Každý deň o 3h ráno: minute=0, hour=3, ostatné polia *.
• Každých 15 minút: minute=*/15, ostatné polia *.
• Pondelok až piatok o 9h: minute=0, hour=9, day-of-week=1-5.
• 1. a 15. v mesiaci na poludnie: minute=0, hour=12, day-of-month=1,15.
• Každých 5 minút medzi 9h a 17h: minute=*/5, hour=9-17.

Ako používať cron builder

1. Vyberte preset (every minute, every hour, every day, every week, every month, every year), ktorý zodpovedá základu vašej potreby.
2. Spresnite v prípade potreby priamou úpravou piatich polí (minúta, hodina, deň mesiaca, mesiac, deň týždňa).
3. Prečítajte ľudskú vetu vygenerovanú nástrojom pre potvrdenie zámeru.
4. Skopírujte produkovaný cron expression cez tlačidlo kopírovania.
5. Validujte schedule naším cron dekóderom, ktorý počíta ďalšie reálne dátumy spustenia.
6. Vložte výraz do vášho Linux crontab, Kubernetes CronJob, Symfony Scheduler alebo GitHub Actions workflow.

Klasické pasti

• Kombinovaný deň mesiaca a deň týždňa: ak oba nie sú *, správanie sa líši podľa implementácií. Linux/Vixie cron aplikuje OR; moderné knižnice majú niekedy odlišné správanie. Vyhnúť sa.
• Deň 1 = pondelok alebo nedeľa?: podľa krajiny a konvencie. Väčšina Unix cron považuje nedeľa=0 a sobota=6. Skontrolujte váš planner.
• Časové pásmo: Unix cron používa defaultne pásmo servera. Aplikačné plannery (Symfony Scheduler, Quartz) často umožňujú fixovať dedikované pásmo.
• Chýbajúca minúta: * * * * * spúšťa job každú minútu, čo zriedka chceme. Pamätajte fixovať presný trigger (0) pre hodinové úlohy.

Ľudské čítanie a výstup

Okrem cron expression nástroj navrhuje stručné ľudské čítanie ("každý deň o polnoci", "každých 5 minút"). Je to poistka: ak veta nezodpovedá vášmu zámeru, výraz je pravdepodobne nesprávny. Pre komplexný prípad použite potom náš cron dekóder na výpočet ďalších reálnych dátumov spustenia.

Často kladené otázky

Ukážka požiadavky

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":"*"}'

Vstupná schéma

Koncové body

• GET https://cdrn.fr/api/v1/tools - vypíše všetky dostupné nástroje
• GET https://cdrn.fr/api/v1/tools/cron-builder - získa schému tohto nástroja
• POST https://cdrn.fr/api/v1/tools/cron-builder/execute - spustí tento nástroj s JSON payloadom