Skip to content

Commit

Permalink
Update homebrew release docs.
Browse files Browse the repository at this point in the history
`brew bump-formula-pr` has simplified the process for updating brew
forumla
  • Loading branch information
mikesplain committed Oct 10, 2017
1 parent 7b65c54 commit b4de894
Showing 1 changed file with 18 additions and 3 deletions.
21 changes: 18 additions & 3 deletions docs/development/homebrew.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,22 +4,37 @@ Submitting a new release of kops to Homebrew is very simple.

### From a homebrew machine

```brew edit kops``` will open an editor on your machine to edit the formula. Make the following changes:
`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.](https://github.com/Homebrew/brew/blob/master/Library/Homebrew/dev-cmd/bump-formula-pr.rb)

Example usage:
```
brew bump-formula-pr \
--url=https://github.com/kubernetes/kops/archive/1.7.1.tar.gz \
--sha256=044c5c7a737ed3acf53517e64bb27d3da8f7517d2914df89efeeaf84bc8a722a
```

* 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.
```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](https://github.com/Homebrew/brew/blob/master/docs/Formula-Cookbook.md#commit) for directions and conventions.
Rather than repeating documentation that might change, head over to
[Homebrew documentation](https://github.com/Homebrew/brew/blob/master/docs/Formula-Cookbook.md#commit)
for directions and conventions.


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

0 comments on commit b4de894

Please sign in to comment.