mirror/vcpkg
1
0
Fork 0
mirror of https://github.com/microsoft/vcpkg.git synced 2024-12-11 23:49:01 +08:00
Code Issues Actions 1 Packages Projects Releases Wiki Activity
39b46237e4
vcpkg/docs/maintainers/internal/vcpkg_tool_release_process.md
Billy O'Neal 0abb2b2d88
Update vcpkg-tool to 2022-06-15 (#25226) 
* Update vcpkg-tool to 2022-06-15. See https://github.com/microsoft/vcpkg-tool/releases/tag/2022-06-15
* Add `=pass` entries from https://github.com/microsoft/vcpkg-tool/pull/579
* Cherry pick XUnit output from https://github.com/microsoft/vcpkg/pull/23477 which hooks up https://github.com/microsoft/vcpkg-tool/pull/585 (Thanks again @dg0yt !)
* Update release process document now that we can do the full tree rebuild to test the tool release before signing.

Thank you:

@autoantwort 
@christophe-calmejane 
@JackBoosY 
@benmcmorran
@hmoffatt 
@klalumiere 
@Thomas1664 
@Neumann-A 
@AenBleidd

for your contributions!

Fixes https://github.com/microsoft/vcpkg/issues/22686 .
Fixes https://github.com/microsoft/vcpkg/issues/21800 .
Fixes https://github.com/microsoft/vcpkg/issues/16216 .
Fixes https://github.com/microsoft/vcpkg/issues/15836 .

Full tree rebuild testing this update is: https://dev.azure.com/vcpkg/public/_build/results?buildId=73664&view=results
2022-06-15 11:20:52 -07:00

2.9 KiB
Raw Blame History

vcpkg_tool_release_process

This document describes the acceptance criteria / process we use when doing a vcpkg-tool update, such as https://github.com/microsoft/vcpkg/pull/23757

  1. Verify that all tests etc. are passing in the vcpkg-tool repo's main branch, and that the contents therein are acceptable for release. (Steps after this will sign code there, so this review is responsible gating what has access to code signing.)
  2. Check that the changes there are in fact the changes that we want in that release. (Be aware, you are responsible for what is about to be signed with a Microsoft code signing certificate by proceeding)
  3. Submit a new full tree rebuild by https://dev.azure.com/vcpkg/public/_build?definitionId=29 (microsoft.vcpkg.ci as of this writing) and queue a new build with the vcpkg-tool SHA overridden to the one you wish to use. Example: https://dev.azure.com/vcpkg/public/_build/results?buildId=73664&view=results
  4. (Probably the next day) Check over the failures and ensure any differences with the most recent full rebuild using the previous tool version are understood.
  5. On your machine, in a prompt changed to the vcpkg-tool repo, git fetch https://github.com/microsoft/vcpkg-tool main && git switch -d FETCH_HEAD
  6. git push https://devdiv.visualstudio.com/DevDiv/_git/vcpkg FETCH_HEAD:main
  7. Monitor the resulting signed build at: https://devdiv.visualstudio.com/DefaultCollection/DevDiv/_build?definitionId=13610 and/or manually submit one. (The push is supposed to automatically submit a build but that has been somewhat unstable at the time of this writing.)
  8. The signed build will automatically create a draft GitHub release at https://github.com/microsoft/vcpkg-tool/releases . Erase the contents filled in there and press the "auto generate release notes" button. Manually remove any entries created by the automated localization tools which will start with * LEGO: Pull request from juno/.
  9. Publish that draft release as "pre-release".
  10. Smoke test the 'one liner' installer: (Where 2022-06-15 is replaced with the right release name)
    • Powershell: iex (iwr https://github.com/microsoft/vcpkg-tool/releases/download/2022-06-15/vcpkg-init.ps1)
    • Batch: curl -L -o vcpkg-init.cmd https://github.com/microsoft/vcpkg-tool/releases/download/2022-06-15/vcpkg-init.ps1 && .\vcpkg-init.cmd
    • Bash: . <(curl https://github.com/microsoft/vcpkg-tool/releases/download/2022-06-15/vcpkg-init -L)
  11. In the vcpkg repo, draft a PR which updates bootstrap-vcpkg.sh and boostrap-vcpkg.ps1 with the new release date, and update SHAs as appropriate in the .sh script. (For example, see https://github.com/microsoft/vcpkg/pull/23757)
  12. Merge the tool update PR.
  13. Change the github release in vcpkg-tool from "prerelease" to "release". (This automatically updates the aka.ms links)