https://github.com/luzifer/ansible-role-version

Tool to update a requirements.yml file for Ansible Galaxy with specific versions of roles
https://github.com/luzifer/ansible-role-version

ansible automation galaxy golang tool

Last synced: 13 days ago
JSON representation

Tool to update a requirements.yml file for Ansible Galaxy with specific versions of roles

• Host: GitHub
• URL: https://github.com/luzifer/ansible-role-version
• Owner: Luzifer
• License: apache-2.0
• Created: 2018-01-10T15:33:30.000Z (almost 7 years ago)
• Default Branch: master
• Last Pushed: 2018-03-19T17:26:58.000Z (almost 7 years ago)
• Last Synced: 2024-11-02T16:26:20.928Z (2 months ago)
• Topics: ansible, automation, galaxy, golang, tool
• Language: Go
• Homepage:
• Size: 10.1 MB
• Stars: 1
• Watchers: 3
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: History.md
  • License: LICENSE

Awesome Lists containing this project

README

        
[![Go Report Card](https://goreportcard.com/badge/github.com/Luzifer/ansible-role-version)](https://goreportcard.com/report/github.com/Luzifer/ansible-role-version)

![](https://badges.fyi/github/license/Luzifer/ansible-role-version)

![](https://badges.fyi/github/downloads/Luzifer/ansible-role-version)

![](https://badges.fyi/github/latest-release/Luzifer/ansible-role-version)

# Luzifer / ansible-role-version

Very simple tool to update a `requirements.yml` file for [Ansible Galaxy](https://galaxy.ansible.com/) with specific versions of roles.

## Usage

Lets say you do have a repository containing this `requirements.yml`:

```yaml

---

- name: docker

  src: https://github.com/luzifer-ansible/docker

  version: v0.1.0

- name: docker-compose

  src: https://github.com/luzifer-ansible/docker-compose

  version: v1.0.0

...

```

Now your CI system should update the version of `docker-compose` to `v1.0.1` and you don't want to fiddle with bash magic:

```bash

$ ansible-role-version set docker-compose v1.0.1

```

And you're done!

Sure, this example is a bit constructed: In reality this tool was written to update a bunch of different repositories each having a way bigger list of roles to include and the tool is used in a script to update all of them and create pull-requests out of the change.

To do so your requirements file needs to meet some requirements:

- All roles do have their `src` set to a Git URL

- Version is set to tags (if not it will be afterwards!)

- The roles do have proper versioning with tags

- The repos are public available (authentication while fetching the git repo is not yet supported)

Then just execute:

```console

$ ansible-role-version update

```