nekeal.zsh

Rôle Ansible : Zsh

Rôle Ansible qui configure zsh, zinit et quelques outils de shell.

Exigences

Systèmes d'exploitation officiellement pris en charge :

Debian 11
Debian 10
Debian 9
Ubuntu 18
Ubuntu 20

Variables du rôle

Nom	Valeur par défaut	Description
`zsh_version`	5.8	Version de zsh à installer
`zsh_reinstall_from_source`	false	Définit si une réinstallation forcée de zsh doit être effectuée même si la version correspond à l'installation actuelle
`zsh_install_bin_prefix`	/bin	Emplacement du binaire zsh
`zsh_user_config_dir`	.zsh	Emplacement des fichiers de configuration zsh (relatif au répertoire personnel de l'utilisateur)
`zsh_install_zinit`	true	Indique si l'installateur de plugins zinit doit être installé
`zsh_install_templates`	true	Indique si des modèles zsh comme .zshrc doivent être installés
`zsh_zshrc_template`	zshrc-default.zsh.j2	Modèle par défaut utilisé pour le fichier .zshrc
`zsh_aliases_template`	aliases-default.zsh.j2	Modèle par défaut utilisé pour le fichier contenant les définitions d'alias
`zsh_zinit_plugins_template`	zinit-plugins-default.zsh.j2	Modèle par défaut contenant des plugins pour zinit. Il comprend par défaut un sous-ensemble de plugins utiles ainsi que quelques configurations de ohmyzsh
`zshenv_template`	zshenv-default.j2	Modèle par défaut pour le fichier ~/.zshenv
`users`	[]	Contient une liste d'utilisateurs pour lesquels configurer zsh

Exemple de configuration des utilisateurs :

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

Le modèle de zshrc par défaut source quelques fichiers communs trouvés dans ~ et le dossier ~/.zsh, ainsi que chaque modèle supplémentaire. Il prend également en charge par défaut zinit, fzf et powerlevel10k.

Dépendances

Rôles :

nekeal.users - utilise la même liste users que ce rôle. La clé shell doit être définie sur /bin/zsh.

Exemple :

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

Exemple de Playbook

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

Licence

MIT

Informations sur l'auteur

Nekeal

À propos du projet

Ansible role which configures zsh, zinit and some shell tools

role

Installer

ansible-galaxy install nekeal.zsh

GitHub référentiel

3 étoiles

2 forks

1 problèmes ouverts

Licence

mit

Téléchargements

143

Propriétaire

Szymon Cader