Ansible role for node-exporter

Installs node exporter on a variety of systems. By default, it will download the tar balls from the official node_exporter repo at https://github.com/prometheus/node_exporter

Role Variables

Name	Description	Type	Default	Required
node_exporter_final_dest	Directory where node_exporter should be installed	string	/usr/local/bin	true
node_exporter_flags	Extra flags to run node_exporter with	string	""	false
node_exporter_service_name	Name of the service	string	node_exporter	false
node_exporter_service_file_dest	Location to place service file	string	""	false
node_exporter_url	URL to download node_exporter from. This can be overwritten	string	https://github.com/prometheus/node_exporter/releases/download/v{{ node_exporter_version }}/node_exporter-{{ nod e_exporter_version }}.{{ distro }}-{{ architecture }}.tar.gz	true
node_exporter_version	Version of node_exporter to install	string	1.0.0-rc.0	true

Example Playbook

- hosts: all
  roles:
    - role: ansible-role-node-exporter
      vars:
        node_exporter_version: 1.0.0-rc.0

SSH Config

In order to get the delegated driver to work in molecule, you must set the SSH_CONFIG secret in GitHub Actions. An example would look like:

Host my-host-dev
  HostName my-host-dev.something.somewhere.cc
  Port 22
  IdentityFile ~/.ssh/id_rsa
  PreferredAuthentications publickey
  User cloud-user

The host will correspond to the list of platforms in the molecule.yml file

# molecule.yml
...
platforms:
  - name: my-host-dev
...

Testing on Static Hosts

The tests that run on static hosts will copy over the corresponding service file to the relevant location on the machine to allow the service to work, name the service node_exporter_test and run on port 9101, so that it does not conflict with any exiting default node_exporter services running on the machine. During cleanup, the test service is stopped, service file is deleted and test directories are also deleted.

MacOS Specific Notes

The macos-1014 distro, and Macs in general, have the BSD version of tar installed.

Unfortunately, the unarchive ansible module is not compatible with the BSD version of tar.

The GNU version of tar can be installed via brew install gnu-tar, which then installs the executable at /usr/local/bin/tar.

In order to get ansible to use this executable, you have to specify /usr/local/bin first in the $PATH before /usr/bin.

License

Apache License