To install the Girder Worker on your system, we recommend using
install the package.
pip install girder-worker
That will install the core girder-worker library and the built-in :ref:`plugins`.
Several aspects of the worker's behavior are controlled via its configuration file. The easiest
way to manage configuration is using the
girder-worker-config command that is installed
with the package. After installation, run
$ girder-worker-config --help
You should see the list of available sub-commands for reading and writing config values. To show all configuration options, run
$ girder-worker-config list
To set a specific option, use
$ girder-worker-config set <section_name> <option_name> <value>
$ girder-worker-config set celery broker amqp://me@localhost/
To change a setting back to its default value, use the
$ girder-worker-config rm celery broker
The core configuration parameters are outlined below.
celery.app_main: The name of the celery application. Clients will need to use this same name to identify what app to send tasks to. It is recommended to call this "girder_worker" unless you have a reason not to.
celery.broker: This is the broker that celery will connect to in order to listen for new tasks. Celery recommends using RabbitMQ as your message broker.
girder_worker.tmp_root: Each task is given a temporary directory that it can use if it needs filesystem storage. This config setting points to the root directory under which these temporary directories will be created.
girder_worker.plugins_enabled: This is a comma-separated list of plugin IDs that will be enabled at runtime, e.g.
girder_worker.plugin_load_path: If you have any external plugins that are not inside the girder_worker/plugins package directory, set this value to a colon-separated list of directories to search for external plugins that need to be loaded.
After making changes to values in the config file, you will need to restart the worker before the changes will be reflected.