Ansible Role Victoriametrics

This Ansible role helps you install and set up the Victoriametrics storage backend.

GitHub	Version	Issues	Pull Requests	Downloads

Example Playbook

Here's a simple example you can use, taken from molecule/default/converge.yml. It’s checked every time there’s a code change.

---
- name: Converge
  hosts: all
  become: true
  vars:
    victoriametrics_version: 1.82.0

  pre_tasks:
    - name: Update apt cache.
      apt: update_cache=yes cache_valid_time=600
      when: ansible_os_family == 'Debian'
      changed_when: false

  roles:
    - role: buluma.victoriametrics

Make sure your system is ready. In CI, this is done using molecule/default/prepare.yml:

---
- name: Prepare
  hosts: all
  become: yes
  gather_facts: no

  roles:
    - role: buluma.bootstrap

You can also check a full guide with examples on using these roles.

Role Variables

Default variable values are listed in defaults/main.yml:

---
proxy_env: {}
victoriametrics_version: "1.57.1"
victoriametrics_web_listen_address: "0.0.0.0"
victoriametrics_web_listen_port: 8428
victoriametrics_binary_install_dir: /usr/local/bin
victoriametrics_system_user: "{{ victoriametrics_user | default('prometheus') }}"
victoriametrics_system_group: "{{ victoriametrics_group | default('prometheus') }}"
victoriametrics_data_dir: /var/lib/victoriametrics
victoriametrics_config_dir: /etc/victoriametrics
victoriametrics_log_level: warn
victoriametrics_log_format: json
victoriametrics_prometheus_config: {}
victoriametrics_limit_nofile: 16384
victoriametrics_config:
  storageDataPath: "{{ victoriametrics_data_dir }}"

Requirements

• Required pip packages are listed in requirements.txt.

Used Roles

The roles listed here help set up your system. You can prepare your system in other ways too.

Requirement	GitHub	Version
buluma.bootstrap

Context

This role works well with many other roles. For more details, check out the documentation for these roles.

Here’s a picture showing related roles:

Compatibility

This role has been tested using these container images:

Ansible version 2.12 or higher is needed. Tests were carried out with:

• The previous version.
• The current version.
• The development version.

If you encounter any issues, please report them on GitHub.

Changelog

You can find the history of changes.

License

This role is licensed under the Apache-2.0 License.

Author Information

The author of this role is Shadow Walker.