ZendHQ 2.3.0

New features

  • Added support for OIDC authentication and authorization.

    • The zendhq_oidc ZendHQ extension implements the authentication and authorization using the OpenID Connect protocol.
    • The oauth2 JsonRPC namespace provides helper methods for OIDC authentication and authorization flow.
    • The OIDC provider must be configured in the ZendHQ daemon's configuration file before enabling the OIDC authentication and authorization.
    • Supported OIDC providers are:
    • microsoft: Microsoft Entra ID

  • Added support for Job Queue retry delay algorithms.

    • The Job Queue now supports different retry delay algorithms that can be used to control how long the Job Queue will wait before retrying a failed job.
    • The retry delay algorithm can be one of the following:
    • fixed-delay: a fixed delay in seconds (default);
    • linear-backoff: a linear backoff delay;
    • exponential-backoff: an exponential backoff delay;
    • exponential-jitter: an exponential backoff delay with jitter;
    • decorrelated-jitter: a variant of exponential backoff with jitter (AWS strategy).
    • The default retry delay algorithm can be set in the ZendHQ daemon's configuration file using the zendhqd.jobqueue.job_retry_delay_algo directive.
    • The default maximum cap for the retry delay can be set using the zendhqd.jobqueue.job_retry_delay_cap directive.

  • Added the cache_dir configuration directive to the ZendHQ daemon's configuration file that can be used to set the directory where the daemon will store its cache files. The default value is ${INSTALL_PREFIX}/var/cache.

  • Added support for environment variables in the ZendHQ daemon's configuration file.

    • Environment variables can be used in the configuration file by using the syntax = ${name}. The environment variable must be set before starting the ZendHQ daemon.

  • Added --sort-status and --sort-time options to the zendhqctl jobqueue job command subcommands list and history. These can be used together with the --all-queuesoption to sort entries by status and time.

Changes

  • Improved database cleanup in the ZendHQ daemon.

    • The ZendHQ daemon now deletes old database records in chunks, reducing the risk of long-running transactions that could cause database locks or degrade performance when many records need to be cleaned up.

Bug fixes

  • Fixed a bug that caused some recurring Job Queue jobs to be not re-loaded when ZendHQ daemon was restarted.

  • Fixed a bug that for HTTP POST and PUT jobs the Content-Type HTTP header was always set to application/x-www-form-urlencoded when the raw request body was used.

  • Fixed a bug that it was not possible to use the hash character # in Job Queue HTTP job query arguments.

New API and database schema versions

  • ØMQ messaging protocol API version is now 20250603.
  • ZendHQ daemon extension interface API version is now 20250324.
  • JsonRPC session namespace API version is now 1.11.
  • JsonRPC jq namespace API version is now 1.2.
  • Job Queue database schema version is now 2.2.