You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
@@ -647,11 +636,11 @@ In previous steps, a git commit was made for the manual, and files had moved int
647
636
648
637
Occasionally, the repository can become unwieldy due to hosting so many large binary artifacts. Instructions can be found in the README for that repository.
649
638
650
-
#### Homebrew Formula
639
+
#### Homebrew
651
640
652
-
Using [`mislav/bump-homebrew-formula-action`](https://github.com/mislav/bump-homebrew-formula-action), a PR for the `gh` [`homebrew-core` formula](https://github.com/Homebrew/homebrew-core/blob/master/Formula/g/gh.rb) is created. The fork repository is currently owned by `williammartin` as PRs are [not accepted from organizations.](https://github.com/cli/cli/pull/7953)
641
+
Historically, we used [`mislav/bump-homebrew-formula-action`](https://github.com/mislav/bump-homebrew-formula-action). It created a PR for the `gh` [`homebrew-core` formula](https://github.com/Homebrew/homebrew-core/blob/master/Formula/g/gh.rb). The fork repository was owned by `williammartin` because PRs are [not accepted from organizations.](https://github.com/cli/cli/pull/7953)
653
642
654
-
`Homebrew/formulae.brew.sh`makes new formula versions available every 15 minutes through scheduled CI workflow. For more information, see https://docs.brew.sh/Formula-Cookbook#an-introduction
643
+
However, since this required a legacy PAT token to open a PR between these repositories, it was deemed too much risk for our security. As such, we now rely on [Homebrew's autobump](https://docs.brew.sh/Autobump).
Copy file name to clipboardExpand all lines: docs/releasing.md
+8-8Lines changed: 8 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -21,13 +21,14 @@ What this does is:
21
21
- Uploads all release artifacts to a new GitHub Release;
22
22
- A new git tag `vX.Y.Z` is created in the remote repository;
23
23
- The changelog is [generated from the list of merged pull requests](https://docs.github.com/en/repositories/releasing-projects-on-github/automatically-generated-release-notes);
24
-
- Updates [GitHub CLI marketing site](https://cli.github.com) with the contents of the new release;
25
-
- Updates the [`gh` Homebrew formula](https://github.com/williammartin/homebrew-core/blob/master/Formula/g/gh.rb) in the [`homebrew/homebrew-core` repo](https://github.com/search?q=repo%3AHomebrew%2Fhomebrew-core+%22gh%22+in%3Atitle&type=pullrequests).
24
+
- Updates [GitHub CLI marketing site](https://cli.github.com) with the contents of the new release.
26
25
27
-
> [!NOTE]
28
-
> `Homebrew/formulae.brew.sh` makes new formula versions available every 15 minutes through scheduled [CI workflow](https://github.com/Homebrew/formulae.brew.sh/actions/workflows/tests.yml).
29
-
>
30
-
> For more information, see https://docs.brew.sh/Formula-Cookbook#an-introduction
26
+
## Bumping Homebrew
27
+
28
+
Homebrew bumps are handled by [autobump](https://docs.brew.sh/Autobump), which runs periodically every 3 hours. In cases where a quicker rollout is required, a pull request can be opened manually with the following steps:
29
+
1. Replace the version number in the url to point ot the updated version.
30
+
2. Calculate and replace the sha256 value.
31
+
3. Open the PR.
31
32
32
33
To test out the build system while avoiding creating an actual release:
33
34
@@ -60,6 +61,5 @@ Occasionally, it might be necessary to clean up a bad release and re-release.
60
61
61
62
1. Delete the release and associated tag
62
63
2. Re-release and monitor the workflow run logs
63
-
3. Open pull request updating [`gh` Homebrew formula](https://github.com/williammartin/homebrew-core/blob/master/Formula/g/gh.rb)
64
-
with new SHA versions, linking the previous PR
64
+
3. Open pull request updating [`gh` Homebrew formula](https://github.com/Homebrew/homebrew-core/blob/master/Formula/g/gh.rb) with new SHA versions, linking the previous PR
65
65
4. Verify resulting Debian and RPM packages, Homebrew formula
0 commit comments