Ansible Collection - middleware_automation.infinispan

NOTE: If you are Red Hat customer, install redhat.data_grid from Automation Hub as the certified version of this collection.

This is an Ansible collection dedicated to Infinispan.

Infinispan can be used as remote caches for other software, such as Keycloak or Wildfly.

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 Ansible Galaxy

Before using the collection, you need to install it with the Ansible Galaxy CLI:

ansible-galaxy collection install middleware_automation.infinispan

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: middleware_automation.infinispan

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 middleware_automation-amq-*.tar.gz

Dependencies

Ansible collections:

Python:

The infinispan 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 Infinispan or DataGrid nodes or cluster, with configuration of static caches.
infinispan_cache: creates Infinispan or DataGrid caches at runtime.

Install playbook

playbooks/infinispan.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 infinispan_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.

infinispan_offline_install: true

License

Apache License v2.0 or later

See LICENSE to view the full text.