gantsign.ctop

Rôle Ansible : ctop

Rôle pour télécharger et installer ctop, l'interface similaire à top pour les métriques des conteneurs. Consultez rapidement l'utilisation du CPU, de la RAM et du réseau pour vos conteneurs Docker depuis votre terminal.

Exigences

Ansible >= 2.9
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 peuvent fonctionner mais n'ont pas été testées.
Docker (déjà installé)

Variables du Rôle

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

# numéro de version de ctop
ctop_version: '0.7.7'

# somme SHA256 pour le redistributable de ctop
ctop_redis_sha256sum: 'b78374734ebe3d14b6edee3d5512c911c250d7fa7f3f964cb00acd3bc5a02a09'

# Répertoire pour stocker les fichiers téléchargés pour ctop
ctop_download_dir: "{{ x_ansible_download_dir | default(ansible_env.HOME + '/.ansible/tmp/downloads') }}"

Exemple de Playbook

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

Complétion Tab pour Zsh

En utilisant Ansible

Nous recommandons d'utiliser le rôle gantsign.antigen pour activer la complétion tab pour ctop (cela doit être configuré pour chaque utilisateur).

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

    - role: gantsign.antigen
      users:
        - username: exemple
          antigen_bundles:
            - name: ctop
              url: gantsign/zsh-plugins
              location: ctop

En utilisant Antigen

Si vous préférez utiliser Antigen directement, ajoutez ce qui suit à votre configuration Antigen :

antigen bundle gantsign/zsh-plugins ctop

Autres Rôles de GantSign

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

Développement & Tests

Ce projet utilise Molecule pour aider au développement et aux tests ; le rôle est testé unitairement avec Testinfra et pytest.

Pour développer ou tester, vous devez avoir installé les éléments suivants :

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

Comme l'installation de ce qui précède peut être difficile, ce projet inclut Molecule Wrapper. Molecule Wrapper est un script shell qui installe Molecule et ses dépendances (à l'exception de Linux) et exécute ensuite Molecule avec la commande que vous lui passez.

Pour tester ce rôle en utilisant Molecule Wrapper, exécutez la commande suivante depuis le répertoire du projet :