WebCron alrendszer kezelése
- A WebCron beállításokat az adminisztrációs rendszerben a CRON menüpont alatt találod meg. Minden CRON feladatot célszerű a saját domainje alatt beállítani, így átláthatóbb milyen beállítások tartoznak egy domainhez.
- Az „Új” gombbal adhatunk hozzá új időzítést:
- Az értékek tartományai a következőek:
- Perc: 0 és 59 között
- Óra: 0 és 23 között
- Nap: 1 és 31 között
- A hét napja (DOW): 1 és 7 között (1: hétfő, 2: kedd, … 7: vasárnap)
- Url: a meghívandó script címe és kapcsolói Pl.: http://viacomkft.hu/test.php?do=cron&pass=secret
- E-mail küldés ha:
- „Ha a folytatólagos hibák száma egyenlő a limittel” - Pl.: a limitet beállítod mondjuk 3-ra. Csak akkor fogsz emailt kapni ha az egymás utáni hibák száma pontosan 3. Nem kapsz levelet 6, 9, 12 stb. esetén. Ahhoz hogy újra értesítsen a hibáról a rendszer kell egy sikeres hívás majd újra 3 hibás.
- „Ha a folytatólagos hibák száma többszöröse a limitnek” - Pl.: a limitet beállítod mondjuk 3-ra. Emailt fogsz kapni minden alkalommal, amikor az egymás utáni hibák száma maradék nélkül osztható 3 mal: 3,6,9,12,15 stb.
- „Soha” - az email küldés funkció kikapcsolva.
- Limit: Lásd feljebb
- Helyreállás e-mail: Ha a hibáról már kaptál értesítést (hibák száma >= limit) akkor a hiba megoldódásáról (a hiba számláló nullázásáról) is fogsz kapni jelentést.
- E-mail cím: Ide megy majd a hibajelentés
- Megjegyzés: Ha több cron feladatod van, akkor a könnyebb azonosítás érdekében leírhatod hogy ez a feladat mit csinál. Ez a megjegyzés a hiba emailban is benne lesz.
- az óra, perc, nap, hét napja mezők értékét a következőkkel adhatod meg (vesszővel elválasztva):
- egyszerű értékek Pl.: 1
- tartományok Pl.: 1-5
- minden lehetséges érték: *
- oszthatóság Pl.: */5 (minden 5-tel osztható) vagy 1-30/10 (minden 10-el osztható 1 és 30 között, azaz 10,20,30)
Az adott WebCron folyamat akkor fut le, ha minden feltétel (perc, óra, nap, hét napja) egyszerre teljesül.
- Példák:
- 10 percenként:
- perc: */10
- óra: *
- nap: *
- a hét napja (DOW): *
- minden egész óra 5. percében:
- perc: 5
- óra: *
- nap: *
- a hét napja (DOW): *
- minden páros órában 10 percenként:
- perc: */10
- óra: */2
- nap: *
- a hét napja (DOW): *
- minden hétköznap hajnal 1, 2, 3 órakor valamint délben:
- perc: 0
- óra: 1-3,12
- nap: *
- a hét napja (DOW): *
- minden hétfőn éjfélkor:
- perc: 0
- óra: 0
- nap: *
- a hét napja (DOW): 1
Megjegyzések
- A WebCron rendszer úgy működik, mint egy időzített webböngésző: valódi HTTP(S) kéréseket intéz rendszerünk felé a megadott időpontokban, majd a visszatérési kód és script futásának ideje alapján dönti el, hogy a hívás sikeres vagy sikertelen volt-e.
- A tárhelyszolgáltatás alatt NEM lehetséges shell-alapú cron futtatást beállítani!
- Minden hívás látszik az access.log naplókban (a kéréseket a rendszer Viacom WebCron/verzió User-Agent mezővel adja le)
- Az időzített script hibái könnyebben kijavíthatóak a hibanaplók (error.log) alapján.
- Az időzített script kimenetét a rendszer tárolja és a CRON feladatben beállított esetekben elküldi az általad beállított e-mail címre.
- A rendszer csak és kizárólag nálunk hosztolt weboldalakon hajlandó időzített hívásokat végezni!
- A rendszer a CRON feladatok módosításait percenként dolgozza fel.
- A rendszer terheléselosztási okokból az elvégzendő feladatokat a végrehajás percén belül szétosztja. (domain azonosító modulo 60 alapján)
- Az így futtatott scriptekre érvényesülnek a szokásos limitációk és időkeretek, melyek a webkiszolgálásnál ismertek, így hosszabb futás esetén érdemes kimenetet írni, pl. éppen mit csinál a script, vagy hány százaléknál tart a munkájában, hogy a rendszer ne állítsa le a futtatást idő előtt. (Ez amúgy debug szempontból is előnyös!)
- Minden CRON feladatból egyszerre maximum 1 futhat. A rendszer kihagyja a feladat futtatását, amennyiben az adott feladat már fut (egy korábbi időzített futtatás eredménye képpen)
- Ha biztosítani szeretnéd, hogy a script ne induljon el egy „normál” webes kérésre, akkor az URL-hez GET paraméterként hozzáfűzhetsz például egy jelszót, aminek meglétét később a scriptben ellenőrizni tudod, pl.: http://viacomkft.hu/test.php?do=cron&pass=secret