Skip to content
Ansible role for installing Apache Maven
Shell Python
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.moleculew Increased upper Ansible test range to Ansible 2.8 (#119) Jul 19, 2019
defaults Made download timeout configurable (#117) Jul 14, 2019
handlers
meta Increased minimum Ansible version to 2.6 (#120) Jul 21, 2019
molecule
tasks Made download timeout configurable (#117) Jul 14, 2019
templates
vars Updated to Maven to version 3.6.1 (#112) Apr 13, 2019
.editorconfig Added .editorconfig file (#37) Sep 9, 2016
.gitattributes Standardized .gitattributes across roles (#2) Aug 20, 2016
.gitignore Added pycache to .gitignore (#30) Aug 26, 2016
.travis.yml Increased minimum Ansible version to 2.6 (#120) Jul 21, 2019
.yamllint
LICENSE Initial commit Aug 13, 2016
README.md
moleculew

README.md

Ansible Role: Maven

Build Status Ansible Galaxy License

Role to install the Apache Maven build tool.

Requirements

  • Ansible >= 2.6

  • Linux Distribution

    • Debian Family

      • Debian

        • Jessie (8)
        • Stretch (9)
      • Ubuntu

        • Trusty (14.04)
        • Xenial (16.04)
        • Bionic (18.04)
    • RedHat Family

      • CentOS

        • 6
        • 7
      • Fedora

        • 28
    • SUSE Family

      • openSUSE

        • 15.0
    • Note: other versions are likely to work but have not been tested.

  • Java SE Development Kit (JDK)

    • The required JDK version is dependent on the Apache Maven version

      Maven Version Minimum JDK Version
      3.6.x 7
      3.5.x 7
      3.3.x 7
      3.2.x 6
      3.1.x 5

Role Variables

The following variables will change the behavior of this role (default values are shown below):

# Maven version number
maven_version: '3.6.1'

# Mirror to download the Maven redistributable package from
maven_mirror: "http://archive.apache.org/dist/maven/maven-{{ maven_version|regex_replace('\\..*', '') }}/{{ maven_version }}/binaries"

# Base installation directory the Maven distribution
maven_install_dir: /opt/maven

# Directory to store files downloaded for Maven installation
maven_download_dir: "{{ x_ansible_download_dir | default(ansible_env.HOME + '/.ansible/tmp/downloads') }}"

# The number of seconds to wait before the Maven download times-out
maven_download_timeout: 10

# If this is the default installation, symbolic links to mvn and mvnDebug will
# be created in /usr/local/bin
maven_is_default_installation: yes

# Name of the group of Ansible facts relating this Maven installation.
#
# Override if you want use this role more than once to install multiple versions
# of Maven.
#
# e.g. maven_fact_group_name: maven_3_3
# would change the Maven home fact to:
# ansible_local.maven_3_2.general.home
maven_fact_group_name: maven

Supported Maven Versions

The following versions of Maven are supported without any additional configuration (for other versions follow the Advanced Configuration instructions):

  • 3.6.1
  • 3.6.0
  • 3.5.4
  • 3.5.3
  • 3.5.2
  • 3.5.0
  • 3.3.9
  • 3.2.5
  • 3.1.1

Advanced Configuration

The following role variable is dependent on the Maven version; to use a Maven version not pre-configured by this role you must configure the variable below:

# SHA256 sum for the redistributable package (i.e. apache-maven-{{ maven_version }}-bin.tar.gz)
maven_redis_sha256sum: '6e3e9c949ab4695a204f74038717aa7b2689b1be94875899ac1b3fe42800ff82'

Example Playbooks

By default this role will install the latest version of Maven supported by this role:

- hosts: servers
  roles:
    - role: gantsign.maven

You can install a specific version of Maven by specifying the maven_version (note: if the version is not currently supported by this role then additional configuration will be required - see Advanced Configuration):

- hosts: servers
  roles:
    - role: gantsign.maven
      maven_version: '3.3.9'

You can install the multiple versions of Maven by using this role more than once:

- hosts: servers
  roles:
    - role: gantsign.maven
      maven_version: '3.3.9'
      maven_is_default_installation: yes
      maven_fact_group_name: maven

    - role: gantsign.maven
      maven_version: '3.2.5'
      maven_is_default_installation: no
      maven_fact_group_name: maven_3_2

Role Facts

This role exports the following Ansible facts for use by other roles:

  • ansible_local.maven.general.version

    • e.g. 3.3.9
  • ansible_local.maven.general.home

    • e.g. /opt/maven/apache-maven-3.3.9

Overriding maven_fact_group_name will change the names of the facts e.g.:

maven_fact_group_name: maven_3_2

Would change the name of the facts to:

  • ansible_local.maven_3_2.general.version
  • ansible_local.maven_3_2.general.home

Related Roles

You may find the following related roles useful:

More Roles From GantSign

You can find more roles from GantSign on Ansible Galaxy.

Development & Testing

This project uses Molecule to aid in the development and testing; the role is unit tested using Testinfra and pytest.

To develop or test you'll need to have installed the following:

Because the above can be tricky to install, this project includes Molecule Wrapper. Molecule Wrapper is a shell script that installs Molecule and it's dependencies (apart from Linux) and then executes Molecule with the command you pass it.

To test this role using Molecule Wrapper run the following command from the project root:

./moleculew test

Note: some of the dependencies need sudo permission to install.

License

MIT

Author Information

John Freeman

GantSign Ltd. Company No. 06109112 (registered in England)

You can’t perform that action at this time.