gantsign.antigen_bundles

Descripción general Versiones Perspectivas

Rol de Ansible: Paquetes de Antígeno

Rol de Ansible para agregar paquetes a tu configuración de Antigen para Zsh. Es útil combinar este rol con etiquetas de Ansible para instalar paquetes específicos de manera condicional.

Importante: debes haber instalado Antigen utilizando el rol gantsign.antigen (y configurado Antigen para el mismo usuario) para que este rol funcione.

:thumbsdown: Aviso de Deprecación :thumbsdown:

La última versión de Antigen fue v2.2.3 el 4 de enero de 2018. Dado que Antigen parece ya no estar mantenido, no recomendamos usar este rol. Este rol seguirá siendo mantenido hasta que GantSign migre a un diferente gestor de complementos de Zsh.

Requisitos

Ansible >= 2.9
Distribución de Linux
- Familia Debian
  - Debian
    - Stretch (9)
    - Buster (10)
    - Bullseye (11)
  - Ubuntu
    - Bionic (18.04)
    - Focal (20.04)
- Familia RedHat
  - Rocky Linux
    - 8
  - Fedora
    - 35
- Familia SUSE
  - openSUSE
    - 15.3
- Nota: otras versiones probablemente funcionen, pero no han sido probadas.

Variables del Rol

Las siguientes variables cambiarán el comportamiento de este rol:

# Antigen se configura por usuario, así que debes especificar los usuarios para instalarlo
users:
  - username: # El nombre del usuario para instalar Antigen
    antigen_bundles:
      - name: # El nombre del paquete Antigen (ej. uno de los complementos que vienen con Oh-My-Zsh)
        url: # Opcional. Si no es uno de los complementos de Oh-My-Zsh, debes especificar la URL (usa el formato owner/repo para GitHub)
        location: # Opcional. El directorio en el repositorio que contiene el complemento
        branch: # Opcional. Rama de Git a usar.
        tag: # Opcional. Etiqueta de Git a usar (tiene preferencia sobre la rama)
        args: [] # Opcional. Argumentos de línea de comandos para pasar a Antigen
        env: {} # Opcional. Variables de entorno para establecer
      # más paquetes aquí
  # más usuarios aquí

Ejemplos de Playbooks

Ejemplo mostrando solo la configuración para este rol:

- hosts: servers
  roles:
    - role: gantsign.antigen_bundles
      users:
        - username: example
          antigen_bundles:
            # Paquete del repositorio por defecto (oh-my-zsh de robbyrussell)
            - name: command-not-found
            # Paquete de resaltado de sintaxis
            - name: zsh-syntax-highlighting # `name` es obligatorio (cualquier nombre de archivo válido funcionará siempre que sea único para los paquetes)
              url: zsh-users/zsh-syntax-highlighting

Ejemplo con el rol compañero requerido gantsign.antigen:

- hosts: servers
  roles:
    - role: gantsign.antigen
      users:
        - username: example
          antigen_libraries:
            - name: oh-my-zsh
          antigen_theme:
            name: robbyrussell
          antigen_bundles:
            - name: command-not-found
            - name: docker
            - name: git

    - role: gantsign.antigen_bundles
      tags:
        - java
      users:
        - username: example
          antigen_bundles:
            - name: mvn

En el ejemplo anterior, el paquete/plugin mvn no se instalará si indicas a Ansible que omita tareas con la etiqueta java.

Más Roles de GantSign

Puedes encontrar más roles de GantSign en Ansible Galaxy.

Desarrollo y Pruebas

Este proyecto utiliza Molecule para ayudar en el desarrollo y pruebas; el rol se prueba a nivel unitario utilizando Testinfra y pytest.

Para desarrollar o probar, necesitarás tener instalados los siguientes:

Linux (ej. Ubuntu)
Docker
Python (incluido python-pip)
Ansible
Molecule

Como lo anterior puede ser complicado de instalar, este proyecto incluye Molecule Wrapper. Molecule Wrapper es un script de shell que instala Molecule y sus dependencias (excepto Linux) y ejecuta Molecule con el comando que le pases.

Para probar este rol usando Molecule Wrapper, ejecuta el siguiente comando desde la raíz del proyecto: