Klient shell

Dołączony klient cronitorex.sh opakowuje wywołania API, żebyś nie pisał curli ręcznie. Źródło skryptu żyje w publicznym repozytorium cronitorex-cli na GitHubie - możesz je audytować, zostawić gwiazdkę albo zgłosić issue.

Instalacja

Pobierz najnowszego klienta i dodaj do PATH:

curl -fsSL https://cronitorex.com/cronitorex.sh -o /usr/local/bin/cronitorex
chmod +x /usr/local/bin/cronitorex

Opcjonalnie: zweryfikuj pobrany plik z opublikowaną sumą kontrolną.

curl -fsSL https://cronitorex.com/cronitorex.sh.sha256
sha256sum /usr/local/bin/cronitorex

Skonfiguruj przez .cronitorex.conf w katalogu home:

api_url=https://api.cronitorex.com
api_key=your-cronitorex-api-key

Starszy config JSON (.cronitorex-config.json) jest nadal odczytywany dla zachowania kompatybilności.

Wersja i aktualizacje

Adres pobierania zawsze serwuje najnowszego klienta. Aktualizacja jest na żądanie, nie automatyczna.

cronitorex version          # zainstalowana wersja i data
cronitorex update --check   # sprawdź czy jest nowsza wersja
cronitorex update           # pobierz, zweryfikuj sumę, podmień (zostawia .bak)

update pobiera z tego samego adresu, weryfikuje sumę SHA-256, sprawdza składnię, robi kopię obecnego pliku jako .bak, po czym go podmienia. Wymaga curl, sha256sum i bash, aktualizuje tylko przez HTTPS.

Historia wersji: historia wersji klienta.

Użycie

cronitorex ping <monitor-name> <status> [options]

Statusy

cronitorex ping my-job run
cronitorex ping my-job complete
cronitorex ping my-job fail
cronitorex ping my-job skip

Opcje

Flaga	Opis
`--duration <seconds>`	Czas trwania joba
`--exit-code <int>`	Exit code procesu
`--host <hostname>`	Nadpisz hostname
`--message <text>`	Wiadomość logu

Przykład

cronitorex ping db-backup run

pg_dump mydb > /tmp/backup.sql
EXIT=$?

cronitorex ping db-backup $([ $EXIT -eq 0 ] && echo complete || echo fail) \
  --exit-code $EXIT \
  --duration $SECONDS

Sprawdzenie konfiguracji

Uruchom doctor, aby zweryfikować, czy wszystko jest poprawnie ustawione:

cronitorex doctor          # sprawdza config, adres API, klucz, łączność
cronitorex doctor --ping   # dodatkowo wysyła prawdziwy testowy ping (stan: skip)

Sprawdzane są: dostępność narzędzia HTTP (curl/wget), plik konfiguracyjny i jego uprawnienia, adres API i klucz, katalog tymczasowy, osiągalność API (/health) oraz dostęp do crontaba. Kod wyjścia: 0 gdy wszystko OK, 1 gdy są problemy.

Użycie w Dockerze

Zamontuj skrypt i config do kontenera:

volumes:
  - ./client/cronitorex.sh:/usr/local/bin/cronitorex:ro
  - ./client/.cronitorex.conf:/root/.cronitorex.conf:ro