Skip to content

Commit 9398d90

Browse files
committed
Adjust the documentation to how things are done now using the GitForWindowsHelper GitHub App
1 parent 3985d12 commit 9398d90

File tree

1 file changed

+11
-15
lines changed

1 file changed

+11
-15
lines changed

Releasing-Git-for-Windows.md

Lines changed: 11 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -89,32 +89,28 @@ When a new version is tagged in [upstream git](https://github.com/git/git), the
8989
- link the issue to the pull request created in the previous step
9090
- add the issue to the current "Next release" milestone ([example](https://github.com/git-for-windows/git/milestone/67))
9191

92-
# Kicking off the "Git Artifacts" Azure Pipeline
92+
# Kicking off the "Git Artifacts" automation
9393

94-
Direct your browser to https://dev.azure.com/git-for-windows/git/_build?definitionId=34&_a=summary and queue a new build ("Run pipeline") with the build variable `use.branch` set to something like `rebase-to-v2.27.0@https://github.com/dscho/git` and `Branch/tag` set to the PR's tip commit (e.g. `refs/pull/2645/head`).
94+
Add a PR comment with [the slash command `/git-artifacts`](https://github.com/git-for-windows/gfw-helper-github-app?tab=readme-ov-file#git-artifacts). This will kick off several GitHub workflow runs in https://github.com/git-for-windows/git-for-windows-automation: one to create the tag and adjust the release notes, and then one each for every CPU architecture supported by Git for Windows generating:
9595

96-
That will pull down the PR branch of https://github.com/git-for-windows/git (technically, this is not necessary, because `use.branch` will make sure that the correct branch is used, but it makes the output nicer, as the Azure Pipeline will then show the correct commit in the summary), then look at the tags of https://github.com/git/git to determine the name of the new tag (read: the upcoming Git for Windows version), then fetch `main` of https://github.com/git-for-windows/build-extra, use the latter's `ReleaseNotes.md` to generate the message for the new tag, and then generate:
97-
98-
- The 32-bit/64-bit installers
99-
- The 32-bit/64-bit Portable Gits
100-
- The 32-bit/64-bit `.tar.bz2` archives
101-
- The 32-bit/64-bit MinGits
102-
- The 32-bit/64-bit BusyBox-based MinGits
103-
- The NuGet packages (both full and minimal version)
104-
105-
and publish them as a build artifact.
96+
- The installer
97+
- The Portable Git
98+
- The `.tar.bz2` archive
99+
- The MinGit
100+
- The BusyBox-based MinGit
101+
- The NuGet packages (x86_64-only)
106102

107103
# Verifying that the resulting installer works
108104

109-
The idea here is to download the `Git-<version>-64-bit.exe` artifact from the Pipeline, install it, and run through the "pre-flight check list" at https://github.com/git-for-windows/build-extra/blob/HEAD/installer/checklist.txt.
105+
The idea here is to download the `Git-<version>-64-bit.exe` artifact from the workflow run, install it, and run through the "pre-flight check list" at https://github.com/git-for-windows/build-extra/blob/HEAD/installer/checklist.txt.
110106

111107
# Kicking off the Azure Release Pipeline that publishes the release
112108

113-
This one is _really_ easy (as long as nothing is broken...): https://dev.azure.com/git-for-windows/git/_release?definitionId=1&_a=releases
109+
This one is _really_ easy (as long as nothing is broken...): add a PR comment with [the `/release` slash command](https://github.com/git-for-windows/gfw-helper-github-app?tab=readme-ov-file#release).
114110

115111
Note: The `pacman` upload always takes this long.
116112

117-
Sadly, things are broken a lot. In those cases, the logs have to be analyzed, and the Pipeline needs to be edited (when it asks whether you want to edit for this release only, do say that you want that), and the deployment has to be restarted. Examples for failures that happened in the past:
113+
Sadly, things are broken a lot. In those cases, the logs have to be analyzed, and the GitHub workflow definition needs to be edited (on the `release` branch of https://github.com/git-for-windows/git-for-windows-automation), and the failing jobs of the workflow run have to be rerunExamples for failures that happened in the past:
118114

119115
- Timeouts while uploading the GitHub Release. In that case, the partially-populated draft release has to be deleted manually (first delete the assets, or it won't delete the release), and then re-deploy.
120116

0 commit comments

Comments
 (0)