{"id":30160302,"url":"https://github.com/sinetris/ansible-tools-collection","last_synced_at":"2026-02-19T04:31:50.579Z","repository":{"id":308171975,"uuid":"1031312939","full_name":"sinetris/ansible-tools-collection","owner":"sinetris","description":"Ansible Collection to manage basic infrastructure components","archived":false,"fork":false,"pushed_at":"2026-02-02T16:36:21.000Z","size":149,"stargazers_count":0,"open_issues_count":5,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-03T05:52:11.758Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sinetris.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":"MAINTAINERS","copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-03T13:32:47.000Z","updated_at":"2025-10-22T09:44:39.000Z","dependencies_parsed_at":"2025-09-12T19:24:03.443Z","dependency_job_id":"91366d79-ec28-467a-952f-f38d71a69d20","html_url":"https://github.com/sinetris/ansible-tools-collection","commit_stats":null,"previous_names":["sinetris/ansible-tools-collection"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/sinetris/ansible-tools-collection","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sinetris%2Fansible-tools-collection","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sinetris%2Fansible-tools-collection/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sinetris%2Fansible-tools-collection/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sinetris%2Fansible-tools-collection/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sinetris","download_url":"https://codeload.github.com/sinetris/ansible-tools-collection/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sinetris%2Fansible-tools-collection/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29603068,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-19T04:01:40.476Z","status":"ssl_error","status_checked_at":"2026-02-19T04:01:12.960Z","response_time":117,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":[],"created_at":"2025-08-11T15:39:00.719Z","updated_at":"2026-02-19T04:31:50.562Z","avatar_url":"https://github.com/sinetris.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Sinetris Tools Collection\n\nThis repository contains the `sinetris.tools` Ansible Collection.\n\n- [Ansible version compatibility](#ansible-version-compatibility)\n- [External requirements](#external-requirements)\n- [Included content](#included-content)\n- [Using this collection](#using-this-collection)\n- [Release notes](#release-notes)\n- [Roadmap](#roadmap)\n- [Development](#development)\n  - [Requirements](#requirements)\n    - [Use a Dev Container](#use-a-dev-container)\n      - [Install Colima on Mac](#install-colima-on-mac)\n    - [Local OS](#local-os)\n  - [Run tests](#run-tests)\n  - [Propose Changes](#propose-changes)\n    - [Steps example](#steps-example)\n  - [Create a new release](#create-a-new-release)\n    - [Create the new release changelogs](#create-the-new-release-changelogs)\n    - [Generate documentation](#generate-documentation)\n- [More information](#more-information)\n- [Licensing](#licensing)\n\n\u003c!--start requires_ansible--\u003e\n## Ansible version compatibility\n\nThis collection has been tested against the following Ansible versions: **\u003e=2.16.0**.\n\nPlugins and modules within a collection may be tested with only specific Ansible versions.\nA collection may contain metadata that identifies these versions.\nPEP440 is the schema used to describe the versions of Ansible.\n\u003c!--end requires_ansible--\u003e\n\n## External requirements\n\nSome modules and plugins require external libraries. Please check the\nrequirements for each plugin or module you use in the documentation to find out\nwhich requirements are needed.\n\n## Included content\n\n\u003c!--start collection content--\u003e\n\u003c!--end collection content--\u003e\n\n## Using this collection\n\n```bash\nansible-galaxy collection install sinetris.tools\n```\n\nYou can also include it in a `requirements.yml` file and install it via\n`ansible-galaxy collection install -r requirements.yml` using the format:\n\n```yaml\ncollections:\n  - name: sinetris.tools\n```\n\nTo upgrade the collection to the latest available version, run the following\ncommand:\n\n```bash\nansible-galaxy collection install sinetris.tools --upgrade\n```\n\nYou can also install a specific version of the collection, for example, if you\nneed to downgrade when something is broken in the latest version (please report\nan issue in this repository). Use the following syntax where `X.Y.Z` can be any\n[available version](https://galaxy.ansible.com/sinetris/tools):\n\n```bash\nansible-galaxy collection install sinetris.tools:==X.Y.Z\n```\n\nSee\n[Ansible Using Collections](https://docs.ansible.com/ansible/latest/user_guide/collections_using.html)\nfor more details.\n\n## Release notes\n\nSee the\n[changelog](https://github.com/sinetris/ansible-tools-collection/tree/main/CHANGELOG.md).\n\n## Roadmap\n\n\u003c!--\n  Optional. Include the roadmap for this collection, and the proposed release/versioning\n  strategy so users can anticipate the upgrade/update cycle.\n--\u003e\n\n## Development\n\n### Requirements\n\n#### Use a Dev Container\n\nTo simplify development, this project includes a [devcontainer.json] file that\ntakes care of installing all dependencies in a container, allowing you to use the\n[Visual Studio Code Dev Containers][vs-code-devcontainers] extension.\n\nRequirements:\n\n- [Docker][docker-setup]\n\n\u003e **NOTE:** If you are on macOS, is more convenient to install Docker in [Colima](#install-colima-on-mac).\n\u003e instead of using [Docker Desktop for Mac][docker-mac].\n\n##### Install Colima on Mac\n\nTo use Docker in [Colima][colima] on macOS, you also need to install the related docker client CLIs.\n\n```sh\nbrew install docker docker-compose docker-buildx\nbrew install colima\nmkdir -p ~/.docker\ncat \u003e ~/.docker/config.json \u003c\u003c'EOF'\n\t{\n\t  \"auths\": {},\n\t  \"currentContext\": \"colima\",\n\t  \"cliPluginsExtraDirs\": [\n\t    \"/opt/homebrew/lib/docker/cli-plugins\"\n\t  ]\n\t}\nEOF\n```\n\nTh default machine started by colima use 2 CPUs an 2GB of RAM.\n\n```terminal\n$ colima list\nPROFILE    STATUS     ARCH       CPUS    MEMORY    DISK      RUNTIME    ADDRESS\ndefault    Running    aarch64    2       2GiB      100GiB    docker\n```\n\nTo change the machine resources used, stop the image and restart it with different amount of CPUs\nand RAM (if you want to assign an IP to the machine, add `--network-address`).\n\n```sh\ncolima stop\ncolima start --cpu 4 --memory 8 --network-address\n```\n\nCheck if the changes have been applied.\n\n```terminal\n$ colima list\nPROFILE    STATUS     ARCH       CPUS    MEMORY    DISK      RUNTIME    ADDRESS\ndefault    Running    aarch64    4       8GiB      100GiB    docker     192.168.106.13\n```\n\n#### Local OS\n\n\u003e **Note:** To develop Ansible collections, the collection must be in a directory under\n\u003e `ansible_collections/\u003cnamespace\u003e/\u003cname\u003e`.\n\u003e\n\u003e For example, this project must be in `ansible_collections/sinetris/tools`.\n\nRequirements:\n\n- git\n- Python 3 (installed using `pyenv`)\n- [pyenv](https://github.com/pyenv/pyenv)\n\n```sh\n# Clone the repository in a valid directory\nMY_COLLECTIONS_PATH=${HOME}/projects/ansible_collections\nmkdir -v -p \"${MY_COLLECTIONS_PATH:?}\"/sinetris\ncd \"${MY_COLLECTIONS_PATH}\"/sinetris\ngit clone git@github.com:sinetris/ansible-tools-collection.git tools\ncd tools\n\n# Install Python 3 using pyenv\npyenv install\n\n# Ensure we are using pyenv\npyenv version\n# should show something like: 3.12.6 (set by PYENV_VERSION environment variable)\n\n# Update pip\npip install --upgrade pip\n\n# Install development packages\npip install -r requirements-dev.in\n\n# Install collection requirements\nansible-galaxy install -r requirements.yml\n```\n\n### Run tests\n\nAfter fulfilling the [requirements](#requirements),\nfrom the project root run:\n\n```sh\n# List all tox available environments\nuvx tox list --ansible --conf tox-ansible.ini\n# Run sanity tests for detected python/ansible environments\nuvx tox run --ansible -f sanity --conf tox-ansible.ini\n# Update dependencies\nuvx tox run -f deps --ansible --conf tox-ansible.ini\n# Run linter\nuvx tox run -f lint --ansible --conf tox-ansible.ini\n# Run all tests in parallel\nuvx tox -p all --ansible --conf tox-ansible.ini\n```\n\n### Propose Changes\n\nThe steps to follow to propose changes are:\n\n- Fork and clone this repository\n  - [Fork this repository][github-docs-fork-a-repo]\n  - [Clone your forked repository locally][github-docs-clone-fork-locally]\n- Make changes (see [steps example](#steps-example) below)\n  - Change files\n  - Add a changelog file in `changelogs/fragments` documenting the changes \\\n  (see [antsibull-changelog documentation][antsibull-changelog-docs] for details)\n  - Run changelog lint\n  - Commit changes in new branch\n  - Run tests\n  - Push branch to remote fork\n- [Create a pull request to the original repository][github-docs-create-pr-from-fork]\n\n#### Steps example\n\n```sh\n# Pick a meningful name for the banch\nnew_branch_name='example-to-propose-changes'\n# Switch to the new branch\ngit checkout -b \"${new_branch_name:?}\"\n# Make changes to the code\necho 'Remember to remove this line ;)' \u003e\u003e README.md\n# Add a changelog file describing the changes\n_fragment_content=$(cat \u003c\u003c-'END'\n\t---\n\tminor_changes:\n\t  - Add a useless line in README.md\nEND\n)\n_fragment_file='pollute_readme.yaml'\necho \"${_fragment_content:?}\" \u003e \"changelogs/fragments/${_fragment_file:?}\"\n# Validate the changelog fragments\n# note: add `--allow-dirty` to test changes not yet committed to git\nuvx tox -f changelogs-lint --ansible --conf tox-ansible.ini --allow-dirty\n# Stage and commit changes for tox tests to work\ngit add .\ngit commit -m \"Added a useless line in README.md\"\n# Run linters\nuvx tox -f lint --ansible --conf tox-ansible.ini\n# Run all tests in parallel\nuvx tox -p all --ansible --conf tox-ansible.ini\n# Push changes to your remote fork\ngit push\n```\n\n### Create a new release\n\n\u003e **Note:** This is done by the collection maintainers\n\nFor the example we will use the version `v1.0.0`.\n\n- ensure you are on the `main` branch and there are no pending changes to commit\n- create a new git branch named `releases/v1.0.0`\n- update version in `galaxy.yml` to `version: 1.0.0`\n- update version in `pyproject.toml` to `version = \"1.0.0\"`\n- [generate the new release changelogs](#create-the-new-release-changelogs)\n- [generate the documentation](#generate-documentation)\n- create a commit with the changes\n- create a PR to merge the new branch\n- merge PR\n- create a new release named `v1.0.0`\n- verify that the release is published on \u003chttps://galaxy.ansible.com/ui/repo/published/sinetris/tools\u003e\n\n#### Create the new release changelogs\n\n```sh\nuvx tox -f changelogs --ansible --conf tox-ansible.ini --allow-dirty\n```\n\n#### Generate documentation\n\nTo update the documentation, run:\n\n```sh\nuvx tox -f docs-update --ansible --conf tox-ansible.ini --allow-dirty\n```\n\nIf you want to inspect the documentation locally, you can generate html files running:\n\n```sh\nuvx tox -f docs-build --ansible --conf tox-ansible.ini --allow-dirty\n```\n\nTo see a preview, open `docs/build/index.html` in a browser.\n\n## More information\n\n- [Ansible collection development forum](https://forum.ansible.com/c/project/collection-development/27)\n- [Ansible User guide](https://docs.ansible.com/ansible/devel/user_guide/index.html)\n- [Ansible Developer guide](https://docs.ansible.com/ansible/devel/dev_guide/index.html)\n- [Ansible Collections Checklist](https://docs.ansible.com/ansible/devel/community/collection_contributors/collection_requirements.html)\n- [Ansible Community code of conduct](https://docs.ansible.com/ansible/devel/community/code_of_conduct.html)\n- [The Bullhorn (the Ansible Contributor newsletter)](https://docs.ansible.com/ansible/devel/community/communication.html#the-bullhorn)\n- [News for Maintainers](https://forum.ansible.com/tag/news-for-maintainers)\n\n## Licensing\n\nApache License 2.0 or later.\n\nSee [LICENSE](https://github.com/sinetris/ansible-tools-collection/blob/main/LICENSE)\nto see the full text.\n\n[antsibull-changelog-docs]: \u003chttps://ansible.readthedocs.io/projects/antsibull-changelog/changelogs/\u003e \"antsibull-changelog Documentation\"\n[colima]: \u003chttps://github.com/abiosoft/colima\u003e \"Colima: container runtimes on macOS\"\n[devcontainer.json]: \u003chttps://github.com/sinetris/ansible-tools-collection/blob/main/.devcontainer/devcontainer.json\u003e \"devcontainer.json\"\n[docker-mac]: \u003chttps://docs.docker.com/desktop/setup/install/mac-install/\u003e \"Install Docker Desktop on Mac\"\n[docker-setup]: \u003chttps://docs.docker.com/get-started/introduction/get-docker-desktop/\u003e \"Get Docker Desktop\"\n[github-docs-create-pr-from-fork]: \u003chttps://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request-from-a-fork\u003e \"GitHub Docs: Creating a pull request from a fork\"\n[github-docs-clone-fork-locally]: \u003chttps://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo#cloning-your-forked-repository\u003e \"GitHub Docs: Cloning your forked repository\"\n[github-docs-fork-a-repo]: \u003chttps://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo\u003e \"GitHub Docs: Fork a repository\"\n[vs-code-devcontainers]: \u003chttps://code.visualstudio.com/docs/devcontainers/containers\u003e \"VS Code: Developing inside a Container\"\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsinetris%2Fansible-tools-collection","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsinetris%2Fansible-tools-collection","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsinetris%2Fansible-tools-collection/lists"}