autotasker/README.md

1.7 KiB

Autotasker

Autotasker is a small server-side job runner and scheduler.

Autotasker free software licenced under GPLv3.

Getting started

  • Create a config file to define your tasks.
  • Deploy the server with docker or using git clone + cargo install binary + systemd service.
  • Enjoy!

Philosophy

Unix-like

  • Small.
  • Can be configured with a file.
  • Can be interfaced easily.

Features

  • List the tasks availables.
  • Run tasks in background.
  • Store the logs and tasks runs in a sqlite DB.
  • Schedule tasks (CRON-like).
  • OpenMetrics exporter to alert when a task failed.
  • External alerting when a task failed.
  • Trigger task via webhook, with a webhook token and debouncing.
  • Content negociation with JSON or HTML.
  • OAuth2 support for admin.

Vocabulary

  • Task is a configured command to be run.
  • TaskRun refer to a singular task run.

Deploy & Usage

Standard

You can use standard rust and cargo command to run the server. You can start the daemon with autotasker --config /path/to/config --database /path/to/database.db.

Docker

Build the alpine image:

just docker-build

Initialize the db:

just docker-init-db 

Run with config and db volume:

just docker-run

Getting started on development

This project use a justfile. just is a handy way to save and run project-specific commands.

Built with

  • Axum for web server.
  • Tera for templating.
  • Sqlx to interact with Sqlite.
  • Sqlite for storing state and logs.