Ansible 角色: Oh My Zsh

该角色用于下载、安装和配置 Oh-My-Zsh。

:thumbsdown: 停止维护通知 :thumbsdown:

此角色不再维护。

要求

• Ansible >= 5 (Ansible 核心 >= 2.12)

• Linux发行版

  • Debian系列

    • Debian

      • Stretch (9)
      • Buster (10)
      • Bullseye (11)

    • Ubuntu

      • Bionic (18.04)
      • Focal (20.04)

  • RedHat系列

    • Rocky Linux

      • 8

    • Fedora

      • 35

  • SUSE系列

    • openSUSE

      • 15.3

  • 注意: 其他版本可能也可运行，但未经过测试。

角色变量

以下变量会改变该角色的行为（默认值如下）：

# 默认主题
oh_my_zsh_theme: robbyrussell

# 默认插件
oh_my_zsh_plugins:
  - git

# 是否默认为所有指定用户安装。
# 可以通过每个用户下的 `oh_my_zsh: install:` 重写。
oh_my_zsh_install: true

# Oh-My-Zsh的默认更新模式
# 可接受的值：
# disabled (默认)
# auto
# reminder
oh_my_zsh_update_mode: disabled

# 默认更新频率（单位：天）。当更新模式设置为“disabled”以外的值时，
# 这是检查新版本的频率（单位：天）。
# 值为0将会在每次新shell会话启动时检查。
oh_my_zsh_update_frequency: 13

# 是否写入 ~/.zshrc 文件
# 可以通过每个用户下的 `oh_my_zsh: write_zshrc:` 重写。
oh_my_zsh_write_zshrc: true

# 用户配置
# 重要：oh-my-zsh是按用户安装的，因此需要指定要为其安装的用户。
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

示例剧本

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

更多来自GantSign的角色

您可以在 Ansible Galaxy 上找到更多来自GantSign的角色。

开发与测试

该项目使用 Molecule 来辅助开发和测试；该角色使用 Testinfra 和 pytest 进行单元测试。

要进行开发或测试，您需要安装以下内容：

• Linux（例如 Ubuntu）
• Docker
• Python（包括 python-pip）
• Ansible
• Molecule

由于上述内容的安装可能比较复杂，因此该项目包括了 Molecule Wrapper。Molecule Wrapper 是一个 shell 脚本，用于安装 Molecule 及其依赖项（Linux 除外），然后执行您传递的命令。

要使用Molecule Wrapper测试此角色，请从项目根目录运行以下命令：

./moleculew test

注意：某些依赖项需要 sudo 权限进行安装。

许可证

MIT

作者信息

John Freeman

GantSign Ltd. 公司编号：06109112（在英格兰注册）