{"id":15151593,"url":"https://github.com/etkecc/agru","last_synced_at":"2025-10-24T07:31:10.553Z","repository":{"id":253879038,"uuid":"841149295","full_name":"etkecc/agru","owner":"etkecc","description":"ansible-galaxy requirements updater is fast ansible-galaxy replacement","archived":false,"fork":false,"pushed_at":"2024-11-01T22:40:51.000Z","size":152,"stargazers_count":7,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-01-31T00:25:46.820Z","etag":null,"topics":["ansible","cli"],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/etkecc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"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}},"created_at":"2024-08-11T19:30:23.000Z","updated_at":"2024-11-25T03:50:58.000Z","dependencies_parsed_at":"2024-08-20T05:54:43.875Z","dependency_job_id":"4a083783-5aad-40e4-8325-62cd3bf5e5cd","html_url":"https://github.com/etkecc/agru","commit_stats":null,"previous_names":["etkecc/agru"],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/etkecc%2Fagru","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/etkecc%2Fagru/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/etkecc%2Fagru/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/etkecc%2Fagru/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/etkecc","download_url":"https://codeload.github.com/etkecc/agru/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":237932070,"owners_count":19389560,"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","cli"],"created_at":"2024-09-26T15:04:27.308Z","updated_at":"2025-10-24T07:31:10.548Z","avatar_url":"https://github.com/etkecc.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# agru\n\n\u003c!-- vim-markdown-toc GFM --\u003e\n\n* [What?](#what)\n* [Why?](#why)\n* [How?](#how)\n* [What's the catch?](#whats-the-catch)\n    * [only git repos are supported](#only-git-repos-are-supported)\n    * [only roles are supported](#only-roles-are-supported)\n    * [only list/update/install/remove operations are supported](#only-listupdateinstallremove-operations-are-supported)\n* [Where to get?](#where-to-get)\n    * [Binaries and distro-specific packages](#binaries-and-distro-specific-packages)\n    * [Build yourself](#build-yourself)\n* [Who uses it?](#who-uses-it)\n\n\u003c!-- vim-markdown-toc --\u003e\n\n## What?\n\n**a**nsible-**g**alaxy **r**equirements **u**pdater is fast ansible-galaxy replacement with the following features:\n\n* update requirements.yml file if a newer git tag (role version) is available\n* update installed roles only when new version is present in requirements file\n* install missing roles\n* full backwards-compatibility with `ansible-galaxy`, yes, even the odd trailing space in the galaxy-installed roles' meta/.galaxy_install_info is present\n\n## Why?\n\nWe at [etke.cc](https://etke.cc) developing and maintainining a lot of [Ansible roles](https://github.com/orgs/mother-of-all-self-hosting/repositories) and playbooks ([MDAD](https://github.com/spantaleev/matrix-docker-ansible-deploy), [MASH](https://github.com/mother-of-all-self-hosting/mash-playbook), [etke.cc](https://gitlab.com/etke.cc/ansible/)).\nAnd we developed A.G.R.U., because `ansible-galaxy` is slow, **very** slow. And irrational. And it misses some functions.\n\n* You updated some role's version in requirements file? Sorry, `ansible-galaxy install -r requirements.yml -p roles/galaxy/` can't install it, you have to use `--force` or remove the dir manually. A.G.R.U. does that automatically\n* You have 100500 roles in your requirements file and you have to manually check each of them if a newer tag is available? A.G.R.U. does that automatically\n* Roles installation takes ages with `ansible-galaxy`? A.G.R.U. needs a fraction of that time to install everything\n\nWhile initially it was for maintainers needs, we made it useful for everyone.\nAll our playbooks have a nice `just update` command (for maintainers: `just update -u`), which updates the playbook itself and installs all the roles. And it's fast.\n\n## How?\n\n```bash\nUsage of agru:\n  -c\tcleanup temporary files (default true)\n  -d string\n    \tdelete installed role, all other flags are ignored\n  -i\tinstall missing roles (default true)\n  -l\tlist installed roles\n  -limit int\n    \tlimit the number of parallel downloads (affects roles installation only). 0 - no limit (default)\n  -p string\n    \tpath to install roles (default \"roles/galaxy/\")\n  -r string\n    \tansible-galaxy requirements file (default \"requirements.yml\")\n  -u\tupdate requirements file if newer versions are available\n  -v\tverbose output\n```\n\n**list installed roles**\n\n```bash\n$ agru -l\n```\n\n**install role from the requirements file**\n\n```bash\n$ agru\n```\n\n**update requirements file if newer versions are available**\n\n```bash\n$ agru -u\n```\n\n**remove already installed role**\n\n```bash\n$ agru -d traefik\n```\n\n## What's the catch?\n\nDo you think A.G.R.U. is too good to be true? Well, it's true, but it has limitations:\n\n### only git repos are supported\n\ndoes **not** work:\n\n```yaml\n- src: geerlingguy.docker\n  version: 6.1.0\n```\n\n**does** work:\n```yaml\n- src: git+https://github.com/geerlingguy/ansible-role-docker\n  name: geerlingguy.docker\n  version: 6.1.0\n```\n\n### only roles are supported\n\nNo collections at this moment, at all.\n\n### only list/update/install/remove operations are supported\n\nAnsible Galaxy API is not used at all, thus no API-related actions are supported\n\n## Where to get?\n\n### Binaries and distro-specific packages\n\n[Releases page](https://github.com/etkecc/agru/releases) and [Arch Linux AUR](https://aur.archlinux.org/packages/agru)\n\n### Build yourself\n\n`just build` or `go build .`\n\n## Who uses it?\n\n- [Matrix Docker Ansible Deploy (MDAD)](https://github.com/spantaleev/matrix-docker-ansible-deploy)\n- [Mother of All Self-Hosting (MASH)](https://github.com/mother-of-all-self-hosting/mash-playbook)\n- [etke.cc](https://github.com/etkecc/ansible)\n\nIf you use A.G.R.U. in your project, please let us know by creating an issue or PR with your project link.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fetkecc%2Fagru","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fetkecc%2Fagru","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fetkecc%2Fagru/lists"}