artis3n.github_version.github_version (1.0.3) — lookup

Install collection

Install with ansible-galaxy collection install artis3n.github_version:==1.0.3

Add to requirements.yml

  collections:
    - name: artis3n.github_version
      version: 1.0.3

Description

This lookup returns the latest tagged release version of a public Github repository.

A future version will accept an optional Github token to allow lookup of private repositories.

Requirements

• json
• re

Usage examples

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Strip the 'v' out of the tag version, e.g. 'v1.0.0' -> '1.0.0'
  set_fact:
    ansible_version: "{{ lookup('github_version', 'ansible/ansible')[1:] }}"

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Operate on multiple repositories
  git:
    repo: https://github.com/{{ item }}.git
    version: "{{ lookup('github_version', item) }}"
    dest: "{{ lookup('env', 'HOME') }}/projects"
  with_items:
    - ansible/ansible
    - ansible/molecule
    - ansible/awx

Inputs

    
repos:
    description: A list of Github repositories from which to retrieve versions.
    required: true

Outputs

_list:
  description:
  - List of latest Github repository version(s)
  type: list

See also

• Github Releases API: API documentation for retrieving the latest version of a release. link