nekeal.zsh

Rola Ansible: Zsh

CI

Rola Ansible, która konfiguruje zsh, zinit i niektóre narzędzia powłoki.

Wymagania

Oficjalnie wspierane systemy operacyjne:

  • Debian 11
  • Debian 10
  • Debian 9
  • Ubuntu 18
  • Ubuntu 20

Zmienne roli

Nazwa Wartość domyślna Opis
zsh_version 5.8 Wersja zsh do zainstalowania
zsh_reinstall_from_source false Określa, czy wymusić ponowną instalację zsh, nawet jeśli wersja pasuje do aktualnej instalacji
zsh_install_bin_prefix /bin Gdzie przechowywać plik binarny zsh
zsh_user_config_dir .zsh Gdzie przechowywać i ładować pliki konfiguracyjne zsh (względem katalogu domowego użytkownika)
zsh_install_zinit true Czy zainstalować menedżera wtyczek zinit
zsh_install_templates true Czy zainstalować szablony zsh, takie jak .zshrc
zsh_zshrc_template zshrc-default.zsh.j2 Domyślny szablon używany dla pliku .zshrc
zsh_aliases_template aliases-default.zsh.j2 Domyślny szablon używany dla pliku zawierającego definicje aliasów
zsh_zinit_plugins_template zinit-plugins-default.zsh.j2 Domyślny szablon zawierający wtyczki dla zinit. Domyślnie zawiera podzbiór użytecznych wtyczek oraz niektóre konfiguracje z ohmyzsh
zshenv_template zshenv-default.j2 Domyślny szablon dla pliku ~/.zshenv
users [] Zawiera listę użytkowników, dla których ma zostać skonfigurowany zsh
  • Przykład konfiguracji użytkowników:

    users:
      - username: admin
        shell: /bin/zsh
        aliases:
          aliases:
            l: ls -lart
        zshrc:
          template: zshrc-default.zsh.j2
        env_vars:
          PATH: "$PATH=~/.local/bin:$PATH"
        zsh_config_templates:
          - src: extra-config-template.zsh.j2
            dest: .zsh/config.zsh
    

Domyślny szablon zshrc źródłuje niektóre wspólne pliki znajdujące się w katalogu ~ oraz ~/.zsh, jak również każdy dodatkowy szablon. Posiada także domyślną obsługę zinit, fzf oraz powerlevel10k.

Zależności

Role:

  • nekeal.users - używa tej samej listy users co ta rola. Klucz shell powinien być ustawiony na /bin/zsh.

Przykład:

users:
  - username: admin
    shell: /bin/zsh

Przykład Playbooka

- hosts: servers
  roles:
     - { role: nekeal.zsh }

Licencja

MIT

Informacje o autorze

Nekeal

O projekcie

Ansible role which configures zsh, zinit and some shell tools

Zainstaluj
ansible-galaxy install nekeal.zsh
Licencja
mit
Pobrania
143
Właściciel