Rôle Ansible : oh_my_zsh_p10k

Un rôle Ansible qui installe et configure oh-my-zsh avec le thème powerlevel10k pour des utilisateurs spécifiés. Vous pouvez fournir vos propres fichiers .zshrc et .p10k.zsh ou utiliser ceux fournis.

Exigences

Accès à Internet - si vous exécutez derrière un proxy, envisagez d'utiliser le rôle tomereli.proxy avant celui-ci.

Variables du Rôle

Les variables disponibles sont listées ci-dessous, avec des valeurs par défaut (voir defaults/main.yml) :

# thème par défaut
oh_my_zsh_theme: powerlevel10k

# plugins par défaut
oh_my_zsh_plugins:
    - git
    - zsh-autosuggestions
    - zsh-syntax-highlighting

# modèle .zshrc par défaut ; pointe vers le modèle par défaut livré avec ce rôle
zshrc_src_template: .zshrc.j2

# fichier .p10k.zsh par défaut ; pointe vers le fichier par défaut livré avec ce rôle
p10k_src_file: .p10k.zsh

Dépendances

Aucune, seuls des modules intégrés sont utilisés.

Exemple de Playbook

Le playbook suivant configure oh-my-zsh avec le thème powerlevel10k pour testuser1 et testuser2 :

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

Si vous souhaitez fournir votre propre modèle pour le fichier .zshrc, vous pouvez définir la variable zshrc_src_template pour qu'elle pointe vers votre modèle personnalisé, par exemple stocké sous templates/custom.zshrc.j2 dans votre répertoire de dépôt.
Vous pouvez également fournir votre propre version du fichier .p10k.zsh en définissant la variable p10k_src_file et en stockant votre modèle personnalisé, par exemple à 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

Remarques sur .zshrc :

• Ne pas utiliser .zshrc.j2 comme nom de fichier pour votre modèle personnalisé, car cela sélectionnera le modèle par défaut à la place.
• Si vous ne souhaitez pas utiliser la fonction de modèle, vous pouvez simplement fournir votre .zshrc sans la syntaxe Jinja2 et l'extension de fichier.

Remarques sur p10k.zsh :

• La méthode recommandée est de générer votre propre fichier en exécutant p10k configure sur un système qui a déjà oh-my-zsh avec powerlevel10k installé, puis de copier le fichier généré (trouvé à ~/.p10k.zsh) dans votre répertoire de projet.
• Ne pas utiliser .p10k.zsh comme nom de fichier personnalisé, car cela sélectionnera le modèle par défaut à la place.
• Contrairement au modèle .zshrc.j2, le fichier personnalisé .p10k.zsh sera copié sans modification supplémentaire, c'est-à-dire que la syntaxe Jinja2 n'est pas supportée dans ce fichier.

Licence

MIT / BSD

Informations sur l'auteur

Ce rôle a été créé en 2020 par Tomer Arbel-Eliyahu