nekeal.zsh

Rol de Ansible: Zsh

CI

Rol de Ansible que configura zsh, zinit y algunas herramientas de shell.

Requisitos

Sistemas operativos oficialmente soportados:

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

Variables del rol

Nombre Valor por defecto Descripción
zsh_version 5.8 Versión de zsh que se instalará
zsh_reinstall_from_source false Define si se debe forzar la reinstalación de zsh incluso si la versión coincide con la instalación actual
zsh_install_bin_prefix /bin Donde se mantendrá el binario de zsh
zsh_user_config_dir .zsh Donde se mantendrán y cargarán los archivos de configuración de zsh (relativo al directorio home del usuario)
zsh_install_zinit true Si se debe instalar el gestor de plugins zinit
zsh_install_templates true Si se deben instalar plantillas de zsh como .zshrc
zsh_zshrc_template zshrc-default.zsh.j2 Plantilla por defecto utilizada para el archivo .zshrc
zsh_aliases_template aliases-default.zsh.j2 Plantilla por defecto utilizada para el archivo que contiene las definiciones de alias
zsh_zinit_plugins_template zinit-plugins-default.zsh.j2 Plantilla por defecto que contiene los plugins para zinit. Incluye un subconjunto de plugins útiles por defecto, así como algunas configuraciones de ohmyzsh
zshenv_template zshenv-default.j2 Plantilla por defecto para el archivo ~/.zshenv
users [] Contiene la lista de usuarios para los cuales se configurará zsh
  • Ejemplo de configuración de usuarios:

    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
    

La plantilla zshrc por defecto busca algunos archivos comunes encontrados en ~ y en la carpeta ~/.zsh, además de cada plantilla extra. También tiene soporte por defecto para zinit, fzf y powerlevel10k.

Dependencias

Roles:

  • nekeal.users - usa la misma lista users que este rol. La clave shell debe estar configurada como /bin/zsh

Ejemplo:

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

Ejemplo de Playbook

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

Licencia

MIT

Información del autor

Nekeal

Acerca del proyecto

Ansible role which configures zsh, zinit and some shell tools

Instalar
ansible-galaxy install nekeal.zsh
Licencia
mit
Descargas
143
Propietario