speedtest
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
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-speedtestLicense
mit
Downloads
5191
Owner
Senior DevOps/CloudOps Engineer.
Dedicated to Automating everything I come across.
Love to work on and learn new technologies/tools everyday!