Skip to content

v1.0.0 (RC 2)

Latest
Compare
Choose a tag to compare
@elidebot elidebot released this 15 Dec 07:15
1.0.0-rc2
129d7a4

Summary

This is the second Release Candidate for the stable v1.0.0 release of the Buildless CLI, Buildless Agent, and related local tools. Version 1 will obviously be a major release, and so this RC prepares the CLI, Agent, and release pipeline for stable maturity. The code is settling rather than growing, and we're focused on fixing bugs and enhancing packaging/install options.

Version 1 will be the first release of local tooling which includes support for different locales; the command line has been mostly translated into Spanish as an initial second supported locale. Spanish locale features will activate automatically based on Java's own heuristics (reading settings on your machine), or it can be activated via the new global --locale=sp flag.

(These release notes will continue to evolve and be repeated with each RC until the v1 release).

Changelog

  • feat: global flags are displayed in a section in help
  • feat: global flags inherit properly in each command
  • feat: buildless docs (Search and open docs)
  • feat: buildless dashboard (Open the Dashboard)
  • feat: buildless update (Self-update Buildless)
  • feat: buildless [help|usage] (Extended usage help)
  • feat: buildless bug (File a bug)
  • feat: buildless [legal|notices|license] (Show notices, licenses, etc)
  • feat: embedded sbom in cli
  • feat: two-layer near cache
  • feat: v2 cache stats
  • feat: i18n keys for all options/parameters and commands
  • feat: tailored native library support → smaller, more efficient binaries on each platform
  • feat: initial support for spanish in the cli
  • feat: customizable agent port/sock/host via flags
  • feat: customizable agent cloud behavior via flags
  • feat: reliable exit codes for several commands + docs
  • feat: http/3 support in buildless agent
  • feat: support for console tables, lists, forms, boxes
  • fix: crash starting buildless agent in rc1
  • fix: output issues with buildless support
  • fix: boolean flags no longer require explicit value
  • fix: client selection + load balancing in buildless agent proxy
  • fix: weigher and removal listener for agent near cache
  • chore: complete refactor of input/output facilities for CLI
  • chore: upgrade mosaic → 0.10.0
  • chore: upgrade gRPC → 1.60.0
  • chore: upgrade protobuf → 3.25.0
  • chore: upgrade netty → 4.1.101.Final

Verification

Use the following parameters to verify this release using Sigstore.

Parameter Value Description
certificate-oidc-issuer https://github.com/login/oauth Verifies the releaser's account
certificate-identity [email protected] Issuer for this release (a GitHub account)

Installation

One-liner (install and verify):

  • macOS:
echo "Installing Buildless..." \
  && wget -q https://github.com/buildless/cli/releases/download/1.0.0-rc2/buildless.darwin-arm64.tgz \
  && wget -q https://github.com/buildless/cli/releases/download/1.0.0-rc2/buildless.darwin-arm64.tgz.sha256 \
  && tar -xzf buildless.darwin-arm64.tgz \
  && cat buildless.darwin-arm64.tgz.sha256 | gsha256sum --check --status \
  && mkdir -p ~/bin \
  && cp -fv buildless ~/bin \
  && chmod +x ~/bin/buildless \
  && export PATH="$PATH:~/bin" \
  && rm -f buildless "buildless.darwin-arm64.*" \
  && buildless --help

# `buildless` binary extracted and installed to `~/bin`
  • Linux:
echo "Installing Buildless..." \
  && wget -q https://github.com/buildless/cli/releases/download/1.0.0-rc2/buildless.linux-amd64.tgz \
  && wget -q https://github.com/buildless/cli/releases/download/1.0.0-rc2/buildless.linux-amd64.tgz.sha256 \
  && tar -xzf buildless.linux-amd64.tgz \
  && cat buildless.linux-amd64.tgz.sha256 | sha256sum --check --status \
  && mkdir -p ~/bin \
  && cp -fv buildless ~/bin \
  && chmod +x ~/bin/buildless \
  && export PATH="$PATH:~/bin" \
  && rm -f buildless "buildless.linux-amd64.*" \
  && buildless --help

# `buildless` binary extracted and installed to `~/bin`
  • Windows:
    Please use one of the MSI or exe-based installers.

Verifying a release

To verify this release, download the binary for your platform and architecture, and the accompanying sha256 and sigstore.json files. For example, on macOS ARM64 (M1-M3), you would download all of:

  • buildless.darwin-arm64.tgz
  • buildless.darwin-arm64.tgz.sha256
  • buildless.darwin-arm64.sigstore.json

Extract the binary:

tar -xzvf buildless.darwin-arm64.tgz

To verify the SHA256 hash:

cat buildless.darwin-arm64.tgz.sha256 | gsha256sum --check --status

This command returns 0 (success) if the checksum matches.

To verify the Sigstore signature:

cosign verify-blob \
  --certificate-oidc-issuer https://accounts.google.com \
  --certificate-identity [email protected] \
  --bundle ./buildless.darwin-arm64.sigstore.json \
  buildless

# Prints: "Verified OK"

See the table at the top of this release for explanations of each parameter.

All verification steps:

tar -xzvf buildless.darwin-arm64.tgz \
  && cat buildless.darwin-arm64.tgz.sha256 | gsha256sum --check --status \
  &&  cosign verify-blob \
  --certificate-oidc-issuer https://accounts.google.com \
  --certificate-identity [email protected] \
  --bundle ./buildless.darwin-arm64.sigstore.json \
  buildless || $(echo "Failed to verify Buildless binary; deleting." && rm -fv buildless)

# Prints: "Verified OK", with `buildless` binary extracted

Platform support

Currently available for:

  • macOS arm64 / amd64 (darwin-arm64 or darwin-amd64)
  • Linux amd64 (linux-amd64)
  • Windows amd64 (windows-amd64)