hiro/agru
1
0
Fork 0
mirror of https://github.com/vale981/agru synced 2025-03-05 17:51:42 -05:00
Code Issues Projects Releases Packages Wiki Activity Actions
No description
12 commits 2 branches 13 tags 185 KiB
Go 94.9%
Just 5.1%
Find a file
Aine fb87b35fe4
add verbose mode
2023-03-25 16:43:50 +02:00
.gitignore ci, license, goreleaser, etc 2023-03-25 15:07:44 +02:00
.gitlab-ci.yml add Where to get? in readme, adjust ci 2023-03-25 15:27:38 +02:00
.golangci.yml ci, license, goreleaser, etc 2023-03-25 15:07:44 +02:00
.goreleaser.yaml fix goreleaser 2023-03-25 15:17:38 +02:00
entries.go ci, license, goreleaser, etc 2023-03-25 15:07:44 +02:00
go.mod init 2023-03-16 22:50:02 +02:00
go.sum init 2023-03-16 22:50:02 +02:00
justfile ci, license, goreleaser, etc 2023-03-25 15:07:44 +02:00
LICENSE.md fix license, create roles path if not exists 2023-03-25 16:32:38 +02:00
main.go add verbose mode 2023-03-25 16:43:50 +02:00
README.md add Where to get? in readme, adjust ci 2023-03-25 15:27:38 +02:00
requirements.go ci, license, goreleaser, etc 2023-03-25 15:07:44 +02:00
roles.go fix license, create roles path if not exists 2023-03-25 16:32:38 +02:00

README.md

agru

What?

ansible-galaxy requirements updater is fast ansible-galaxy replacement with the following features:

  • update requirements.yml file if a newer git tag (role version) is available
  • update installed roles only when new version is present in requirements file
  • install missing roles
  • full backwards-compatibility with ansible-galaxy, yes, even the odd trailing space in the galaxy-installed roles' meta/.galaxy_install_info is present

Why?

Because ansible-galaxy is slow, very slow. And irrational. And miss some functions.

  • 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
  • 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
  • Roles installation takes ages with ansible-galaxy? A.G.R.U. needs a fraction of that time to install everything

How?

Usage of agru:
  -p string
    	path to install roles (default "roles/galaxy/")
  -r string
    	ansible-galaxy requirements file (default "requirements.yml")
  -u	update requirements file if newer versions are available

What's a catch?

Do you think A.G.R.U. is too good to be true? Well, it's true, but it has limitations:

only git repos are supported

does not work:

- src: geerlingguy.docker
  version: 6.1.0

does work:

- src: git+https://github.com/geerlingguy/ansible-role-docker
  name: geerlingguy.docker
  version: 6.1.0

only roles are supported

No collections at this moment, at all.

only update/install operations are supported

No list, no role upload to galaxy, no role removal from galaxy. In fact, galaxy API is not used at all, thus no API-related actions are supported

Where to get?

Binaries and distro-specific packages

On Releases page

Build yourself

just build or go build .