1
0
Fork 0
mirror of https://github.com/roles-ansible/ansible_role_ranger.git synced 2024-07-06 22:18:52 +02:00
Ansible role to install the ranger file manager on linux
Go to file
2024-03-22 11:26:22 +01:00
.github Merge pull request #21 from roles-ansible/dependabot/github_actions/ansible-actions/ansible-lint-action-1.0.3 2024-03-22 11:26:22 +01:00
defaults create variable for build deps 2021-09-28 01:13:31 +02:00
meta Cleanup ranger install 2023-10-29 15:09:27 +01:00
tasks Cleanup ranger install 2023-10-29 15:09:27 +01:00
vars Cleanup ranger install 2023-10-29 15:09:27 +01:00
.gitignore delete cron entry 2021-09-28 01:51:12 +02:00
.yamllint update galaxy and linting 2021-03-12 23:44:16 +01:00
LICENSE initialize git repository 2020-01-29 12:55:33 +01:00
README.md Update README.md 2023-10-29 15:21:59 +01:00
requirements.yml Cleanup ranger install 2023-10-29 15:09:27 +01:00

Ansible Galaxy MIT License

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:
    - {role: do1jlr.ranger, tags: ranger}

use via git command

clone github repo:

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

example Playbook:

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

Requirements

The community.general collection is required for some parts of this ansible role. You can install it with this command:

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

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