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

Example Ansible-Playbook:

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

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

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

use directly

clone github repo:

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

example Playbook:

---
- hosts: localhost
  roles:
    - 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. Linting is tested via travis-ci. If you want to find out more about our tests, please have a look at the github marketplace.

test status	Github Marketplace
	.travis.yml
	ansible-lint action
	ansible test with debian stable
	ansible test with debian latest
	ansible test with debian sid
	ansible test with debian buster
	ansible test with debian jessie
	ansible test with debian stretch
	ansible test with archlinux latest
	ansible test with ubuntu latest
	ansible test with ubuntu bionic
	ansible test with ubuntu disco
	ansible test with ubuntu eoan
	ansible test with ubuntu trusty
	ansible test with ubuntu xenial
	ansible test with fedora latest
	ansible test with fedora 33
	ansible test with fedora 32
	ansible test with fedora 31
	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') }}"