Rol de Ansible: oh_my_zsh_p10k

Una rol de Ansible que instala y configura oh-my-zsh con el tema powerlevel10k para usuarios específicos. Puedes proporcionar tus propios archivos .zshrc y .p10k.zsh o usar los que se proporcionan.

Requisitos

Acceso a Internet - si estás detrás de un proxy, considera usar el rol tomereli.proxy antes de este.

Variables del Rol

Las variables disponibles se enumeran a continuación, junto con los valores predeterminados (ver defaults/main.yml):

# tema predeterminado
oh_my_zsh_theme: powerlevel10k

# plugins predeterminados
oh_my_zsh_plugins:
    - git
    - zsh-autosuggestions
    - zsh-syntax-highlighting

# plantilla .zshrc predeterminada; apunta a la plantilla predeterminada entregada con este rol
zshrc_src_template: .zshrc.j2

# archivo .p10k.zsh predeterminado; apunta al archivo predeterminado entregado con este rol
p10k_src_file: .p10k.zsh

Dependencias

Ninguna, solo se utilizan módulos integrados.

Ejemplo de Playbook

El siguiente playbook configura oh-my-zsh con el tema powerlevel10k para testuser1 y testuser2:

- hosts: all
  roles:
    - role: tomereli.oh_my_zsh_p10k
      vars:
        users:
            - username: testuser1
            - username: testuser2

Si quieres proporcionar tu propia plantilla para el archivo .zshrc, puedes establecer la variable zshrc_src_template para que apunte a tu plantilla personalizada, por ejemplo, almacenada bajo templates/custom.zshrc.j2 en el directorio de tu repositorio.
También puedes proporcionar tu propia versión del .p10k.zsh configurando la variable p10k_src_file y guardar tu plantilla personalizada en, por ejemplo, files/custom.p10k.zsh.

- hosts: all
  roles:
    - role: tomereli.oh_my_zsh_p10k
      vars:
        users:
            - username: testuser1
        zshrc_src_template: custom.zshrc.j2
        p10k_src_file: custom.p10k.zsh

Notas sobre .zshrc:

• No uses .zshrc.j2 como el nombre de tu plantilla personalizada, ya que solo seleccionará la plantilla predeterminada.
• Si no deseas usar la función de plantilla, también puedes proporcionar tu .zshrc sin la sintaxis de Jinja2 y sin extensión de archivo.

Notas sobre p10k.zsh:

• El enfoque recomendado es generar tu propio archivo ejecutando p10k configure en un sistema que ya tenga oh-my-zsh con powerlevel10k instalado, luego copia el archivo generado (que se encuentra en ~/.p10k.zsh) en tu directorio de proyecto.
• No uses .p10k.zsh como el nombre de tu archivo personalizado, ya que solo seleccionará la plantilla predeterminada.
• A diferencia de la plantilla .zshrc.j2, el archivo personalizado .p10k.zsh se copiará sin modificaciones adicionales, es decir, la sintaxis de Jinja2 no es compatible en este archivo.

Licencia

MIT / BSD

Información del Autor

Este rol fue creado en 2020 por Tomer Arbel-Eliyahu