Context

You may need to download a specific version of the endorctl CLI for version pinning or security vetting purposes. While downloading the latest version is straightforward, downloading older versions requires a different URL format.

Answer

To download a specific version of the endorctl CLI, use the following URL format:

curl https://api.endorlabs.com/download/endorlabs/v[VERSION]/binaries/endorctl_v[VERSION]_[ARCH_TYPE] -o endorctl

For example, to download version v1.7.711:

curl https://api.endorlabs.com/download/endorlabs/v1.7.711/binaries/endorctl_v1.7.711_linux_amd64 -o endorctl

Important considerations for version selection:

• The supported backward compatible range is six months

• It's recommended to stay within 1-2 months of the current release to benefit from new features and fixes

• Versions older than six months have less test coverage and higher risk

To find available recent versions, you can use this query:

endorctl api list -n <example> -r PluginBinary \
  --filter='spec.binary_type==BINARY_TYPE_ENDORCTL_BINARY and spec.published_date > now(-4380h)' \
  --field-mask='spec.version,spec.published_date,spec.arch_type,spec.url,spec.checksum' \
  --page-size=500

This query will show versions published within the last 6 months (4380 hours) along with their publication dates and download URLs.