GitHub Actions for asdf

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

Action	Use	Description
install	asdf-vm/actions/install@v3	Installs asdf & tools in .tool-versions. Plugins fetched from asdf-vm/asdf-plugins
setup	asdf-vm/actions/setup@v3	Only install asdf CLI.
plugins-add	asdf-vm/actions/plugins-add@v3	Only install plugins, not tools.
plugin-test	asdf-vm/actions/plugin-test@v3	Plugin author test automation.

• Usage
  • Automatic Actions Updating
• Actions
  • Install
  • Plugin Test
  • Setup
  • Plugins Add
• Miscellaneous
  • Full Example Workflow
  • Docker Tricks

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/[email protected]
  # 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

See action.yml inputs.

Plugin Test

Plugin author test automation

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

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

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

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