Task Registry

Basically, the so-called task registry is just a collection of onre or more task definitions. Speaking in terms of JSON, the task registry JSON file contains an array of task definition documents.

This file is then used for all follow-up steps of preparing an environment for running these tasks, such as generating the client package, containerization as well as deployment of tasks to a target environment.

Dump the Task Registry of a CLI

The task registry describes the set of tasks a CLI program (or multiple CLI programs) is able to execute. As described in the Task CLI, each such program shall be able to export this document in order to "describe itself":

my_task_cli --dump-task-definitions

Combining multiple Task Registries

It is possible to merge the registry files of multiple CLI programs by using an external program such as jq to concatenate the arrays of the two JSON files. Suppose you exported the task registry of two CLIs to the files a.json and b.json, then run the following command to concatenate these to c.json.

jq -s 'map(.[])' a.json b.json > c.json