Skip to content

darkwizard242/ansible-role-locust

Repository files navigation

build-test release Ansible Role Maintainability Rating Reliability Rating Security Rating GitHub tag (latest SemVer) GitHub repo size

Ansible Role: locust

Role to install locust pip package on Debian/Ubuntu systems for load testing purposes.

Requirements

None.

Role Variables

Available variables are listed below (located in defaults/main.yml):

Variables List:

locust_debian_pre_reqs:
  - python3
  - python3-pip
locust_debian_pre_reqs_desired_state: present
pip_executable: pip3
pip_upgrade_version: latest
locust_app_debian_package: locust
locust_desired_state: present

Variables table:

Variable Description
locust_debian_pre_reqs Packages required to install locust on Debian based systems. Using python3 as python2.x is EOL by end of 2020.
locust_debian_pre_reqs_desired_state Desired state for locust pre-requisite apps on Debian systems.
pip_executable The executable to utilize for installing pip package of locust.
locust_app_debian_package Name of locust application package require to be installed i.e. locust on Debian based systems.
locust_desired_state Desired state for locust.

Dependencies

None

Example Playbook

For default behaviour of role (i.e. installation of locust package) in ansible playbooks.

- hosts: servers
  roles:
    - darkwizard242.locust

For customizing behavior of role (i.e. installation of latest locust package instead of ensure it is installed ) in ansible playbooks.

- hosts: servers
  roles:
    - darkwizard242.locust
  vars:
    locust_desired_state: latest

For customizing behavior of role (i.e. removal of locust package) in ansible playbooks.

- hosts: servers
  roles:
    - darkwizard242.locust
  vars:
    locust_desired_state: absent

License

MIT

Author Information

This role was created by Ali Muhammad, a DevOps/CloudOps Engineer who loves to learn and contribute to Open Source community.