https://github.com/sgaunet/ansible-role-gh-release-installer

An Ansible Role that installs releases from github.
https://github.com/sgaunet/ansible-role-gh-release-installer

ansible-role generic github install linux release

Last synced: about 1 month ago
JSON representation

An Ansible Role that installs releases from github.

• Host: GitHub
• URL: https://github.com/sgaunet/ansible-role-gh-release-installer
• Owner: sgaunet
• License: mit
• Created: 2024-04-29T18:29:05.000Z (8 months ago)
• Default Branch: main
• Last Pushed: 2024-11-10T14:18:17.000Z (about 2 months ago)
• Last Synced: 2024-11-10T15:21:41.777Z (about 2 months ago)
• Topics: ansible-role, generic, github, install, linux, release
• Language: Shell
• Homepage:
• Size: 261 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Ansible Role: gh_role_installer

[![GitHub release](https://img.shields.io/github/release/sgaunet/ansible-role-gh-release-installer.svg)](https://github.com/sgaunet/ansible-role-gh-release-installer/releases/latest)

An Ansible Role that installs releases from github. It has been created to install binaries from github releases. **It is designed to setup only simple binary (coded with Go or rust) and not to install complex software.**

You can use it to setup tools like:

* bat

* d2

* gini

* goreleaser

* helm

* k9s

* pgweb

* vhs

* ...

## Requirements

None.

## Role Variables

Available variables are listed below, only gh_role_installer_tmp_directory and gh_role_installer_binary_path are set by default:

    gh_role_installer_version: "latest"   # latest is a special value to get the latest release (github api will be used to get the latest release)

    gh_role_installer_os: "linux"         # os name, used to download the release

    gh_role_installer_arch: "amd64"       # architecture, used to download the release

    gh_role_installer_repository: "sgaunet/jwt-cli"

    # release url, used to download the release, be careful version_to_install is a special value that will be replaced by the version to install

    gh_role_installer_release: "https://github.com/{{ gh_role_installer_repository }}/releases/download/v{{ version_to_install }}/jwt-cli_{{ version_to_install }}_{{ gh_role_installer_os }}_{{ gh_role_installer_arch }}"

    gh_role_installer_release_is_archive: false  # if true, the release is an archive, it will be downloaded and extracted

    gh_role_installer_binary_name: "jwt-cli"     # binary name to install

    gh_role_installer_cmd_to_get_version: "jwt-cli version"  # command to get the version of the installed binary

    gh_role_installer_tmp_directory: "{{ lookup('env', 'TMPDIR') | default('/tmp', true) }}" # temporary directory to download the release

    gh_role_installer_binary_path: "/usr/local/bin/{{ gh_role_installer_binary_name }}"  # directory where the binary will be installed

## Dependencies

None.

## Example Playbook

```yaml

- hosts: all

  roles:

    - role: sgaunet.gh_role_installer

      vars:

        gh_role_installer_version: "latest"

        gh_role_installer_os: "unknown-linux-musl"

        gh_role_installer_arch: "x86_64"

        gh_role_installer_repository: "zellij-org/zellij"

        gh_role_installer_release: "https://github.com/{{ gh_role_installer_repository }}/releases/download/v{{ version_to_install }}/zellij-{{ gh_role_installer_arch }}-{{ gh_role_installer_os }}.tar.gz"

        gh_role_installer_release_is_archive: true

        gh_role_installer_binary_name: "zellij"

        gh_role_installer_cmd_to_get_version: 'zellij --version | sed "s#zellij ##g"'

        # gh_role_installer_tmp_directory: "{{ lookup('env', 'TMPDIR') | default('/tmp', true) }}"

        # gh_role_installer_binary_path: "/usr/local/bin/{{ gh_role_installer_binary_name }}"

```

The role contains also variables to install miscelleanous tools. [See the list of available tools in this documentation.](docs/available_tools.md)

## License

MIT