deno ci

deno ci выполняет воспроизводимую установку для CI-сред, аналогично npm ci. Используйте эту команду в CI-скриптах и Dockerfile, если вам нужна одна команда, которую легко найти и которая гарантированно установит именно то, что указано в файле блокировки, — без расхождений, оставшихся после предыдущих запусков состояний и неожиданностей.

deno ci

Что делает команда

deno ci примерно эквивалентна следующей последовательности:

rm -rf node_modules
deno install --frozen

но обеспечивает более строгую обработку ошибок и понятнее сообщает об их причинах:

1. Требует наличия файла блокировки. Если deno.lock отсутствует или недоступен для чтения, deno ci завершится с ошибкой, а не создаст его. Это гарантирует, что при двух запусках для одного и того же коммита будут установлены одни и те же версии.
2. Сначала удаляет node_modules. Перед установкой удаляется любое устаревшее состояние, оставшееся после предыдущего шага CI (или случайно сохранённой установки для разработки), чтобы итоговая структура отражала только разрешённые файлом блокировки зависимости.
3. Фиксирует разрешение зависимостей с помощью --frozen. Если deno.json или package.json изменён без повторного запуска deno install для обновления файла блокировки, команда завершится с ошибкой. Так можно выявить ошибку «обновил версию, но забыл зафиксировать файл блокировки» до того, как она попадёт в production.

Если любая из этих проверок завершится ошибкой, установка не будет запущена.

Когда использовать

Общее правило: выбирайте deno ci, если установка должна быть воспроизводимой и файл блокировки не должен изменяться. Выбирайте deno install, если вы вносите изменения в зависимости.

Примеры

GitHub Actions

name: Test

on: [push, pull_request]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: denoland/setup-deno@v2
        with:
          deno-version: v2.x
      - run: deno ci
      - run: deno test
      - run: deno lint
      - run: deno fmt --check

Dockerfile для production

FROM denoland/deno:2.8.0
WORKDIR /app

# Copy the manifest files first so install caches well
COPY deno.json deno.lock package.json* ./
RUN deno ci --prod

# Then copy the rest of the source
COPY . .
CMD ["deno", "run", "-A", "main.ts"]

Разделение COPY на этапы «сначала манифесты, затем исходный код» позволяет Docker повторно использовать слой deno ci, пока зависимости не меняются.

Установка для production на хосте

deno ci --prod --skip-types

--prod исключает devDependencies из package.json. --skip-types удаляет пакеты @types/* как из импортов deno.json, так и из зависимостей package.json — это полезно для артефактов развёртывания, где типы увеличивают размер и не нужны во время выполнения.

Распространённые причины ошибок

См. также

• deno install — повседневная установка с полным описанием параметров
• Непрерывная интеграция — руководство по запуску Deno в GitHub Actions и других CI-системах
• deno audit — поиск известных уязвимостей в зависимостях; дополняет deno ci в CI
• deno approve-scripts — управление разрешёнными скриптами жизненного цикла npm

deno ci [OPTIONS]

deno ci

deno ci --prod