speedtest

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

Ansible Role: speedtest

Role to install (by default) Ookla's Speedtest CLI package or uninstall (if passed as var) on Debian based systems and EL based systems. Speedtest CLI can be used for internet connection measurement.

Requirements

None.

Role Variables

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

Variables List:

speedtest_app: speedtest
speedtest_app_desired_state: present

# Debian family based
speedtest_debian_pre_reqs:
  - apt-transport-https
  - dirmngr
  - gnupg1
speedtest_debian_pre_reqs_desired_state: present
speedtest_repo_debian_gpg_key: https://packagecloud.io/ookla/speedtest-cli/gpgkey
speedtest_repo_debian: "deb https://packagecloud.io/ookla/speedtest-cli/{{ ansible_distribution | lower }}/ {{ ansible_lsb['codename'] }} main"
speedtest_repo_debian_filename: "{{ speedtest_app }}"
speedtest_repo_debian_keyring_filename: "{{ speedtest_app }}.gpg"
speedtest_repo_debian_keyid: C525F88FCF3A7E56CE2CF59131EB3981E723ACAA
speedtest_repo_debian_desired_state: present

# EL family based
speedtest_repo_el_name: ookla_speedtest-cli
speedtest_repo_el_description: ookla_speedtest-cli
speedtest_repo_el_baseurl: "https://packagecloud.io/ookla/speedtest-cli/el/{{ ansible_distribution_major_version }}/$basearch"
speedtest_repo_el_gpgcheck: no
speedtest_repo_el_gpgkey: https://packagecloud.io/ookla/speedtest-cli/gpgkey
speedtest_repo_el_filename: "{{ speedtest_app }}"
speedtest_repo_el_state: present
speedtest_repo_el_enabled: yes
speedtest_repo_el_filename_owner: root
speedtest_repo_el_filename_group: root
speedtest_repo_el_filename_mode: '0644'

Variables table:

Variable Description
speedtest_app Name of speedtest application package require to be installed i.e. speedtest
speedtest_app_desired_state State of the speedtest_app package. Whether to install, verify if available or to uninstall (i.e. ansible apt module values: present, latest, or absent)
speedtest_debian_pre_reqs Speedtest recommends the installation of both these packages on Debian family systems and as such, they are considered pre-requisites.
speedtest_debian_pre_reqs_desired_state Desired state for Speedtest pre-requisite apps on Debian family systems.
speedtest_repo_debian_gpg_key Speedtest GPG key url required on Debian family systems
speedtest_repo_debian Speedtest repo URL for Debain family systems.
speedtest_repo_debain_filename Name of the repository file that will be stored at /etc/apt/sources.list.d/ on Debian based systems.
speedtest_repo_debian_keyring_filename Name of the gpg file that will be stored at /etc/apt/trusted.gpg.d/' on Debian based systems. Should end in .gpg`
speedtest_repo_debian_keyid Key ID to import to ensure it hasn't changed. Download the key and use gpg --show-keys <keyfile> to determine the ID.
speedtest_repo_debian_desired_state present indicates creating the repository file if it doesn't exist on Debian based systems. Alternative is absent (not recommended as it will prevent from installation of speedtest package).
speedtest_repo_el_name Repository name for Speedtest on EL based systems.
speedtest_repo_el_description Description to be added in EL based repository file for Speedtest.
speedtest_repo_el_baseurl Repository baseurl for Speedtest on EL based systems.
speedtest_repo_el_gpgcheck Boolean for whether to perform gpg check against Speedtest repository on EL based systems.
speedtest_repo_el_gpgkey GPG key for Speedtest repository.
speedtest_repo_el_state present indicates creating the repository file if it doesn't exist on EL based systems. Alternative is absent (not recommended as it will prevent from installation of speedtest packages).
speedtest_repo_el_enabled Boolean to set so that Speedtest repository is enabled on EL based systems.
speedtest_repo_el_filename File path for the speedtest repository to be saved as on EL based systems.
speedtest_repo_el_filename_owner Owner of /etc/yum.repos.d/speedtest.repo on EL based systems.
speedtest_repo_el_filename_group Group of /etc/yum.repos.d/speedtest.repo on EL based systems.
speedtest_repo_el_filename_mode Mode of /etc/yum.repos.d/speedtest.repo on EL based systems.

Dependencies

None

Example Playbook

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

- hosts: servers
  roles:
    - darkwizard242.speedtest

For customizing behavior of role (i.e. installing latest verion of speedtest) in ansible playbooks.

- hosts: servers
  roles:
    - darkwizard242.speedtest
  vars:
    speedtest_apps_desired_state: latest

For customizing behavior of role (i.e. un-installation of speedtest packages) in ansible playbooks.

- hosts: servers
  roles:
    - darkwizard242.speedtest
  vars:
    speedtest_apps_desired_state: absent

License

MIT

Author Information

This role was created by Ali Muhammad.

About

Installs/Uninstalls Ookla Speetest app for internet connection measurement purposes.

Install
ansible-galaxy install darkwizard242/ansible-role-speedtest
GitHub repository
License
mit
Downloads
4486
Owner
Senior DevOps/CloudOps Engineer. Dedicated to Automating everything I come across. Love to work on and learn new technologies/tools everyday!