ansible-role-jmeter

=========

Table Of Contents

• About
• Requirements
• Dependencies
• Role Parameters
• Installation
• Example Playbook
• License
• Author

About

This Ansible role helps you install Apache JMeter along with its plugins.

Requirements

Supported Operating Systems:

• Ubuntu
  • bionic (18.04)
  • xenial (16.04)
• Debian
  • stretch (9)
• Amazon Linux 2
• Red Hat
  • 7
  • 8
• CentOS
  • 7
  • 8

Minimum Ansible version:

• 2.8

Back to table of contents

Dependencies

Java 8
You can use either OpenJDK or Oracle SE Java. It can be installed manually or with Ansible roles like this:

Back to table of contents

Role Parameters

Quick list:

• jmeter_version
• jmeter_binaries_url
• jmeter_checksum
• jmeter_checksum_url
• jmeter_config_properties
• jmeter_package
• jmeter_root_path
• jmeter_report_path
• jmeter_path
• jmeter_plugins
• jmeter_plugins_install
• jmeter_plugins_manager_action
• jmeter_plugins_manager_version
• jmeter_cmdrunner_version
• jmeter_tmp_folder

jmeter_version

• Help: The version of JMeter you want to install (e.g. 5.2.1). If not specified, the latest version will be installed.
• Default: undefined

Back to table of contents

jmeter_binaries_url

• Help: The base URL to download JMeter binaries. You can change it to another source if needed.
• Default: https://archive.apache.org/dist/jmeter/binaries

Back to table of contents

jmeter_checksum

• Help: A checksum to verify the downloaded binary. The default value is obtained from the Apache repository defined by jmeter_checksum_url.
• Default: {{ lookup('url', jmeter_checksum_url).split()[0] }}

Back to table of contents

jmeter_checksum_url

• Help: The URL for the checksum to validate the downloaded binary.
• Default: https://archive.apache.org/dist/jmeter/binaries/{{ jmeter_package }}.sha512

Back to table of contents

jmeter_config_properties

• Help: List of configuration properties. Specify different configuration files using the name key and their parameters under properties.

• Default:

  • {'name': 'upgrade'}
  • {'name': 'system'}
  • {'name': 'jmeter'}
  • {'name': 'reportgenerator'}
  • {'name': 'saveservice'}
  • {'name': 'user'}

  Example:

    jmeter_config_properties:
      - name: system
        properties:
          - key: networkaddress.cache.negative.ttl
            value: 10
          - key: javax.net.debug
            value: ssl

Back to table of contents

jmeter_package

• Help: The name of the JMeter archive to download.
• Default: apache-jmeter-{{ jmeter_version }}.tgz

Back to table of contents

jmeter_root_path

• Help: The folder where JMeter will be installed.
• Default: /opt

Back to table of contents

jmeter_report_path

• Help: The path for the folder that contains generated reports.
• Default: {{ jmeter_root_path }}/reports

Back to table of contents

jmeter_path

• Help: The home folder path for JMeter.
• Default: {{ jmeter_root_path }}/apache-jmeter-{{ jmeter_version }}

Back to table of contents

jmeter_plugins

• Help: A list of JMeter plugins you want to install.
• Default: []

Back to table of contents

jmeter_plugins_install

• Help: Determines whether to install additional plugins. If set to true, the plugins manager will be installed and then the specified plugins from the jmeter_plugins list will be installed.
• Default: false

Back to table of contents

jmeter_plugins_manager_action

• Help: Action to perform with the JMeter plugin manager. Options: "install", "install-all-except", "uninstall".
• Default: install

Back to table of contents

jmeter_plugins_manager_version

• Help: Version of the plugin manager library.
• Default: latest

Back to table of contents

jmeter_cmdrunner_version

• Help: Version of the 'cmdrunner' Java library.
• Default: latest

Back to table of contents

jmeter_tmp_folder

• Help: Folder for temporary files during installation.
• Default: /tmp

Back to table of contents

Installation

Run the command: ansible-galaxy install lean_delivery.jmeter

Example Playbook

- name: Install Java and JMeter
  hosts: all
  roles:

    - role: lean_delivery.java
      java_distribution: openjdk
      java_major_version: 8
      transport: repositories
      java_tarball_install: false

    - role: lean_delivery.jmeter
      jmeter_plugins_install: true
      jmeter_plugins:
        - jpgc-casutg
        - jpgc-tst
        - jpgc-functions
        - jpgc-dummy

Back to table of contents

License

Apache

Back to table of contents

Author Information

Lean Delivery Team team@lean-delivery.com

Back to table of contents