/asdf-orb

Ease your CircleCI workflows with ASDF

Primary LanguageShellMIT LicenseMIT

CircleCI Build Status CircleCI Orb Version License CircleCI Community

Use ASDF in your CircleCI pipelines.

What are Orbs?

Motivation

Single Source of Truth

Leverage your .tool-versions file as the single source of truth. There's no longer a need to synchronize tooling between your CI environment and your local setup.

Ease of Integrating Tools into CI

Utilize the .tool-versions file for straightforward tool integration in your CI pipeline.

Reduced Time to Action

The more specialized your Docker image, the longer it might take to fetch. With asdf-orb, you can start with a widely-used, or even a base image, and install everything you need using just one command. Plus, by caching this setup, you can speed up restoration for even quicker starts in the future.

Status

The orb's got just the install command for now. But after you've got ASDF installed, adding plugins and tool installations can be easily accomplished from a regular run step. For examples, see:

Warning

This is early alpha. Keep this in mind that interface might change1.

Quickstart

version: '2.1'

orbs:
  asdf: rynkowsg/asdf@0.1.1

jobs:
  test:
    docker: [{image: "cimg/base:stable"}]
    steps:
      - asdf/install

workflows:
  main-workflow:
    jobs:
      - test

Usage

For full usage guidelines, see the orb registry listing.

rynkowsg/ orb family

Name Description
rynkowsg/asdf Orb providing support for ASDF
rynkowsg/checkout Advanced checkout with support of LFS, submodules, custom SSH identities, shallow clones and more
rynkowsg/rynkowsg Orb with no particular theme, used primarily for prototyping

License

Copyright © 2024 Greg Rynkowski

Released under the MIT license.

Footnotes

  1. That said, it's probably still better option to choose the update your repo later, if interface change, than whipping up your own asdf scripts.