Home

Awesome

GitHub Actions for asdf

GitHub Release lint test build CodeQL

A collection of asdf GitHub Actions for use in your workflows.

ActionUseDescription
installasdf-vm/actions/install@v3Installs asdf & tools in .tool-versions.<br>Plugins fetched from asdf-vm/asdf-plugins
setupasdf-vm/actions/setup@v3Only install asdf CLI.
plugins-addasdf-vm/actions/plugins-add@v3Only install plugins, not tools.
plugin-testasdf-vm/actions/plugin-test@v3Plugin author test automation.
<!-- TOC --> <!-- TOC -->

Usage

steps:
  - name: Install asdf & tools
    uses: asdf-vm/actions/install@v3

To avoid breaking changes, use the full Semantic Version vX.Y.Z. Below are the available version pinning options:

steps:
  # Reference a specific commit (most strict, for the supply-chain paranoid)
  - uses: asdf-vm/actions/install@f4acd427436df623426c29f7e3e9ea715be28396
  # Reference a semver major version only (GitHub recommended)
  - uses: asdf-vm/actions/install@v3
  # Reference a semver version of a release (recommended)
  - uses: asdf-vm/actions/install@v3.0.2
  # Reference a branch (most dangerous)
  - uses: asdf-vm/actions/install@master

Automatic Actions Updating

GitHub Dependabot has support for tracking GitHub Actions releases and automatically creating PRs with these updates.

# .github/dependabot.yml
version: 2
updates:
  - package-ecosystem: "github-actions"
    directory: "/"
    schedule:
      interval: "weekly" # Check for updates to GitHub Actions every week

Actions

Install

Installs asdf & tools in .tool-versions. Plugins fetched from asdf-vm/asdf-plugins

steps:
  - uses: asdf-vm/actions/install@v3
<!-- TODO(jthegedus): capture action.yml options in a markdown table here. Show usage examples for each option. -->

See action.yml inputs.

Plugin Test

Plugin author test automation

steps:
  - uses: asdf-vm/actions/plugin-test@v3
    with:
      command: my_tool --version
<!-- TODO(jthegedus): capture action.yml options in a markdown table here. Show usage examples for each option. -->

See action.yml inputs.

Setup

Only install asdf CLI.

Note: this Action is used internally by Install & Plugin Test, opt for those first.

steps:
  - uses: asdf-vm/actions/setup@v3
<!-- TODO(jthegedus): capture action.yml options in a markdown table here. Show usage examples for each option. -->

See action.yml inputs.

Plugins Add

Only install plugins, not tools.

Note: this Action is used internally by Install & Plugin Test, opt for those first.

steps:
  - uses: asdf-vm/actions/plugins-add@v3
<!-- TODO(jthegedus): capture action.yml options in a markdown table here. Show usage examples for each option. -->

See action.yml inputs.

Miscellaneous

Full Example Workflow

This example workflow demonstrates how to use the Install Action: asdf-vm/actions/install@v3. It is taken from the asdf-vm/asdf-plugin-template repository.

# example .tool-versions
shellcheck 0.9.0
shfmt 3.6.0
# https://github.com/asdf-vm/asdf-plugin-template/blob/main/template/.github/workflows/lint.yml
name: Lint

on:
  push:
    branches:
      - main
  pull_request:

jobs:
  shellcheck:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: asdf-vm/actions/install@v3
      - run: scripts/lint.bash
      # script runs Shellcheck, Shfmt etc installed by previous action

  actionlint:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Check workflow files
        uses: docker://rhysd/actionlint:1.6.23
        with:
          args: -color

Docker Tricks

Using the default GitHub Action images may cause problems during plugin testing due to current asdf implementation constraints. If you experience issues, you can use Docker containers to reduce the variables of your environment.

jobs:
  plugin_test:
    strategy:
      fail-fast: false
      matrix:
        container:
          - alpine:latest
          - centos:latest
          - ubuntu:latest

    runs-on: ubuntu-latest

    container:
      image: ${{ matrix.container }}

    steps:
      - uses: asdf-vm/actions/plugin-test@v3
        with:
          command: my_tool --version