deno upgrade

Примеры

Обновление до последней версии

Используйте эту команду без параметров, чтобы обновить Deno до последней доступной версии:

deno upgrade
Checking for latest version
Version has been found
Deno is upgrading to version 1.38.5
downloading https://github.com/denoland/deno/releases/download/v1.38.5/deno-x86_64-apple-darwin.zip
downloading 100%
Upgrade done successfully

Обновление до определённой версии

Можно указать версию, до которой нужно выполнить обновление:

deno upgrade --version 1.37.0
Checking for version 1.37.0
Version has been found
Deno is upgrading to version 1.37.0
downloading https://github.com/denoland/deno/releases/download/v1.37.0/deno-x86_64-apple-darwin.zip
downloading 100%
Upgrade done successfully

Проверка доступного обновления без установки

Используйте флаг --dry-run, чтобы узнать, какие изменения будут выполнены, не запуская само обновление:

deno upgrade --dry-run
Checking for latest version
Version has been found
Would upgrade to version 1.38.5

Каналы

deno upgrade работает только с одним каналом за раз. Если аргумент не указан, выполняется обновление до последнего стабильного выпуска. Укажите название канала, чтобы вместо этого перейти на последнюю сборку этого канала:

# Latest stable release (the default)
deno upgrade

# Latest long term support (LTS) release
deno upgrade lts

# Latest release candidate
deno upgrade rc

# Latest canary build
deno upgrade canary

Указание только номера версии всегда означает стабильную версию. deno upgrade 2.9.3 устанавливает стабильную сборку версии 2.9.3, даже если сборка с тем же номером версии доступна и в другом канале:

deno upgrade 2.9.3

Поэтому, если вы используете канал LTS и запускаете deno upgrade 2.9.3, вы скачаете стабильную сборку и перейдёте со стабильной версии LTS. Чтобы остаться на LTS, выполните обновление с помощью deno upgrade lts.

Обратите внимание: deno upgrade lts всегда устанавливает последнюю версию LTS. Нельзя выбрать определённую сборку LTS по номеру версии, поскольку номер версии всегда соответствует стабильному каналу. Полное описание каналов и причин, по которым одному номеру версии могут соответствовать две разные сборки, см. в разделе Стабильность и выпуски.

Флаг --quiet

Флаг --quiet отключает диагностический вывод во время обновления. При использовании вместе с deno upgrade он скрывает индикаторы выполнения, информацию о загрузке и сообщения об успешном завершении.

deno upgrade --quiet

Этот параметр полезен в сценариях автоматизации и когда требуется более лаконичный вывод в CI-конвейерах.

Кэшированные загрузки

Загруженные бинарные файлы Deno кэшируются в $DENO_DIR/dl/. При повторной установке той же версии используется кэшированный архив, а не загружается новый. Для сборок canary старые записи удаляются автоматически, так что остаются только 10 последних версий.

Проверка контрольной суммы

Используйте флаг --checksum, чтобы проверить загруженный бинарный файл по известному хешу SHA-256. Это защищает от подмены в средах CI и системах с повышенными требованиями к безопасности:

deno upgrade --checksum=<sha256-hash> 2.7.0

Контрольные суммы SHA-256 публикуются в файлах .sha256sum вместе с архивами выпусков на GitHub:

curl -sL https://github.com/denoland/deno/releases/download/v2.7.0/deno-x86_64-unknown-linux-gnu.zip.sha256sum

Дельта-обновления

Начиная с Deno 2.8, deno upgrade при обновлении между недавними стабильными версиями загружает небольшие бинарные патчи (дельты) вместо полного архива выпуска. Обычно размер загрузки при этом сокращается с десятков мегабайт до нескольких мегабайт.

Если дельты доступны, они применяются автоматически — ничего дополнительно включать не нужно. Если патч отсутствует или не проходит проверку, deno upgrade незаметно для пользователя загружает полный архив.

Чтобы принудительно загрузить полный архив (например, в средах, где кэшируются архивы выпусков), укажите --no-delta:

deno upgrade --no-delta

Перед установкой каждого патча дельты и полученного бинарного файла выполняется проверка по контрольным суммам SHA-256, опубликованным вместе с выпуском.

Сборка canary

По умолчанию Deno обновляется из официальных выпусков GitHub. Чтобы получить последнюю сборку canary, укажите флаг сборки --canary:

# Upgrade to the latest canary build
deno upgrade --canary

Установка сборки из pull request

Начиная с Deno 2.8, deno upgrade pr <number> загружает бинарный файл, собранный CI для определённого PR проекта deno, и устанавливает его. Это удобно, когда нужно проверить исправление до его включения в выпуск.

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

# A `#` 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

Для этой подкоманды необходимо установить и пройти аутентификацию в CLI gh. deno upgrade использует gh, чтобы найти запуск CI для PR и загрузить соответствующий артефакт {profile}-{os}-{arch}-deno (например, release-linux-x86_64-deno), отдавая предпочтение сборкам для выпуска и переходя к отладочной сборке, если они недоступны. Перед заменой текущего исполняемого файла загруженный бинарный файл проверяется запуском.

deno upgrade [OPTIONS] [VERSION]...

deno upgrade

deno upgrade 1.45.0

deno upgrade 1.46.0-rc.1

deno upgrade 9bc2dd29ad6ba334fd57a20114e367d3c04763d4

deno upgrade stable

deno upgrade alpha

deno upgrade beta

deno upgrade rc

deno upgrade canary

deno upgrade pr 12345

deno upgrade --output $HOME/my_deno