Wavefront Ansible Role Integration
Ansible is an open-source automation engine that automates software provisioning, configuration management, and application deployment. The Wavefront Ansible role installs and configures the Wavefront proxy (wavefront-proxy
) or collector (telegraf
) agent, which allows you to automate Wavefront proxy and Telegraf collector agent installation on multiple hosts.
Wavefront Ansible Role Setup
Step 1. Install Wavefront Ansible Role Using Ansible Galaxy
ansible-galaxy install wavefrontHQ.wavefront-ansible
To install into your playbook roles
, use -p ROLES_PATH
or --path=ROLES_PATH
:
ansible-galaxy install wavefrontHQ.wavefront-ansible -p /your/project/root/roles
See Installing multiple roles from a file.
Note
ansible-galaxy install <role> -p <path>
returns an error if using the ansible-galaxy
in Python 3.x.
Error: Failed to get data from the API server - a bytes-like object is required, not 'str'
To resolve the above issue, make sure you use ansible-galaxy
in Python 2.x. For more info, see: http://stackoverflow.com/questions/41837789/ansible-galaxy-failing-for-init-install-failed-to-get-data-from-the-api-server.
Step 2. Create Basic Playbook
Create a sample playbook (yml) file like the one shown below named wavefront-ansible.yml
:
---
- hosts: all
gather_facts: true
remote_user: root
become: true
roles:
- { role: wavefrontHQ.wavefront-ansible, wavefront_install_collector: "true" }
Step 3. Run Playbook
- Go to the folder containing the
wavefront-ansible.yml
file. -
To install Wavefront proxy (
wavefront-proxy
) on your local machine, run:- RedHat/CentOS:
ansible-playbook -i "`hostname`," --connection=local wavefront-ansible.yml \ --extra-vars "wavefront_install_proxy=true wavefront_api_token=YOUR_API_TOKEN proxy_address=localhost \ wavefront_url="https://YOUR_CLUSTER.wavefront.com" \ --tags "redhat"
- Debian/Ubuntu:
ansible-playbook -i "`hostname`," --connection=local wavefront-ansible.yml \ --extra-vars "wavefront_install_proxy=true wavefront_api_token=YOUR_API_TOKEN proxy_address=localhost \ wavefront_url="https://YOUR_CLUSTER.wavefront.com" \ --tags "debian"
- RedHat/CentOS:
Refer to Wavefront Ansible Role for variables, tags, and other details.