Skip to content

Latest commit

 

History

History
72 lines (52 loc) · 2.52 KB

homebrew.md

File metadata and controls

72 lines (52 loc) · 2.52 KB

Installing Kops via Hombrew

Homebrew makes installing kops very simple for MacOS.

brew update && brew install kops

Development Releases and master can also be installed via Homebrew very easily:

# Development Release
brew update && brew install kops --devel
# HEAD of master
brew update && brew install kops --HEAD

Note: if you already have kops installed, you need to substitute upgrade for install.

You can switch between development and stable releases with:

brew switch kops 1.7.1
brew switch kops 1.8.0-beta.1

Releasing kops to Brew

Submitting a new release of kops to Homebrew is very simple.

From a homebrew machine

brew bump-formula-pr makes it easy to update our homebrew formula. This will automatically update the provided fields and open a PR for you. More details on this script are located here.

We now include both major and development releases in homebrew. A development version can be updated by adding the --devel flag.

Example usage:

# Major Version
brew bump-formula-pr kops \
       --url=https://github.com/kubernetes/kops/archive/1.7.1.tar.gz \
       --sha256=044c5c7a737ed3acf53517e64bb27d3da8f7517d2914df89efeeaf84bc8a722a

# Development Version
brew bump-formula-pr kops \
       --devel \
       --url=https://github.com/kubernetes/kops/archive/1.8.0-beta.1.tar.gz \
       --sha256=81026d6c1cd7b3898a88275538a7842b4bd8387775937e0528ccb7b83948abf1
  • Update the URL variable to the tar.gz of the new release source code
  • Update the sha256 variable to SHA256 checksum of the new tar.gz

If we change how dependencies work or if we make the install require something other than a simple make, we'll need to update the commands

brew edit kops will open an editor on your machine to edit the formula. You can use this to make more in depth changes to the formula.

Test that Homebrew formula works

brew uninstall kops && brew install kops will install the new version. Test and make sure that the new release works.

Audit the Homebrew formula

brew audit --strict --online will output any code that that doesn't meet the Homebrew standards.

Send a commit to the Homebrew repo

Rather than repeating documentation that might change, head over to Homebrew documentation for directions and conventions.

The formula can be found in hacks/brew/kops.rb.