Ansible Collection - middleware_automation.infinispan

Build Status

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

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.