gantsign.ctop

Descripción general Versiones Perspectivas

Rol de Ansible: ctop

Rol para descargar e instalar ctop, una interfaz similar a top para métricas de contenedores. Visualiza CPU, RAM y las entradas/salidas de red de tus contenedores de Docker de un vistazo desde tu terminal.

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.
Docker (ya instalado)

Variables de la Rol

Las siguientes variables cambiarán el comportamiento de esta rol (se muestran los valores por defecto a continuación):

# número de versión de ctop
ctop_version: '0.7.7'

# suma SHA256 para el redistribuible de ctop
ctop_redis_sha256sum: 'b78374734ebe3d14b6edee3d5512c911c250d7fa7f3f964cb00acd3bc5a02a09'

# Directorio para almacenar archivos descargados de ctop
ctop_download_dir: "{{ x_ansible_download_dir | default(ansible_env.HOME + '/.ansible/tmp/downloads') }}"

Ejemplo de Playbook

- hosts: servers
  roles:
    - rol: gantsign.ctop

Autocompletado para Zsh

Usando Ansible

Recomendamos usar el rol gantsign.antigen para habilitar el autocompletado para ctop (esto debe ser configurado para cada usuario).

- hosts: servers
  roles:
    - rol: gantsign.ctop

    - rol: gantsign.antigen
      users:
        - username: ejemplo
          antigen_bundles:
            - name: ctop
              url: gantsign/zsh-plugins
              location: ctop

Usando Antigen

Si prefieres usar Antigen directamente, agrega lo siguiente a tu configuración de Antigen:

antigen bundle gantsign/zsh-plugins ctop

Más Roles de GantSign

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

Desarrollo y Pruebas

Este proyecto usa Molecule para ayudar en el desarrollo y las pruebas; la rol es probada unitariamente usando Testinfra y pytest.

Para desarrollar o probar necesitarás tener instalados lo siguiente:

Linux (por ejemplo, Ubuntu)
Docker
Python (incluyendo python-pip)
Ansible
Molecule

Dado que 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 (aparte de Linux) y luego ejecuta Molecule con el comando que le pases.

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