Ansible Collection - redhat.data_grid

This collection can be used to manage the Red Hat product Red Hat DataGrid, which can also be used as remote caches for Red Hat Single Sign-On, Red Hat Build of Keycloak or Red Hat JBoss EAP.

Ansible version compatibility

This collection has been tested against following Ansible versions: >=2.15.0.

Plugins and modules within a collection may be tested with only specific Ansible versions. A collection may contain metadata that identifies these versions.

Installation and Usage

Installing the Collection from Automation Hub

Before using the collection, you need to setup Ansible Automation Hub as galaxy server; then install it via the CLI:

ansible-galaxy collection install redhat.data_grid

You can also include it in a requirements.yml file and install it via ansible-galaxy collection install -r requirements.yml, using the format:

---
collections:
  - name: redhat.data_grid

Build and install locally

Clone the repository, checkout the tag you want to build, or pick the main branch for the development version; then:

ansible-galaxy collection build .
ansible-galaxy collection install redhat-amq-*.tar.gz

Dependencies

Ansible collections:

• redhat.runtimes_common
• ansible.posix

Python:

The data_grid collection also depends on the following python packages to be present on the controller host:

• lxml
• jmespath

A requirement file is provided to install:

pip install -r requirements.txt

Included roles

• infinispan: performs an installation of DataGrid nodes or clusters, with configuration of static caches
• infinispan_cache: creates DataGrid caches at runtime

Install playbook

• playbooks/data_grid.yml deploys based on the collections defaults.

Controller node install zipfile path

By default the collection will download the desired version of the install zipfile to the ansible controller node, then it will distribute to target nodes.

Offline from controller node

Making the install zipfile archive available to the playbook working directory, and setting data_grid_offline_install to true, allows to skip the download tasks. The local path for the archive does match the downloaded archive path, so that it is also used as a cache when multiple hosts are provisioned in a cluster.

data_grid_offline_install: true

Downloading from the Customer Portal

The redhat.data_grid.data_grid role supports downloading and installing from the Red Hat Customer Portal, when the following variables are defined:

rhn_username: '<service_account_clientid>'
rhn_password: '<service_account_secret>'

The downloaded file will be stored in the controller working directory, and then distributed to target nodes.

Support

redhat.data_grid collection v1.3.2 is for Technical Preview. If you have any issues or questions related to collection, please don't hesitate to contact us on Ansible-middleware-core@redhat.com or open an issue on https://github.com/ansible-middleware/infinispan/issues

License

Apache License v2.0 or later

See LICENSE to view the full text.