2021-03-13 00:09:37 +01:00
[](https://galaxy.ansible.com/do1jlr/ranger) [](https://github.com/roles-ansible/ansible_role_ranger/blob/master/LICENSE)
2020-02-13 21:15:49 +01:00
2020-03-01 19:37:20 +01:00
2020-10-27 16:54:54 +01:00
ansible_role_ranger
2020-01-29 12:51:25 +01:00
==============
2020-02-13 14:23:18 +01:00
2020-01-29 12:51:25 +01:00
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 ](https://github.com/ranger/ranger.git ).
2020-02-13 14:21:52 +01:00
What does this role do?
-------------
2020-04-13 20:28:31 +02:00
+ 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``
2020-02-13 14:21:52 +01:00
How to use this role
-------------
2020-10-27 16:54:54 +01:00
You can either use this role via ansible galaxy or use it directly from [this ](https://github.com/roles-ansible/ansible_role_ranger.git ) git repository.
2020-02-13 14:21:52 +01:00
### ansible galaxy
2020-02-13 20:09:18 +01:00
2020-04-13 20:28:31 +02:00
install role:
2020-02-13 20:09:18 +01:00
```bash
2020-02-13 14:21:52 +01:00
ansible-galaxy install do1jlr.ranger
```
2020-05-16 21:12:29 +02:00
You can execute the role **directly via ansible ad-hoc command** , but it is highly recomended to create a ansible playbook
```bash
# example ad-hoc command
ansible -m include_role -a "name=do1jlr.ranger" localhost
```
2020-02-13 20:09:18 +01:00
Example Ansible-Playbook:
```yml
---
- hosts: localhost
roles:
- do1jlr.ranger
```
2020-04-13 20:28:31 +02:00
2020-05-16 21:12:29 +02:00
### use via git command
2020-02-13 20:09:18 +01:00
2020-04-13 20:28:31 +02:00
clone github repo:
2020-02-13 20:09:18 +01:00
```bash
2020-10-27 16:54:54 +01:00
git clone https://github.com/roles-ansible/ansible_role_ranger.git
2020-02-13 20:09:18 +01:00
```
2020-04-13 20:28:31 +02:00
example Playbook:
2020-02-13 20:09:18 +01:00
```yaml
---
- hosts: localhost
roles:
2020-10-27 16:54:54 +01:00
- ansible_role_ranger
2020-02-13 20:09:18 +01:00
tags:
- ranger
2020-02-26 13:39:47 +01:00
vars:
submodules_versioncheck: true
2020-02-13 20:09:18 +01:00
```
2021-03-13 00:09:37 +01:00
## Testing
2020-05-16 21:02:51 +02:00
This role is tested with [these github-action ](https://github.com/search?q=topic%3Acheck-ansible+topic%3Agithub-actions+org%3Aroles-ansible&type=Repositories ) tests for different versions of differen linux systems. Linting is tested via travis-ci and the [ansible-lint action ](https://github.com/marketplace/actions/ansible-lint ).
2020-03-04 23:11:10 +01:00
If you want to find out more about our tests, please have a look at the github marketplace.
| test status | Github Marketplace |
| :--------- | :---------------- |
2020-10-27 16:54:54 +01:00
| [](https://travis-ci.com/roles-ansible/ansible_role_ranger) | [.travis.yml ](https://github.com/roles-ansible/ansible_role_ranger/blob/master/.travis.yml ) |
2020-04-13 20:28:31 +02:00
|||
2020-10-27 16:54:54 +01:00
| [](https://github.com/roles-ansible/ansible_role_ranger/actions?query=workflow%3A%22Ansible+Lint+check%22) | [ansible-lint action ](https://github.com/marketplace/actions/ansible-lint )
| [](https://github.com/roles-ansible/ansible_role_ranger/actions?query=workflow%3A%22Ansible+check+debian%3Astable%22) | [ansible test with debian stable ](https://github.com/marketplace/actions/check-ansible-debian-stable ) |
| [](https://github.com/roles-ansible/ansible_role_ranger/actions?query=workflow%3A%22Ansible+check+debian%3Alatest%22) | [ansible test with debian latest ](https://github.com/marketplace/actions/check-ansible-debian-latest ) |
| [](https://github.com/roles-ansible/ansible_role_ranger/actions?query=workflow%3A%22Ansible+check+debian%3Asid%22) | [ansible test with debian sid ](https://github.com/marketplace/actions/check-ansible-debian-sid ) |
| [](https://github.com/roles-ansible/ansible_role_ranger/actions?query=workflow%3A%22Ansible+check+debian%3Abuster%22) | [ansible test with debian buster ](https://github.com/marketplace/actions/check-ansible-debian-buster ) |
| [](https://github.com/roles-ansible/ansible_role_ranger/actions?query=workflow%3A%22Ansible+check+debian%3Astretch%22) | [ansible test with debian stretch ](https://github.com/marketplace/actions/check-ansible-debian-stretch ) |
2020-03-05 21:11:44 +01:00
| | |
2020-10-27 16:54:54 +01:00
| [](https://github.com/roles-ansible/ansible_role_ranger/actions?query=workflow%3A%22Ansible+check+archlinux%3Alatest%22) | [ansible test with archlinux latest ](https://github.com/marketplace/actions/check-ansible-archlinux-latest ) |
2020-04-13 22:38:23 +02:00
| | |
2020-10-27 16:54:54 +01:00
| [](https://github.com/roles-ansible/ansible_role_ranger/actions?query=workflow%3A%22Ansible+check+ubuntu%3Alatest%22) | [ansible test with ubuntu latest ](https://github.com/marketplace/actions/check-ansible-ubuntu-latest ) |
| [](https://github.com/roles-ansible/ansible_role_ranger/actions?query=workflow%3A%22Ansible+check+ubuntu%3Abionic%22) | [ansible test with ubuntu bionic ](https://github.com/marketplace/actions/check-ansible-ubuntu-bionic ) |
| [](https://github.com/roles-ansible/ansible_role_ranger/actions?query=workflow%3A%22Ansible+check+ubuntu%3Aeoan%22) | [ansible test with ubuntu eoan ](https://github.com/marketplace/actions/check-ansible-ubuntu-eoan ) |
| [](https://github.com/roles-ansible/ansible_role_ranger/actions?query=workflow%3A%22Ansible+check+ubuntu%3Atrusty%22) | [ansible test with ubuntu trusty ](https://github.com/marketplace/actions/check-ansible-ubuntu-trusty ) |
| [](https://github.com/roles-ansible/ansible_role_ranger/actions?query=workflow%3A%22Ansible+check+ubuntu%3Axenial%22) | [ansible test with ubuntu xenial ](https://github.com/marketplace/actions/check-ansible-ubuntu-xenial ) |
2020-04-04 15:00:25 +02:00
| | |
2020-10-27 16:54:54 +01:00
| [](https://github.com/roles-ansible/ansible_role_ranger/actions?query=workflow%3A%22Ansible+check+fedora%3Alatest%22) | [ansible test with fedora latest ](https://github.com/marketplace/actions/check-ansible-fedora-latest ) |
| [](https://github.com/roles-ansible/ansible_role_ranger/actions?query=workflow%3A%22Ansible+check+fedora%3A33%22) | [ansible test with fedora 33 ](https://github.com/marketplace/actions/check-ansible-fedora-33 ) |
| [](https://github.com/roles-ansible/ansible_role_ranger/actions?query=workflow%3A%22Ansible+check+fedora%3A32%22) | [ansible test with fedora 32 ](https://github.com/marketplace/actions/check-ansible-fedora-32 ) |
| [](https://github.com/roles-ansible/ansible_role_ranger/actions?query=workflow%3A%22Ansible+check+fedora%3A31%22) | [ansible test with fedora 31 ](https://github.com/marketplace/actions/check-ansible-fedora-31 ) |
2020-04-19 18:01:24 +02:00
| | |
2020-10-27 16:54:54 +01:00
| [](https://github.com/roles-ansible/ansible_role_ranger/actions?query=workflow%3A%22Ansible+check+centos%3Alatest%22) | [ansible test with centos latest ](https://github.com/marketplace/actions/check-ansible-centos-latest ) |
| [](https://github.com/roles-ansible/ansible_role_ranger/actions?query=workflow%3A%22Ansible+check+centos%3Acentos8%22) | [ansible test with centos centos8 ](https://github.com/marketplace/actions/check-ansible-centos-centos8 ) |
| [](https://github.com/roles-ansible/ansible_role_ranger/actions?query=workflow%3A%22Ansible+check+centos%3Acentos7%22) | [ansible test with centos centos7 ](https://github.com/marketplace/actions/check-ansible-centos-centos7 ) |
2020-05-16 21:02:51 +02:00
| | |
2020-10-27 16:54:54 +01:00
| [](https://github.com/roles-ansible/ansible_role_ranger/actions?query=workflow%3A%22Ansible+check+alpine%3Alatest%22) | [ansible test with alpine latest ](https://github.com/marketplace/actions/check-ansible-alpine-latest ) |
2020-03-05 21:11:44 +01:00
2020-03-04 23:27:40 +01:00
variables
-------
```yaml
# perform simple versionscheck (true is recomended)
submodules_versioncheck: false
2020-04-13 22:38:23 +02:00
# parameter for ranger installation
2020-03-04 23:27:40 +01:00
ranger:
repo: 'https://github.com/ranger/ranger.git'
branch: 'master'
2020-03-09 16:59:36 +01:00
download_directory: "{{ x_ansible_download_dir | default(ansible_env.HOME + '/.ansible/tmp/downloads/ranger') }}"
2020-03-04 23:27:40 +01:00
```
