mirror of
https://github.com/roles-ansible/ansible_role_ranger.git
synced 2024-08-16 14:19:48 +02:00
107 lines
9.3 KiB
Markdown
107 lines
9.3 KiB
Markdown
[](https://galaxy.ansible.com/do1jlr/ranger) [](https://github.com/roles-ansible/ansible_role_ranger/blob/master/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](https://github.com/ranger/ranger.git).
|
|
|
|
|
|
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](https://github.com/roles-ansible/ansible_role_ranger.git) git repository.
|
|
|
|
### ansible galaxy
|
|
|
|
install role:
|
|
```bash
|
|
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
|
|
```bash
|
|
# example ad-hoc command
|
|
ansible -m include_role -a "name=do1jlr.ranger" localhost
|
|
```
|
|
|
|
Example Ansible-Playbook:
|
|
```yml
|
|
---
|
|
- hosts: localhost
|
|
roles:
|
|
- do1jlr.ranger
|
|
```
|
|
|
|
|
|
### use via git command
|
|
|
|
clone github repo:
|
|
```bash
|
|
git clone https://github.com/roles-ansible/ansible_role_ranger.git
|
|
```
|
|
|
|
example Playbook:
|
|
```yaml
|
|
---
|
|
- hosts: localhost
|
|
roles:
|
|
- ansible_role_ranger
|
|
tags:
|
|
- ranger
|
|
vars:
|
|
submodules_versioncheck: true
|
|
```
|
|
|
|
|
|
## Testing
|
|
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.
|
|
If you want to find out more about our tests, please have a look at the github marketplace.
|
|
|
|
| test status | Github Marketplace |
|
|
| :--------- | :---------------- |
|
|
| [](https://github.com/roles-ansible/ansible_role_ranger/actions/workflows/galaxy.yml) | [publish-ansible-role-to-galaxy](https://github.com/marketplace/actions/publish-ansible-role-to-galaxy) |
|
|
| [](https://github.com/roles-ansible/ansible_role_ranger/actions/workflows/yamllint.yaml) | [yamllint-github-action](https://github.com/marketplace/actions/yamllint-github-action) |
|
|
| [](https://github.com/roles-ansible/ansible_role_ranger/actions/workflows/ansible-linting-check.yml) | [ansible-lint action](https://github.com/marketplace/actions/ansible-lint)
|
|
| [](https://github.com/roles-ansible/ansible_role_ranger/actions/workflows/ansible-debian-latest.yml) | [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/workflows/ansible-debian-sid.yml) | [ansible test with debian sid](https://github.com/marketplace/actions/check-ansible-debian-sid) |
|
|
| [](https://github.com/roles-ansible/ansible_role_ranger/actions/workflows/ansible-debian-stable.yml) | [ansible test with debian stable](https://github.com/marketplace/actions/check-ansible-debian-stable) |
|
|
| [](https://github.com/roles-ansible/ansible_role_ranger/actions/workflows/ansible-debian-buster.yml) | [ansible test with debian buster](https://github.com/marketplace/actions/check-ansible-debian-buster) |
|
|
| | |
|
|
| [](https://github.com/roles-ansible/ansible_role_ranger/actions/workflows/ansible-archlinux-latest.yml) | [ansible test with archlinux latest](https://github.com/marketplace/actions/check-ansible-archlinux-latest) |
|
|
| | |
|
|
| [](https://github.com/roles-ansible/ansible_role_ranger/actions/workflows/ansible-ubuntu-latest.yml) | [ansible test with ubuntu latest](https://github.com/marketplace/actions/check-ansible-ubuntu-latest) |
|
|
| [](https://github.com/roles-ansible/ansible_role_ranger/actions/workflows/ansible-ubuntu-bionic.yml) | [ansible test with ubuntu bionic](https://github.com/marketplace/actions/check-ansible-ubuntu-bionic) |
|
|
| [](https://github.com/roles-ansible/ansible_role_ranger/actions/workflows/ansible-ubuntu-trusty.yml) | [ansible test with ubuntu trusty](https://github.com/marketplace/actions/check-ansible-ubuntu-trusty) |
|
|
| | |
|
|
| [](https://github.com/roles-ansible/ansible_role_ranger/actions/workflows/ansible-fedora-latest.yml) | [ansible test with fedora latest](https://github.com/marketplace/actions/check-ansible-fedora-latest) |
|
|
| [](https://github.com/roles-ansible/ansible_role_ranger/actions/workflows/ansible-fedora-33.yml) | [ansible test with fedora 33](https://github.com/marketplace/actions/check-ansible-fedora-33) |
|
|
| [](https://github.com/roles-ansible/ansible_role_ranger/actions/workflows/ansible-fedora-32.yml) | [ansible test with fedora 32](https://github.com/marketplace/actions/check-ansible-fedora-32) |
|
|
| [](https://github.com/roles-ansible/ansible_role_ranger/actions/workflows/ansible-fedora-31.yml) | [ansible test with fedora 31](https://github.com/marketplace/actions/check-ansible-fedora-31) |
|
|
| | |
|
|
| [](https://github.com/roles-ansible/ansible_role_ranger/actions/workflows/ansible-centos-latest.yml) | [ansible test with centos latest](https://github.com/marketplace/actions/check-ansible-centos-latest) |
|
|
| [](https://github.com/roles-ansible/ansible_role_ranger/actions/workflows/ansible-centos-centos8.yml) | [ansible test with centos centos8](https://github.com/marketplace/actions/check-ansible-centos-centos8) |
|
|
| [](https://github.com/roles-ansible/ansible_role_ranger/actions/workflows/ansible-centos-centos7.yml) | [ansible test with centos centos7](https://github.com/marketplace/actions/check-ansible-centos-centos7) |
|
|
| | |
|
|
| [](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) |
|
|
|
|
|
|
variables
|
|
-------
|
|
```yaml
|
|
# 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') }}"
|
|
```
|