gantsign.oh-my-zsh

Aperçu Versions Perspectives

Rôle Ansible : Oh My Zsh

Rôle pour télécharger, installer et configurer Oh-My-Zsh.

:thumbsdown: Avis de dépréciation :thumbsdown:

Ce rôle n'est plus maintenu.

Exigences

Ansible >= 5 (Ansible Core >= 2.12)
Distribution Linux
- Famille Debian
  - Debian
    - Stretch (9)
    - Buster (10)
    - Bullseye (11)
  - Ubuntu
    - Bionic (18.04)
    - Focal (20.04)
- Famille RedHat
  - Rocky Linux
    - 8
  - Fedora
    - 35
- Famille SUSE
  - openSUSE
    - 15.3
- Remarque : d'autres versions sont susceptibles de fonctionner mais n'ont pas été testées.

Variables du rôle

Les variables suivantes modifieront le comportement de ce rôle (les valeurs par défaut sont indiquées ci-dessous) :

# Thème par défaut
oh_my_zsh_theme: robbyrussell

# Plugins par défaut
oh_my_zsh_plugins:
  - git

# Installer par défaut pour tous les utilisateurs spécifiés.
# Peut être remplacé par `oh_my_zsh: install:` sous chaque utilisateur.
oh_my_zsh_install: true

# Mode de mise à jour par défaut pour Oh-My-Zsh
# valeurs acceptées :
# désactivé (par défaut)
# auto
# rappel
oh_my_zsh_update_mode: disabled

# Fréquence de mise à jour par défaut en jours. Lorsque le mode de mise à jour est défini sur une valeur autre que "disabled",
# c'est la fréquence (en jours) pour vérifier une nouvelle version.
# La valeur 0 vérifiera à chaque fois qu'une nouvelle session shell commence.
oh_my_zsh_update_frequency: 13

# Écrire le fichier ~/.zshrc
# Peut être remplacé par `oh_my_zsh: write_zshrc:` sous chaque utilisateur.
oh_my_zsh_write_zshrc: true

# Configuration utilisateur
# Important : oh-my-zsh est installé par utilisateur, donc vous devez spécifier les utilisateurs pour lesquels l'installer.
users:
  - username: example1
    oh_my_zsh:
      theme: robbyrussell
      plugins:
        - git
      update_mode: reminder
      update_frequency: 3
      write_zshrc: false
  - username: example2
    oh_my_zsh:
      theme: robbyrussell
      plugins:
        - git
        - mvn
      update_mode: auto
      update_frequency: 10
  - username: example3
    oh_my_zsh:
      install: false

Exemple de Playbook

- hosts: servers
  roles:
    - role: gantsign.oh-my-zsh
      users:
        - username: example

Autres rôles de GantSign

Vous pouvez trouver d'autres rôles de GantSign sur Ansible Galaxy.

Développement et Test

Ce projet utilise Molecule pour aider au développement et aux tests ; le rôle est testé par unité en utilisant Testinfra et pytest.

Pour développer ou tester, vous aurez besoin d'installer ce qui suit :

Linux (par ex. Ubuntu)
Docker
Python (y compris python-pip)
Ansible
Molecule

Puisque l'installation de tout cela peut être délicate, ce projet comprend Molecule Wrapper. Molecule Wrapper est un script shell qui installe Molecule et ses dépendances (sauf Linux) et exécute ensuite Molecule avec la commande que vous lui passez.

Pour tester ce rôle à l'aide de Molecule Wrapper, exécutez la commande suivante à partir de la racine du projet :