ansible_role_ranger

Ansible role to install the ranger file manager on linux. ranger is a console file manager with VI key bindings. More info about ranger is available at github.com/ranger/ranger.

What does this role do?

• This role try to install ranger with the default package manager.
• If this fails, this role will download the ranger git and compile it by ourself (with python 3).
• We also could perform a simple versioncheck that will check if a newer version of this role has been executed on this host before.
  • You can enable it by setting submodules_versioncheck to true

How to use this role

You can either use this role via ansible galaxy or use it directly from this git repository.

ansible galaxy

install role:

ansible-galaxy install do1jlr.ranger

You can execute the role directly via ansible ad-hoc command, but it is highly recomended to create a ansible playbook

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

Example Ansible-Playbook:

---
- hosts: localhost
  roles:
  - do1jlr.ranger

use via git command

clone github repo:

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

example Playbook:

---
- hosts: localhost
  roles:
    - ansible_role_ranger
  tags:
   - ranger
  vars:
    submodules_versioncheck: true

Testing

This role is tested with these github-action tests for different versions of differen linux systems. If you want to find out more about our tests, please have a look at the github marketplace.

test status	Github Marketplace
	publish-ansible-role-to-galaxy
	yamllint-github-action
	ansible-lint action
	ansible test with debian stable
	ansible test with debian latest
	ansible test with debian sid
	ansible test with debian stable
	ansible test with debian buster
	ansible test with archlinux latest
	ansible test with ubuntu latest
	ansible test with ubuntu bionic
	ansible test with ubuntu trusty
	ansible test with fedora latest
	ansible test with fedora 33
	ansible test with fedora 32
	ansible test with fedora 31
	ansible test with centos latest
	ansible test with centos centos8
	ansible test with centos centos7
	ansible test with alpine latest

variables

# perform simple versionscheck (true is recomended)
submodules_versioncheck: false

# parameter 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') }}"