{"id":18367835,"url":"https://github.com/gantsign/ansible_role_ctop","last_synced_at":"2025-04-06T17:31:35.116Z","repository":{"id":39652382,"uuid":"146173382","full_name":"gantsign/ansible_role_ctop","owner":"gantsign","description":"Ansible role for installing ctop the top for Docker","archived":false,"fork":false,"pushed_at":"2022-08-03T21:48:47.000Z","size":82,"stargazers_count":6,"open_issues_count":1,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-22T03:51:14.344Z","etag":null,"topics":["ansible","ansible-role"],"latest_commit_sha":null,"homepage":"https://galaxy.ansible.com/gantsign/ctop","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gantsign.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-08-26T11:06:56.000Z","updated_at":"2023-05-09T20:43:14.000Z","dependencies_parsed_at":"2022-08-09T15:08:49.871Z","dependency_job_id":null,"html_url":"https://github.com/gantsign/ansible_role_ctop","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gantsign%2Fansible_role_ctop","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gantsign%2Fansible_role_ctop/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gantsign%2Fansible_role_ctop/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gantsign%2Fansible_role_ctop/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gantsign","download_url":"https://codeload.github.com/gantsign/ansible_role_ctop/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247522298,"owners_count":20952519,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ansible","ansible-role"],"created_at":"2024-11-05T23:23:38.551Z","updated_at":"2025-04-06T17:31:34.432Z","avatar_url":"https://github.com/gantsign.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"Ansible Role: ctop\n==================\n\n[![Tests](https://github.com/gantsign/ansible_role_ctop/workflows/Tests/badge.svg)](https://github.com/gantsign/ansible_role_ctop/actions?query=workflow%3ATests)\n[![Ansible Galaxy](https://img.shields.io/badge/ansible--galaxy-gantsign.ctop-blue.svg)](https://galaxy.ansible.com/gantsign/ctop)\n[![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/gantsign/ansible_role_ctop/master/LICENSE)\n\nRole to download and install [ctop](https://ctop.sh) the top-like interface for\ncontainer metrics. View CPU, RAM and network I/O for your Docker containers at\na glance from your terminal.\n\nRequirements\n------------\n\n* Ansible \u003e= 2.9\n\n* Linux Distribution\n\n    * Debian Family\n\n        * Debian\n\n            * Stretch (9)\n            * Buster (10)\n            * Bullseye (11)\n\n        * Ubuntu\n\n            * Bionic (18.04)\n            * Focal (20.04)\n\n    * RedHat Family\n\n        * Rocky Linux\n\n            * 8\n\n        * Fedora\n\n            * 35\n\n    * SUSE Family\n\n        * openSUSE\n\n            * 15.3\n\n    * Note: other versions are likely to work but have not been tested.\n\n* Docker (already installed)\n\nRole Variables\n--------------\n\nThe following variables will change the behavior of this role (default values\nare shown below):\n\n```yaml\n# ctop version number\nctop_version: '0.7.7'\n\n# SHA256 sum for the ctop redistributable\nctop_redis_sha256sum: 'b78374734ebe3d14b6edee3d5512c911c250d7fa7f3f964cb00acd3bc5a02a09'\n\n# Directory to store files downloaded for ctop\nctop_download_dir: \"{{ x_ansible_download_dir | default(ansible_env.HOME + '/.ansible/tmp/downloads') }}\"\n```\n\nExample Playbook\n----------------\n\n```yaml\n- hosts: servers\n  roles:\n    - role: gantsign.ctop\n```\n\nTab Completion for Zsh\n----------------------\n\n### Using Ansible\n\nWe recommend using the\n[gantsign.antigen](https://galaxy.ansible.com/gantsign/antigen) role to enable\ntab completion for ctop (this must be configured for each user).\n\n```yaml\n- hosts: servers\n  roles:\n    - role: gantsign.ctop\n\n    - role: gantsign.antigen\n      users:\n        - username: example\n          antigen_bundles:\n            - name: ctop\n              url: gantsign/zsh-plugins\n              location: ctop\n```\n\n### Using Antigen\n\nIf you prefer to use [Antigen](https://github.com/zsh-users/antigen) directly\nadd the following to your Antigen configuration:\n\n```bash\nantigen bundle gantsign/zsh-plugins ctop\n```\n\nMore Roles From GantSign\n------------------------\n\nYou can find more roles from GantSign on\n[Ansible Galaxy](https://galaxy.ansible.com/gantsign).\n\nDevelopment \u0026 Testing\n---------------------\n\nThis project uses [Molecule](http://molecule.readthedocs.io/) to aid in the\ndevelopment and testing; the role is unit tested using\n[Testinfra](http://testinfra.readthedocs.io/) and\n[pytest](http://docs.pytest.org/).\n\nTo develop or test you'll need to have installed the following:\n\n* Linux (e.g. [Ubuntu](http://www.ubuntu.com/))\n* [Docker](https://www.docker.com/)\n* [Python](https://www.python.org/) (including python-pip)\n* [Ansible](https://www.ansible.com/)\n* [Molecule](http://molecule.readthedocs.io/)\n\nBecause the above can be tricky to install, this project includes\n[Molecule Wrapper](https://github.com/gantsign/molecule-wrapper). Molecule\nWrapper is a shell script that installs Molecule and it's dependencies (apart\nfrom Linux) and then executes Molecule with the command you pass it.\n\nTo test this role using Molecule Wrapper run the following command from the\nproject root:\n\n```bash\n./moleculew test\n```\n\nNote: some of the dependencies need `sudo` permission to install.\n\nLicense\n-------\n\nMIT\n\nAuthor Information\n------------------\n\nJohn Freeman\n\nGantSign Ltd.\nCompany No. 06109112 (registered in England)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgantsign%2Fansible_role_ctop","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgantsign%2Fansible_role_ctop","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgantsign%2Fansible_role_ctop/lists"}