#######################################################################################################

:exclamation: DÉPRÉCIATION :exclamation:

Ce dépôt et le rôle associé sont dépréciés au profit de la Collection Ansible Manala

Vous trouverez des informations sur son utilisation dans le dépôt de la collection

#######################################################################################################

Rôle Ansible : Oh My Zsh

:exclamation: Signalez des problèmes et envoyez des Pull Requests dans le dépôt principal du rôle Ansible :exclamation:

Ce rôle s'occupe de l'installation de Oh My Zsh.

Il fait partie de la pile Ansible Manala mais peut être utilisé comme un composant autonome.

Exigences

Aucune.

Dépendances

Aucune.

Installation

Ansible 2+

Utilisation de la CLI ansible galaxy :

ansible-galaxy install manala.ohmyzsh

Utilisation d'un fichier de exigences ansible galaxy :

- src: manala.ohmyzsh

Gestionnaires de rôle

Aucun

Variables de rôle

Configuration d'Oh My Zsh

La clé manala_ohmyzsh_users_defaults vous permettra de définir différents modèles de configuration par défaut pour les utilisateurs.

manala_ohmyzsh_users_defaults:
  template: my/.zshrc.j2

La clé manala_ohmyzsh_dir est utilisée pour spécifier le chemin où installer oh-my-zsh.

manala_ohmyzsh_dir: /usr/local/share/oh-my-zsh

Configuration des utilisateurs

Cette partie vous permet, avec la clé manala_ohmyzsh_users, de configurer chaque compte utilisateur comme suit :

manala_ohmyzsh_users:
  # Modèle (recommandé)
  - user: root
    template: users/manala/.zshrc.j2
    config:
      ZSH_THEME: default.prod
      plugins: [git, debian, common-aliases, history, history-substring-search]
  # Configuration dictionnaire
  - user: root
    group: foo # Défaut au groupe principal de l'utilisateur, mais peut être remplacé
    config:
      ZSH_THEME: default.prod
      plugins: [git, debian, common-aliases, history, history-substring-search]
  # Configuration brute
  - user: root
    config: |
      # Chemin de votre installation oh-my-zsh.
      export ZSH=$HOME/.oh-my-zsh
  # Paramètres de tableau des dictionnaires (dépréciés) :
  - user: root
    config:
      - ZSH_THEME: default.prod
      - plugins: (git debian common-aliases history history-substring-search)
  - user: bar
    state: ignore # L'entrée sera ignorée
  # Utilisateurs aplatis
  - "{{ my_custom_users_array }}"

Thèmes personnalisés

manala_ohmyzsh_custom_themes_exclusive vous permet de nettoyer les anciens thèmes personnalisés dans le répertoire défini par la clé manala_ohmyzsh_custom_themes_dir. Cela garantit qu'aucun ancien fichier ou fichier créé manuellement n'altérera la configuration actuelle.

manala_ohmyzsh_custom_themes_exclusive: true

manala_ohmyzsh_custom_themes:
  - file: foo.zsh-theme
    config: |
      PROMPT="%{$fg[red]%}%n%{$reset_color%}@%{$fg[blue]%}%m %{$fg[yellow]%}%~ %{$reset_color%}%% "
  # Basé sur le modèle (nom de fichier basé sur le modèle)
  - template: ohmyzsh/custom/template.zsh-theme.j2
  # Basé sur le modèle (nom de fichier forcé)
  - file: bar.zsh-theme
    template: ohmyzsh/custom/template.zsh-theme.j2
  # Assurer l'absence de configuration
  - file: absent.zsh-theme
    state: absent # "present" par défaut
  # Ignorer la configuration
  - file: ignore.zsh-theme
    state: ignore
  # Thèmes aplatis
  - "{{ my_custom_themes_array }}"

Remarque : pour garantir la compatibilité ascendante, ce rôle installera ces modèles de thèmes personnalisés par défaut :

• custom/themes/default.dev.j2
• custom/themes/default.demo.j2
• custom/themes/default.staging.j2
• custom/themes/default.prod.j2

Flags

Permet à Oh My Zsh de récupérer de nouvelles révisions depuis le dépôt

manala_ohmyzsh:
  update: true

# Peut également être défini dans les rôles manala
manala:
  update: true

Exemple de playbook

- hosts: servers
  roles:
    - role: manala.ohmyzsh

Licence

MIT

Informations sur l'auteur

Manala (http://www.manala.io/)