2018-11-18 23:46:40 +01:00
dotfiles
==========
2020-11-13 14:38:52 +01:00
[![MIT License ](https://raw.githubusercontent.com/roles-ansible/ansible_role_dotfiles/master/.github/license.svg?sanitize=true )](https://github.com/roles-ansible/ansible_role_dotfiles/blob/master/LICENSE)
[![Build Status ](https://travis-ci.com/roles-ansible/ansible_role_dotfiles.svg?branch=master )](https://travis-ci.com/roles-ansible/ansible_role_dotfiles)
2020-11-13 14:40:09 +01:00
[![Galaxy ](https://raw.githubusercontent.com/roles-ansible/ansible_role_dotfiles/master/.github/galaxy.svg?sanitize=true )](https://galaxy.ansible.com/do1jlr/dotfiles)
2019-06-11 13:32:22 +02:00
2020-11-13 11:30:51 +01:00
### Get it directly from Ansible Galaxy
2019-06-11 13:32:22 +02:00
```bash
$ ansible-galaxy install do1jlr.dotfiles
```
Function of this role
-----------------------
2018-11-18 23:46:40 +01:00
Ansible role to deploy some dotfiles which may be useful
2018-11-18 00:05:07 +01:00
Affected files:
```ini
/etc/bash.bashrc
2019-01-10 13:32:49 +01:00
~/.bashrc
~/.vimrc
2018-11-18 00:05:07 +01:00
```
2020-11-13 11:30:51 +01:00
our variables:
2018-11-18 23:46:40 +01:00
---------------
2018-11-18 00:05:07 +01:00
```ini
2020-11-13 11:30:51 +01:00
# enable basic version check for this role
# set it to true to use it (recomended)
submodules_versioncheck: false
2019-03-03 23:09:48 +01:00
2020-11-13 11:30:51 +01:00
# for some ansible features we need the python selinux package at fedora
# disable it, if you don't want it
dotfiles__install_python_selinux: true
2018-11-18 00:05:07 +01:00
2020-11-13 11:30:51 +01:00
# modify bashrc
2020-11-13 14:28:57 +01:00
dotfiles__modify_bashrc: true
2020-11-13 11:30:51 +01:00
# list of aliases used in bashrc
2020-11-13 14:28:57 +01:00
dotfiles__aliases:
2020-11-13 11:30:51 +01:00
- { alias: "ls", command: "ls ", color: True }
- { alias: "grep", command: "grep", color: True }
- { alias: "ll", command: "ls -alF", color: False }
- { alias: "la", command: "ls -A", color: False }
- { alias: "l", command: "ls -CF", color: False }
- { alias: "lz", command: "ls -Z", color: False }
- { alias: "EDITOR", command: "/usr/bin/vim", color: False }
- { alias: "VISUAL", command: "/usr/bin/gedit", color: False }
- { alias: "gitsubpull", command: 'git submodule foreach "(git checkout $(git symbolic-ref --short refs/remotes/origin/HEAD | sed "s@^origin/@@"); git pull)"', color: False }
- { alias: "pwgen", command: "/usr/bin/pwgen --num-passwords=3000 --numerals --capitalize --secure --no-vowels --symbols 42 | grep -v '0' | grep -v 'o' | grep -v 'O' | grep -v '\"' | grep -v 'I' | grep -v 'l' | grep -v '1' | grep -v '´ ' | grep -v '@' | tail -1 ", color: false }
# enable bash completion
2020-11-13 14:28:57 +01:00
dotfiles__bash_completion_enabled: true
2020-11-13 11:30:51 +01:00
# fancy promt
2020-11-13 14:28:57 +01:00
dotfiles__user_promt: '\[\033[01;33m\] $(printf "\xE2\x9D\xA4") \[\033[01;32m\]\u\[\033[01;36m\]@\[\033[01;32m\]\H\[\033[01;34m\] < \A> \[\033[01;35m\] \j \[\033[01;36m\] \w \[\033[01;33m\]\n\[\033[01;33m\] $(git branch 2>/dev/null | sed -n "s/* \(.*\)/\1 /p")$\[\033[01;00m\] '
dotfiles__root_prompt: '\[\033[01;31m\] $(printf "\xE2\x9D\xA4") \[\033[01;32m\]\u\[\033[01;36m\]@\[\033[01;32m\]\H\[\033[01;34m\] < \A> \[\033[01;35m\] \j \[\033[01;36m\] \w \[\033[01;33m\]\n\[\033[01;33m\] $(git branch 2>/dev/null | sed -n "s/* \(.*\)/\1 /p")$\[\033[01;00m\] '
2020-11-13 11:30:51 +01:00
# log terminal to syslog
2020-11-13 14:28:57 +01:00
dotfiles__log_to_syslog: true
2020-11-13 11:30:51 +01:00
# modify bash history
history_control: 'ignoreboth'
history_size: '-1'
history_file_size: '-1'
# optional additional entries to bashrc
2020-11-13 14:28:57 +01:00
dotfiles__additional_bashrc_lines: []
2020-11-13 11:30:51 +01:00
# - eval `foo`
# - tmux new-session
# optionally allow custom bashrc for root
2020-11-13 14:28:57 +01:00
dotfiles__allow_own_root_bashrc: false
2020-11-13 11:30:51 +01:00
# otional custom commands
2020-11-13 14:28:57 +01:00
dotfiles__additional_bashrc_lines: []
2020-11-13 11:30:51 +01:00
# - eval `foo`
# - tmux new-session
# optionally allow custom bashrc for root
2020-11-13 14:28:57 +01:00
dotfiles__allow_own_root_bashrc: false
2020-11-13 11:30:51 +01:00
# otional custom commands
2020-11-13 14:28:57 +01:00
dotfiles__custom_config: []
2020-11-13 11:30:51 +01:00
# - { user: "l3d", cmd: "eval $(keychain --eval --quiet id_ed25519)"
# show hidden files in ranger
2020-11-13 14:28:57 +01:00
dotfiles__ranger_hidden_files: true
2020-11-13 11:30:51 +01:00
accounts:
- "{{ ansible_user_id }}"
2018-11-18 23:46:40 +01:00
```
2019-02-01 15:27:32 +01:00
Please have a look into ``defaults/main.yml`` for more configuration options!
2020-11-13 14:28:57 +01:00
### 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. Linting is tested via travis-ci and the [ansible-lint action ](https://github.com/marketplace/actions/ansible-lint ).
If you want to find out more about our tests, please have a look at the github marketplace.
| test status | Github Marketplace |
| :--------- | :---------------- |
| [![Travis Build Status ](https://travis-ci.com/roles-ansible/ansible_role_dotfiles.svg?branch=master )](https://travis-ci.com/roles-ansible/ansible_role_dotfiles) | [.travis.yml ](https://github.com/roles-ansible/ansible_role_dotfiles/blob/master/.travis.yml ) |
|||
| [![Ansible Lint check ](https://github.com/roles-ansible/ansible_role_dotfiles/workflows/Ansible%20Lint%20check/badge.svg )](https://github.com/roles-ansible/ansible_role_dotfiles/actions?query=workflow%3A%22Ansible+Lint+check%22) | [ansible-lint action ](https://github.com/marketplace/actions/ansible-lint )
| [![Ansible check debian:stable ](https://github.com/roles-ansible/ansible_role_dotfiles/workflows/Ansible%20check%20debian:stable/badge.svg )](https://github.com/roles-ansible/ansible_role_dotfiles/actions?query=workflow%3A%22Ansible+check+debian%3Astable%22) | [ansible test with debian stable ](https://github.com/marketplace/actions/check-ansible-debian-stable ) |
| [![Ansible check debian:latest ](https://github.com/roles-ansible/ansible_role_dotfiles/workflows/Ansible%20check%20debian:latest/badge.svg )](https://github.com/roles-ansible/ansible_role_dotfiles/actions?query=workflow%3A%22Ansible+check+debian%3Alatest%22) | [ansible test with debian latest ](https://github.com/marketplace/actions/check-ansible-debian-latest ) |
| [![Ansible check debian:sid ](https://github.com/roles-ansible/ansible_role_dotfiles/workflows/Ansible%20check%20debian:sid/badge.svg )](https://github.com/roles-ansible/ansible_role_dotfiles/actions?query=workflow%3A%22Ansible+check+debian%3Asid%22) | [ansible test with debian sid ](https://github.com/marketplace/actions/check-ansible-debian-sid ) |
| [![Ansible check debian:buster ](https://github.com/roles-ansible/ansible_role_dotfiles/workflows/Ansible%20check%20debian:buster/badge.svg )](https://github.com/roles-ansible/ansible_role_dotfiles/actions?query=workflow%3A%22Ansible+check+debian%3Abuster%22) | [ansible test with debian buster ](https://github.com/marketplace/actions/check-ansible-debian-buster ) |
| [![Ansible check debian:stretch ](https://github.com/roles-ansible/ansible_role_dotfiles/workflows/Ansible%20check%20debian:stretch/badge.svg )](https://github.com/roles-ansible/ansible_role_dotfiles/actions?query=workflow%3A%22Ansible+check+debian%3Astretch%22) | [ansible test with debian stretch ](https://github.com/marketplace/actions/check-ansible-debian-stretch ) |
| | |
| [![Ansible check archlinux:latest ](https://github.com/roles-ansible/ansible_role_dotfiles/workflows/Ansible%20check%20archlinux:latest/badge.svg )](https://github.com/roles-ansible/ansible_role_dotfiles/actions?query=workflow%3A%22Ansible+check+archlinux%3Alatest%22) | [ansible test with archlinux latest ](https://github.com/marketplace/actions/check-ansible-archlinux-latest ) |
| | |
| [![Ansible check ubuntu:latest ](https://github.com/roles-ansible/ansible_role_dotfiles/workflows/Ansible%20check%20ubuntu:latest/badge.svg )](https://github.com/roles-ansible/ansible_role_dotfiles/actions?query=workflow%3A%22Ansible+check+ubuntu%3Alatest%22) | [ansible test with ubuntu latest ](https://github.com/marketplace/actions/check-ansible-ubuntu-latest ) |
| [![Ansible check ubuntu:bionic ](https://github.com/roles-ansible/ansible_role_dotfiles/workflows/Ansible%20check%20ubuntu:bionic/badge.svg )](https://github.com/roles-ansible/ansible_role_dotfiles/actions?query=workflow%3A%22Ansible+check+ubuntu%3Abionic%22) | [ansible test with ubuntu bionic ](https://github.com/marketplace/actions/check-ansible-ubuntu-bionic ) |
| [![Ansible check ubuntu:eoan ](https://github.com/roles-ansible/ansible_role_dotfiles/workflows/Ansible%20check%20ubuntu:eoan/badge.svg )](https://github.com/roles-ansible/ansible_role_dotfiles/actions?query=workflow%3A%22Ansible+check+ubuntu%3Aeoan%22) | [ansible test with ubuntu eoan ](https://github.com/marketplace/actions/check-ansible-ubuntu-eoan ) |
| [![Ansible check ubuntu:trusty ](https://github.com/roles-ansible/ansible_role_dotfiles/workflows/Ansible%20check%20ubuntu:trusty/badge.svg )](https://github.com/roles-ansible/ansible_role_dotfiles/actions?query=workflow%3A%22Ansible+check+ubuntu%3Atrusty%22) | [ansible test with ubuntu trusty ](https://github.com/marketplace/actions/check-ansible-ubuntu-trusty ) |
| [![Ansible check ubuntu:xenial ](https://github.com/roles-ansible/ansible_role_dotfiles/workflows/Ansible%20check%20ubuntu:xenial/badge.svg )](https://github.com/roles-ansible/ansible_role_dotfiles/actions?query=workflow%3A%22Ansible+check+ubuntu%3Axenial%22) | [ansible test with ubuntu xenial ](https://github.com/marketplace/actions/check-ansible-ubuntu-xenial ) |
| | |
| [![Ansible check fedora:latest ](https://github.com/roles-ansible/ansible_role_dotfiles/workflows/Ansible%20check%20fedora:latest/badge.svg )](https://github.com/roles-ansible/ansible_role_dotfiles/actions?query=workflow%3A%22Ansible+check+fedora%3Alatest%22) | [ansible test with fedora latest ](https://github.com/marketplace/actions/check-ansible-fedora-latest ) |
| [![Ansible check fedora:33 ](https://github.com/roles-ansible/ansible_role_dotfiles/workflows/Ansible%20check%20fedora:33/badge.svg )](https://github.com/roles-ansible/ansible_role_dotfiles/actions?query=workflow%3A%22Ansible+check+fedora%3A33%22) | [ansible test with fedora 33 ](https://github.com/marketplace/actions/check-ansible-fedora-33 ) |
| [![Ansible check fedora:32 ](https://github.com/roles-ansible/ansible_role_dotfiles/workflows/Ansible%20check%20fedora:32/badge.svg )](https://github.com/roles-ansible/ansible_role_dotfiles/actions?query=workflow%3A%22Ansible+check+fedora%3A32%22) | [ansible test with fedora 32 ](https://github.com/marketplace/actions/check-ansible-fedora-32 ) |
| [![Ansible check fedora:31 ](https://github.com/roles-ansible/ansible_role_dotfiles/workflows/Ansible%20check%20fedora:31/badge.svg )](https://github.com/roles-ansible/ansible_role_dotfiles/actions?query=workflow%3A%22Ansible+check+fedora%3A31%22) | [ansible test with fedora 31 ](https://github.com/marketplace/actions/check-ansible-fedora-31 ) |
| | |
| [![Ansible check centos:latest ](https://github.com/roles-ansible/ansible_role_dotfiles/workflows/Ansible%20check%20centos:latest/badge.svg )](https://github.com/roles-ansible/ansible_role_dotfiles/actions?query=workflow%3A%22Ansible+check+centos%3Alatest%22) | [ansible test with centos latest ](https://github.com/marketplace/actions/check-ansible-centos-latest ) |
| [![Ansible check centos:centos8 ](https://github.com/roles-ansible/ansible_role_dotfiles/workflows/Ansible%20check%20centos:centos8/badge.svg )](https://github.com/roles-ansible/ansible_role_dotfiles/actions?query=workflow%3A%22Ansible+check+centos%3Acentos8%22) | [ansible test with centos centos8 ](https://github.com/marketplace/actions/check-ansible-centos-centos8 ) |
| [![Ansible check centos:centos7 ](https://github.com/roles-ansible/ansible_role_dotfiles/workflows/Ansible%20check%20centos:centos7/badge.svg )](https://github.com/roles-ansible/ansible_role_dotfiles/actions?query=workflow%3A%22Ansible+check+centos%3Acentos7%22) | [ansible test with centos centos7 ](https://github.com/marketplace/actions/check-ansible-centos-centos7 ) |