Release Packaging

OPSd CLI ships as a portable release bundle and an asdf plugin.

Release Bundle

For a released version such as v0.1.0, download the bundle that matches your platform:

curl -fL \
  -o opsd_0.1.0_linux_amd64.tar.gz \
  "https://gitlab.com/opsd-io/cli/opsd/-/releases/v0.1.0/downloads/opsd_0.1.0_linux_amd64.tar.gz"
tar -xzf opsd_0.1.0_linux_amd64.tar.gz
./opsd_0.1.0_linux_amd64/bin/opsd version

The bundle includes its own Ruby runtime. You do not need Ruby installed on the host to run the extracted bin/opsd.

asdf

Install the local plugin from this repository:

asdf plugin add opsd /path/to/opsd-cli/packaging/asdf-plugin
asdf install opsd 0.1.0
asdf global opsd 0.1.0
opsd version

Build A Local Bundle

If you want to build the release archive locally, use the portable bundle script:

scripts/release/build_portable_bundle.sh

This creates a release archive under dist/ in the form:

• opsd_<version>_<os>_<arch>.tar.gz

The build script validates that the source Ruby matches .ruby-version and that the resulting archive can run bin/opsd version after unpacking.

The bundle contains:

• bin/opsd
• repository runtime assets such as lib/ and composer/
• an embedded Ruby runtime copied from the current Ruby prefix into runtime/

The launcher in bin/opsd prefers the embedded runtime when present and falls back to ruby from PATH during local development.