1
0
Fork 0
mirror of https://github.com/roles-ansible/ansible_role_ranger.git synced 2024-08-16 14:19:48 +02:00
Ansible role to install the ranger file manager on linux
Find a file
2021-09-28 01:51:12 +02:00
.github delete cron entry 2021-09-28 01:51:12 +02:00
defaults create variable for build deps 2021-09-28 01:13:31 +02:00
meta update new naming scheme 2021-03-12 23:59:59 +01:00
tasks update apt cache 2021-09-28 01:22:05 +02:00
vars update galaxy and linting 2021-03-12 23:44:16 +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 links again 2021-03-13 00:12:55 +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:
  - do1jlr.ranger

use via git command

clone github repo:

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

example Playbook:

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

test status Github Marketplace
Galaxy release publish-ansible-role-to-galaxy
Yamllint GitHub Actions yamllint-github-action
Ansible Lint check ansible-lint action
Ansible check debian:latest ansible test with debian stable
Ansible check debian:latest ansible test with debian latest
Ansible check debian:sid ansible test with debian sid
Ansible check debian:stable ansible test with debian stable
Ansible check debian:buster ansible test with debian buster
Ansible check archlinux:latest ansible test with archlinux latest
Ansible check ubuntu:latest ansible test with ubuntu latest
Ansible check ubuntu:bionic ansible test with ubuntu bionic
Ansible check ubuntu:trusty ansible test with ubuntu trusty
Ansible check fedora:latest ansible test with fedora latest
Ansible check fedora:33 ansible test with fedora 33
Ansible check fedora:32 ansible test with fedora 32
Ansible check fedora:31 ansible test with fedora 31
Ansible check centos:latest ansible test with centos latest
Ansible check centos:centos8 ansible test with centos centos8
Ansible check centos:centos7 ansible test with centos centos7
Ansible check alpine:latest 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') }}"