Skip to content

docs: document deno upgrade pr (2.8) #3087

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
lunadogbot wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs: document deno upgrade pr (2.8) #3087

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 27 additions & 0 deletions runtime/reference/cli/upgrade.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -97,3 +97,30 @@ the `--canary` build flag for the latest canary build:
# Upgrade to the latest canary build
deno upgrade --canary
```

## Install a build from a pull request

Starting in Deno 2.8, `deno upgrade pr <number>` downloads the binary built by
CI for a specific deno PR and installs it. This is handy when you need to
verify a fix before it has shipped in a release.

```sh
# Install the binary built by CI for PR #12345
deno upgrade pr 12345

# Numeric prefix is also accepted
deno upgrade pr '#12345'

# Write to a path instead of replacing the current binary
deno upgrade --output ./deno-test pr 12345

# See what would be downloaded without replacing
deno upgrade --dry-run pr 12345
```

This subcommand requires the [`gh` CLI](https://cli.github.com/) to be
installed and authenticated. `deno upgrade` uses `gh` to look up the PR's CI
run and download the matching `{profile}-{os}-{arch}-deno` artifact (for
example `release-linux-x86_64-deno`), preferring release builds and falling
back to debug. The downloaded binary is verified to run before it replaces
the current executable.