Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/roles-ansible/ansible_role_ranger
Ansible role to install the ranger file manager on linux
https://github.com/roles-ansible/ansible_role_ranger
ansible ansible-role debian filemanager hacktoberfest ranger role-ansible
Last synced: about 1 month ago
JSON representation
Ansible role to install the ranger file manager on linux
- Host: GitHub
- URL: https://github.com/roles-ansible/ansible_role_ranger
- Owner: roles-ansible
- License: mit
- Created: 2020-01-29T11:41:45.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2024-03-22T10:26:23.000Z (10 months ago)
- Last Synced: 2024-03-22T11:38:22.202Z (10 months ago)
- Topics: ansible, ansible-role, debian, filemanager, hacktoberfest, ranger, role-ansible
- Homepage: https://galaxy.ansible.com/do1jlr/ranger
- Size: 129 KB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
[](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:
- {role: do1jlr.ranger, tags: 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:
- {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:
```bash
ansible-galaxy collection install -r requirements.yml --upgrade
```
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') }}"
```