dioptra-worker-v1 Reference#

dioptra-worker-v1 is the command that starts a Dioptra worker process. It is provided by the dioptra-platform Python package and wraps the RQ worker CLI. The process polls a Redis queue for jobs submitted through the Dioptra REST API and executes them.

Environment Variables#

Required#

The process checks for these variables at startup and exits immediately if any are missing.

Variable

Description

MLFLOW_TRACKING_URI

MLflow tracking server URL (consumed natively by MLflow).

MLFLOW_S3_ENDPOINT_URL

S3-compatible endpoint URL for artifact storage (consumed natively by MLflow).

DIOPTRA_API

Dioptra REST API base URL.

DIOPTRA_WORKER_USERNAME

Username for worker authentication with the REST API.

DIOPTRA_WORKER_PASSWORD

Password for worker authentication with the REST API.

Optional#

Variable

Description

DIOPTRA_RQ_WORKER_LOG_AS_JSON

Enable JSON-formatted log output. Unset by default (disabled).

DIOPTRA_RQ_WORKER_LOG_LEVEL

Logging level (DEBUG, INFO, WARNING, ERROR). Defaults to INFO.

Command-Line Arguments#

dioptra-worker-v1 accepts the same arguments as the rq worker command. The two relevant arguments for starting a worker are:

-u, --url <redis-uri>

URL describing the Redis connection (e.g., redis://localhost:6379/0). Defaults to redis://localhost:6379/0 if not provided.

QUEUES

One or more queue names to poll, passed as positional arguments. At least one queue name is required.

Usage#

dioptra-worker-v1 --url redis://localhost:6379/0 tensorflow-cpu

See Also#