To install your Agent on your computer, just type:
curl https://install.zenaton.com | sh
Depending on your configuration, you may be asked for a password to allow global installation of Zenaton.
If you need to deploy the Agent on a particular system like Docker, Heroku, or Clever Cloud, we have some precooked solutions for you.
To update your Agent to the latest version, just follow the installation instructions above.
The Zenaton Agent can be configured in two different modes:
To have your Agent listening for tasks to execute, just type:
zenaton listen <parameters>
Your parameters can be in a
.env file, then you just need to provide it:
zenaton listen --env=<path/to/.env/file>
or can be inlined:
zenaton listen --<name>=<value>
If you mix both notations, inlined parameters will be prioritized.
|./.env||location of .env file containing configuration|
|-||location of boot file containing initialisation needed to be done before executing a task. This typically depends on your language. See Below.|
|ZENATON_APP_ID||-||Your application id - to listen only workflows started by your application (refer to Zenaton API section);|
|ZENATON_API_TOKEN||-||your API token - to prove you have rights to access above application (refer to Zenaton API section);|
|ZENATON_APP_ENV||-||your Zenaton environment - to distinguish workflows launched in production from workflows launched during development - typically "production", "staging", "dev" or your first name).|
|ZENATON_CONCURRENT_MAX||10||Maximum number of tasks that the Agent can execute concurrently|
|ZENATON_HANDLE_ONLY||-||List of classes that the Agent should handle and only them - (comma-separated strings). The default behavior is to handle all classes.|
|ZENATON_HANDLE_EXCEPT||-||List of classes that the Agent should NOT handle - (comma-separated strings). The default behavior is to handle all classes.|
Zenaton Agent will load your boot file before executing required tasks. This boot file should typically require all your workflow definitions. (see the examples-node repository on Github.)
If you use a framework, you may also need to add instructions to boot it.