https://github.com/trallnag/ansible-role-asdf-plugin

Ansible role that installs any asdf plugin and package
https://github.com/trallnag/ansible-role-asdf-plugin

ansible ansible-role asdf asdf-plugin asdf-vm

Last synced: 4 months ago
JSON representation

Ansible role that installs any asdf plugin and package

• Host: GitHub
• URL: https://github.com/trallnag/ansible-role-asdf-plugin
• Owner: trallnag
• License: isc
• Created: 2021-08-31T22:39:00.000Z (over 3 years ago)
• Default Branch: trunk
• Last Pushed: 2023-05-01T10:57:37.000Z (almost 2 years ago)
• Last Synced: 2024-04-17T21:14:50.174Z (10 months ago)
• Topics: ansible, ansible-role, asdf, asdf-plugin, asdf-vm
• Language: JavaScript
• Homepage:
• Size: 474 KB
• Stars: 4
• Watchers: 2
• Forks: 1
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

        
[![primary](https://github.com/trallnag/ansible-role-asdf-plugin/actions/workflows/primary.yaml/badge.svg)](https://github.com/trallnag/ansible-role-asdf-plugin/actions/workflows/primary.yaml)

[![galaxy](https://img.shields.io/ansible/role/56162)](https://galaxy.ansible.com/trallnag/asdf_plugin)

[![quality](https://img.shields.io/ansible/quality/56162)](https://galaxy.ansible.com/trallnag/asdf_plugin)

[![downloads](https://img.shields.io/ansible/role/d/56162?label=downloads)](https://galaxy.ansible.com/trallnag/asdf_plugin)

# Ansible Role `trallnag.asdf_plugin`

Ansible role that installs any asdf plugin and package.

This role does not install asdf itself. It must already be available on the

target.

Available on [Ansible Galaxy](https://galaxy.ansible.com/trallnag/asdf_plugin).

## Scope

- Installing a single asdf plugin.

- Installing multiple versions of a package managed by a plugin.

- Everything supported by asdf should be configurable but also optional.

- No requirments except asdf itself.

## Special Requirements

Asdf must be available on the target.

## Special Dependencies

None.

## Role Variables

Check out [`meta/argument_specs.yaml`](meta/argument_specs.yaml).

## Examples

Here is a minimal Playbook:

```yaml

- name: Playbook

  hosts: myhost

  remote_user: myuser

  vars:

    rolespec_validate: true

  roles:

    - name: trallnag.asdf_plugin

      vars:

        asdf_plugin_name: gopass

        asdf_plugin_git_url: https://github.com/trallnag/asdf-gopass.git

        asdf_plugin_git_ref: refs/tags/v1.0.1

        asdf_plugin_package_versions: ['1.12.7', '1.12.8']

        asdf_plugin_package_version_global: '1.12.8'

```

And here packaged within a small wrapper role:

```yaml

- name: Install Terraform with asdf

  ansible.builtin.import_role:

    name: trallnag.asdf_plugin

  vars:

    asdf_plugin_name: terraform

    asdf_plugin_git_url: https://github.com/asdf-community/asdf-hashicorp.git

    asdf_plugin_package_versions: ['1.0.9']

    asdf_plugin_package_version_global: '1.0.9'

- name: Setup completion for Bash

  ansible.builtin.blockinfile:

    path: ~/.bashrc

    marker: '# {mark} :: ANSIBLE MANAGED BLOCK :: {{ role_name }}'

    block: |

      complete -C terraform terraform

```