Skip to content

Latest commit

 

History

History
66 lines (41 loc) · 2.9 KB

bin.md

File metadata and controls

66 lines (41 loc) · 2.9 KB

bin

A tool used to install binary files of command-line programs from Github.

I have also found a nice script to do basically the same thing: github-install.sh

Manages binary files downloaded from different sources

bin

Installing †

  1. Download bin from the releases
  2. Run ./bin install github.com/marcosnils/bin so bin is managed by bin itself
  3. Run bin ls to make sure bin has been installed correctly. You can now remove the first file you downloaded.
  4. Enjoy!

(†) irony

Usage

Install a release from github with the following command:

bin install github.com/kubernetes-sigs/kind # installs latest Kind release

bin install github.com/kubernetes-sigs/kind/releases/tag/v0.8.0 # installs a specific release

bin install github.com/kubernetes-sigs/kind ~/bin/kind # installs latest on a specific path

You can install Docker images and use them as regular CLIs:

bin install docker://hashicorp/terraform:light # install the `light` tag for terraform

bin install docker://quay.io/calico/node # install the latest version of calico/node
bin ensure # Ensures that all binaries listed in the configuration are present
bin help # Help about any command
bin install <repo> [path] # Downloads the latest binary and makes it executable
bin list # List current binaries and it's versions
bin prune # Removes from the DB missing binaries
bin remove <bin>... # Deletes one or more binaries
bin update [bin]... # Scans binaries and prompts for update

FAQ

I see releases on Github, but bin does not pick them up

At the moment, bin does only consider the latest release from Github according to the following definition:

The latest release is the most recent non-prerelease, non-draft release, sorted by the created_at attribute. The created_at attribute is the date of the commit used for the release, and not the date when the release was drafted or published.

You can however install a specific pre-release by specifying the URL for the pre-release, e.g. bin install https://github.com/bufbuild/buf/releases/tag/v0.40.0.

I used bin and I got rate limited by Github or want to access private repos, what can I do?

Create a Github personal access token by following the steps in this guide: Creating a personal access token. The access token used with bin does not need any scopes.

Create an environment variable named GITHUB_AUTH_TOKEN with the value of your newly created access token. For example in bash: export GITHUB_AUTH_TOKEN=<your_token_value>.