This Ansible role installs and configures the Hotrod binary, Hotrod server and Hotrod agents.
See Hotrod's installation guide, and environment variables.
This Ansible role is made available under the MIT license. The use of Hotrod is subject to the Panoptix End User License Agreement.
This role supports Ubuntu 18.04, 20.04 and 22.10
./tasks/preflight.yml
will abort the playbook if the target system is not supported.
See ./exampes for installing different Hotrod components, as well as a test cluster setup.
All examples requires a value for hotrod_download_uri
. See downloads.
hotrod_download_uri
(Default: none)
The URI of the Hotrod binary release to download, which determines the installed version. See downloads for obtaining this URI.
hotrod_download_uri_sha1
(Default: {{ hotrod_download_uri }}.sha1
)
The URI of the SHA1 checksum associated with hotrod_download_uri
. No need to change this when performing standard downloads.
hotrod_system_group
(default: hotrod
)
The user group to run Hotrod server/agent as. The group is created if it doesn't exist (unless root
, but you shouldn't run Hotrod as root).
hotrod_system_user
(default: hotrod
)
The system user to run Hotrod server/agent as. The user is created if it doesn't exist (unless root
, but you shouldn't run Hotrod as root).
These variables control what this role installs:
hotrod_install_binary
(default: no
)
If yes, downloads and installs the Hotrod binary on the target system, as specified by hotrod_download_uri
.
hotrod_install_server
(default: no
)
If yes, installs and configures Hotrod server. Implies hotrod_install_binary: yes
.
hotrod_install_agent
(default: no
)
If yes, installs and configures Hotrod agent. Implies hotrod_install_binary: yes
.
See ./defaults/main.yml for customizing the Hotrod installation. Variables are documented, and most have reasonable defaults.
The hotrod_remove_*
variables can be used to remove some or all components. They are provided for easily cleanup on test systems, and as a reference for removing components, but should not be used on production Hotrod clusters.
Note that:
hotrod_remove_*
are mutually exclusive with theirhotrod_install_*
counterpartshotrod_system_user
andhotrod_system_group
will only be removed if both values match "hotrod
", to avoid undesirable effects when using non-defaultshotrod_remove_server
andhotrod_remove_agent
will destroy data directories!