This Ansible Collection wraps a tool called JCliff, designed to integrate the Wildfly server (or its product counterpart JBoss Enterprise Application (EAP) ) into a configuration management tool such as Ansible.
To install this Ansible collection simply download the latest tarball and run the following command:
$ ansible-galaxy collection install /path/to/middleware_automation.jcliff.tgz
Alternatively, you can simply build the tarball (to then install it):
$ ansible-galaxy collection build
The collection itself only provides the integration of JCliff into Ansible. JCliff itself needs to be installed and available on the system Ansible is running on.
For commodity purpose, the Collection comes with a role named 'jcliff:' that will take care of installing JCliff. However, currently, this role only supports Linux distribution using Yum (namely Fedora, RHEL and CentOS) and MacOSX using Homebrew.
- hosts: ...
collections:
- middleware_automation.jcliff
tasks:
- name: Include Jcliff role
include_role:
name: jcliff
If you would like to use it on windows we have named the role "win-jcliff" that will install out jcliff collection on windows. We have created a separate role for windows environment. - hosts: ... collections: - middleware_automation.jcliff tasks: - name: Include Jcliff role for windows include_role: name: win-jcliff
Refers to JCliff for more information on how to install the tool manually. JCliff being a Java based application setting up is pretty simple, so do not let it deter you from using the collection.
Once the Collection has been installed and JCliff is available on the system, you can directly use the tool within your playbook to configure a EAP or Wildfly instance:
---
- hosts: localhost
gather_facts: false
collections:
- middleware_automation.jcliff
tasks:
- jcliff:
wfly_home: /var/opt/jboss-eap-7.3
subsystems:
- system_properties:
- name: jcliff.enabled
value: 'enabled'
- name: jcliff.version
value: '1.0'