foster/denoland-deno
1
0
Fork 0
mirror of https://github.com/denoland/deno.git synced 2024-11-29 16:30:56 -05:00
Code Issues Packages 1 Wiki Activity
denoland-deno/tools/cut_a_release.md
David Sherret 6db8cbb650
chore: release crates for 1.13.2 (#11820)
2021-08-23 15:48:08 -04:00

2.6 KiB
Raw Blame History

Cutting a Deno release

During this process main branch (or any other branch that you're creating release from) should be frozen and no commits should land until the release is cut.

Updating deno_std

  1. Open a PR on the deno_std repo that bumps the version in version.ts and updates Releases.md

  2. Before merging the PR, make sure that all tests pass when run using binary produced from bumping crates (point 3. from below).

  3. Create a tag with the version number (without v prefix).

Updating the main repo

  1. Create a PR that does a minor version bump of all crates in bench_util, core, ext, runtime directories.

  2. Make sure CI pipeline passes.

  3. Publish all bumped crates to crates.io

Make sure that cargo is logged on with a user that has permissions to publish those crates.

This is done by running cargo publish in each crate, because of dependencies between the crates, it must be done in specific order:

  • deno_core - all crates depend on deno_core so it must always be published first
  • bench_util
  • crates in ext/ directory, publish in the following order:
    • broadcast_channel
    • console
    • ffi
    • tls
    • web
    • webgpu
    • webidl
    • websocket
    • webstorage
    • crypto
    • fetch
    • http
    • net
    • url
    • timers
  • runtime - this crate depends on deno_core and all crates in ext/ directory

If there are any problems when you publish, that require you to change the code, then after applying the fixes they should be committed and pushed to the PR.

  1. Once all crates are published merge the PR.

  2. Create a PR that bumps cli crate version and updates Releases.md.

  3. Make sure CI pipeline passes.

  4. Publish cli crate to crates.io

  5. Merge the PR.

  6. Create a tag with the version number (with v prefix).

  7. Wait for CI pipeline on the created tag branch to pass.

The CI pipeline will create a release draft on GitHub (https://github.com/denoland/deno/releases).

  1. Upload Apple M1 build to the release draft & to dl.deno.land.

  2. Publish the release on Github

  3. Update the Deno version on the website by updating https://github.com/denoland/deno_website2/blob/main/versions.json.

  4. Push a new tag to manual. The tag must match the tag from point 9; you don't need to create dedicated commit for that purpose, it's enough to tag the latest commit in that repo.

Updating deno_docker

  1. Open a PR on the deno_docker repo that bumps the Deno version in all Dockerfiles, the README and the example Dockerfile
  2. Create a tag with the version number (without v prefix).