ansible_role_ranger

This Ansible role installs the Ranger file manager on Linux. Ranger is a console-based file manager that uses VI key controls. You can find more information about Ranger at github.com/ranger/ranger.

What does this role do?

• This role attempts to install ranger using the default package manager.
• If that fails, it will download Ranger from Git and compile it itself (using Python 3).
• You can also enable a version check to see if a newer version of this role has been run on the host before by setting submodules_versioncheck to true.

How to use this role

You can use this role from Ansible Galaxy or directly from the GitHub repository.

Using Ansible Galaxy

To install the role:

ansible-galaxy install do1jlr.ranger

You can run the role using an Ansible ad-hoc command, but it's recommended to create an Ansible playbook instead:

# Example ad-hoc command
ansible -m include_role -a "name=do1jlr.ranger" localhost

Example Ansible Playbook

---
- hosts: localhost
  roles:
    - {role: do1jlr.ranger, tags: ranger}

Using the Git Command

To clone the GitHub repository:

git clone https://github.com/roles-ansible/ansible_role_ranger.git

Example Playbook

---
- hosts: localhost
  roles:
    - {role: ansible_role_ranger, tags: ranger}

Requirements

You need the community.general collection for some parts of this Ansible role. You can install it with:

ansible-galaxy collection install -r requirements.yml --upgrade

Variables

# Enable simple version check (true is recommended)
submodules_versioncheck: false

# Parameters for Ranger installation
ranger:
  repo: 'https://github.com/ranger/ranger.git'
  branch: 'master'
  download_directory: "{{ x_ansible_download_dir | default(ansible_env.HOME + '/.ansible/tmp/downloads/ranger') }}"