deno deploy

Команда deno deploy предоставляет интерфейс командной строки для управления приложениями и их развертывания в Deno Deploy EA — платформе Deno для размещения приложений на JavaScript, TypeScript и WebAssembly.

При вызове без подкоманд deno deploy развертывает текущую локальную директорию в указанном приложении.

Аутентификация

Команда deploy использует безопасную аутентификацию на основе токенов, хранящихся в системном связке ключей:

• Автоматическая аутентификация: CLI запросит аутентификацию при необходимости
• Хранение токенов: токены Deploy безопасно хранятся в системной связке ключей
• Управление токенами: CLI предоставляет команды для получения, установки и удаления токенов аутентификации.

Глобальные параметры

• -h, --help — показать справочную информацию
• --org <name> — указать название организации
• --app <name> — указать название приложения
• --prod — развернуть непосредственно в рабочей среде

Подкоманды

Создание приложения

Создает новое приложение в Deno Deploy. При запуске без флагов интерактивный мастер проведет вас через каждый этап. Если указан любой параметр конфигурации, команда работает в неинтерактивном режиме (удобно для конвейеров CI/CD и сценариев).

deno deploy create [root-path]

Необязательный аргумент [root-path] задает локальную директорию проекта. По умолчанию используется текущая рабочая директория.

Общие параметры

• -h, --help — показать справочную информацию
• --org <name> — организация, в которой нужно создать приложение
• --app <name> — название приложения (используется в URL по умолчанию)
• --allow-node-modules — включить node_modules при загрузке
• --no-wait — не ждать завершения первой сборки
• --dry-run — проверить флаги и пройти весь процесс, не создавая приложение

Параметры источника

Эти флаги определяют источник кода приложения:

• --source <github|local> — развернуть из репозитория GitHub или локальной файловой системы
• --owner <name> — владелец/организация GitHub (обязателен, если источник — github)
• --repo <name> — название репозитория GitHub (обязательно, если источник — github)

Параметры конфигурации сборки

• --app-directory <path> — путь к директории приложения внутри проекта
• --framework-preset <preset> — использовать предустановку фреймворка с параметрами сборки по умолчанию. Поддерживаемые значения: astro, nextjs, nuxt, remix, solidstart, sveltekit, fresh, lume или "" (нет)
• --do-not-use-detected-build-config — не использовать автоматически определенные параметры сборки, а применять только указанные флаги
• --install-command <command> — команда установки (например, "deno install")
• --build-command <command> — команда сборки (например, "deno task build")
• --pre-deploy-command <command> — команда, которую нужно выполнить после сборки, но до развертывания

Параметры режима выполнения

• --runtime-mode <dynamic|static> — запускать приложение как сервер или статический сайт

Динамический режим (сервер):

• --entrypoint <file> — файл точки входа (например, main.ts)
• --arguments <arg> — аргументы, передаваемые точке входа (можно указать несколько раз)
• --working-directory <path> — рабочая директория процесса

Статический режим (статический сайт):

• --static-dir <dir> — директория со статическими файлами для раздачи
• --single-page-app — отдавать index.html для маршрутов, которым не соответствует файл (вместо возврата 404)

Параметры ресурсов сборки

• --build-timeout <minutes> — время ожидания сборки. Допустимые значения: 5, 10, 15, 20, 25, 30
• --build-memory-limit <megabytes> — ограничение памяти для сборки в МБ. Допустимые значения: 1024, 2048, 3072, 4096
• --region <region> — регион развертывания. Допустимые значения: us, eu, global

Интерактивный мастер

При запуске deno deploy create без флагов интерактивный мастер проведет вас через каждый этап настройки:

1. Организация — выберите организацию, в которой нужно создать приложение
2. Название приложения — выберите название приложения
3. Источник — разверните приложение из GitHub или локальной директории
4. Репозиторий GitHub (если выбран GitHub) — выберите владельца и репозиторий
5. Директория приложения — выберите директорию в проекте (элементы рабочей области определяются автоматически)
6. Конфигурация сборки — параметры фреймворка определяются автоматически. Можно принять найденную конфигурацию или настроить параметры вручную (предустановка фреймворка, команды установки и сборки, режим выполнения и т. д.)
7. Время ожидания сборки — максимальная продолжительность сборки
8. Ограничение памяти для сборки — объем памяти, выделяемый для сборки
9. Регион — место развертывания (us, eu или global)
10. Подтверждение — проверьте настройки и подтвердите создание

Примеры

Создание приложения в интерактивном режиме:

deno deploy create

Создание локального динамического приложения с указанием всех флагов (неинтерактивный режим):

deno deploy create \
  --org my-org \
  --app my-api \
  --source local \
  --runtime-mode dynamic \
  --entrypoint main.ts \
  --install-command "deno install" \
  --build-command "deno task build" \
  --build-timeout 5 \
  --build-memory-limit 1024 \
  --region us

Создание статического сайта:

deno deploy create \
  --org my-org \
  --app my-site \
  --source local \
  --runtime-mode static \
  --static-dir dist \
  --single-page-app \
  --build-command "deno task build" \
  --build-timeout 10 \
  --build-memory-limit 2048 \
  --region us

Использование предустановки фреймворка (нужно меньше флагов, поскольку предустановка задает значения по умолчанию):

deno deploy create \
  --org my-org \
  --app my-fresh-app \
  --source local \
  --framework-preset fresh \
  --build-timeout 5 \
  --build-memory-limit 1024 \
  --region us

Развертывание из репозитория GitHub:

deno deploy create \
  --org my-org \
  --app my-app \
  --source github \
  --owner my-github-org \
  --repo my-repo \
  --framework-preset astro \
  --build-timeout 10 \
  --build-memory-limit 2048 \
  --region global

Управление переменными окружения

Управление переменными окружения развернутых приложений.

deno deploy env

Параметры:

• -h, --help — показать справочную информацию
• --org <name> — название организации
• --app <name> — название приложения

Просмотр переменных окружения

deno deploy env list

Выводит список всех переменных окружения приложения.

Добавление переменной окружения

deno deploy env add <variable> <value>

Добавляет переменную окружения в приложение.

Параметры:

• --secret — пометить переменную как секретную. Значения секретных переменных скрыты на панели управления и в выводе env list.

deno deploy env add DATABASE_URL "postgresql://user:pass@localhost/db"

# Add a secret environment variable
deno deploy env add API_KEY "sk-secret-value" --secret

Изменение значения переменной окружения

deno deploy env update-value <variable> <value>

Изменяет значение существующей переменной окружения.

deno deploy env update-value API_KEY "new-api-key-value"

Указание контекстов переменных окружения

Переменные окружения можно сделать доступными в определенных контекстах, таких как Production, Preview, Local и Build.

deno deploy env update-contexts <variable> [contexts...]

Изменяет контексты переменной окружения в приложении:

Удаление переменной окружения

deno deploy env delete <variable>

Удаляет переменную окружения из приложения.

deno deploy env delete OLD_API_KEY

Загрузка переменных окружения из файла

deno deploy env load <file>

Загружает переменные окружения из файла .env в приложение. CLI автоматически определяет вероятные секреты по их названиям (например, ключи, содержащие SECRET, TOKEN, PASSWORD и т. д.) и помечает их соответствующим образом.

Параметры:

• --non-secrets <keys...> — ключи из файла .env, которые следует считать несекретными; переопределяет автоматическое определение

deno deploy env load .env.production

# Load and treat specific keys as non-secrets
deno deploy env load .env.production --non-secrets PUBLIC_URL SITE_NAME

Управление базами данных

Управление экземплярами баз данных вашей организации.

deno deploy database

Параметры:

• -h, --help — показать справочную информацию
• --org <name> — название организации

Создание экземпляра базы данных

deno deploy database provision <name> --kind <denokv|prisma> [--region <region>]

Создает новый экземпляр базы данных.

Параметры:

• --kind <denokv|prisma> — тип создаваемой базы данных (обязательно)
• --region <region> — основной регион базы данных (обязателен для Prisma)

# Provision a Deno KV database
deno deploy database provision my-kv-db --kind denokv

# Provision a Prisma Postgres database
deno deploy database provision my-pg-db --kind prisma --region us-east-1

Подключение внешней базы данных

deno deploy database link <name> [connectionString]

Подключает внешнюю базу данных PostgreSQL к вашей организации. Можно указать строку подключения или использовать отдельные флаги.

Параметры:

• --hostname <host> — имя хоста базы данных (нельзя использовать вместе со строкой подключения)
• --username <user> — имя пользователя базы данных (нельзя использовать вместе со строкой подключения)
• --password <pass> — пароль базы данных (нельзя использовать вместе со строкой подключения)
• --port <number> — порт базы данных (нельзя использовать вместе со строкой подключения)
• --cert <cert> — сертификат SSL для подключения
• --dry-run — проверить подключение, не выполняя фактическое связывание

# Link using a connection string
deno deploy database link my-db "postgres://user:pass@host:5432/mydb"

# Link using individual flags
deno deploy database link my-db \
  --hostname db.example.com \
  --username admin \
  --password secret \
  --port 5432

# Test the connection first
deno deploy database link my-db "postgres://user:pass@host:5432/mydb" --dry-run

Назначение базы данных приложению

deno deploy database assign <name> [--app <name>]

Назначает экземпляр базы данных приложению. Если --app не указан, будет предложено выбрать базу данных в интерактивном режиме.

deno deploy database assign my-db --app my-api

Отключение базы данных от приложения

deno deploy database detach <name> [--app <name>]

Удаляет связь между экземпляром базы данных и приложением.

deno deploy database detach my-db --app my-api

Выполнение запроса к базе данных

deno deploy database query <name> <database> [query...]

Выполняет SQL-запрос к базе данных.

deno deploy database query my-db mydb "SELECT * FROM users LIMIT 10"

Просмотр списка баз данных

deno deploy database list [search]

Выводит список всех экземпляров баз данных организации. Также доступно как database ls.

# List all databases
deno deploy database list

# Filter by name
deno deploy database list my-db

Удаление базы данных

deno deploy database delete <name>

Безвозвратно удаляет экземпляр базы данных. Также доступно как database remove или database rm.

deno deploy database delete my-old-db

Смена организации и приложения

Задает организацию и приложение по умолчанию для последующих команд, чтобы каждый раз не указывать --org и --app.

deno deploy switch [--org <name>] [--app <name>]

При запуске без флагов появится интерактивный запрос, позволяющий выбрать организацию и приложение.

Параметры:

• --org <name> — организация, на которую нужно переключиться
• --app <name> — приложение, на которое нужно переключиться

# Switch interactively
deno deploy switch

# Switch to a specific org and app
deno deploy switch --org my-company --app my-api

Выход из системы

Удаляет сохраненный токен аутентификации.

deno deploy logout

Журналы приложения

Передает журналы развернутого приложения в режиме реального времени.

deno deploy logs

Параметры:

• -h, --help — показать справочную информацию
• --org <name> — название организации
• --app <name> — название приложения
• --start <date> — начальная временная метка журналов
• --end <date> — конечная временная метка журналов (требуется --start)

deno deploy logs --org my-org --app my-app --start "2024-01-01T00:00:00Z"

Управление песочницами

Взаимодействуйте с работающими песочницами непосредственно из Deploy CLI.

deno deploy sandbox --help

Параметры:

• -h, --help — показать справочную информацию
• --token <token> — переопределить токен аутентификации для операций с песочницей
• --config <path> — пользовательский путь к файлу конфигурации Deploy CLI
• --org <name> — организация, которой принадлежат песочницы

Просмотр списка песочниц

deno deploy sandbox list --org my-org

Выводит список всех песочниц организации вместе с информацией об их состоянии.

Остановка песочницы

deno deploy sandbox kill <sandbox-id> --org my-org

Немедленно завершает работу указанной песочницы, если она больше не нужна.

Подключение к песочнице по SSH

deno deploy sandbox ssh <sandbox-id> --org my-org

Открывает SSH-сеанс с работающей песочницей для интерактивной отладки.

Настройка облачных подключений

Команда deploy включает инструменты для настройки интеграций, которые можно использовать в приложениях в качестве облачных подключений.

Настройка интеграции с AWS

Настройте интеграцию с AWS, чтобы использовать ее в приложении в качестве облачного подключения.

deno deploy setup-aws --org <name> --app <name>

Параметры:

• -h, --help — показать справочную информацию
• --org <name> — название организации (обязательно)
• --app <name> — название приложения (обязательно)

deno deploy setup-aws --org my-org --app my-app

Настройка интеграции с Google Cloud Platform

Настройте интеграцию с Google Cloud Platform, чтобы использовать ее в приложении в качестве облачного подключения.

deno deploy setup-gcp --org <name> --app <name>

Параметры:

• -h, --help — показать справочную информацию
• --org <name> — название организации (обязательно)
• --app <name> — название приложения (обязательно)

deno deploy setup-gcp --org my-org --app my-app

Примеры использования

Базовое развертывание

# Deploy current directory to production
deno deploy --prod

# Deploy with specific org and app
deno deploy --org my-company --app my-api --prod

Создание приложений

# Start the interactive creation wizard
deno deploy create

# Create with a framework preset
deno deploy create --org my-company --app my-site \
  --source local --framework-preset fresh \
  --build-timeout 5 --build-memory-limit 1024 --region us

# Create a static site from a GitHub repo
deno deploy create --org my-company --app my-docs \
  --source github --owner my-github-org --repo my-docs-repo \
  --runtime-mode static --static-dir dist --single-page-app \
  --build-command "npm run build" \
  --build-timeout 10 --build-memory-limit 2048 --region global

Смена контекста

# Set a default org and app so you don't have to pass --org/--app every time
deno deploy switch --org my-company --app my-api

# Now these commands use the saved org and app automatically
deno deploy env list
deno deploy logs

Управление базами данных

# Provision a Deno KV database
deno deploy database provision my-kv --kind denokv --org my-company

# Link an external PostgreSQL database
deno deploy database link my-pg "postgres://user:pass@host:5432/db" --org my-company

# Assign a database to an app
deno deploy database assign my-kv --app my-api

# Query a database
deno deploy database query my-pg mydb "SELECT count(*) FROM users"

Настройка окружения

# Set up environment variables
deno deploy env add DATABASE_URL "postgresql://..." --secret
deno deploy env add SITE_NAME "My App"

# Load from .env file
deno deploy env load .env.production

Мониторинг

# View recent logs
deno deploy logs --org my-company --app my-api

# View logs for specific time range
deno deploy logs --org my-company --app my-api \
  --start "2024-01-01T00:00:00Z" \
  --end "2024-01-01T23:59:59Z"

Интеграция с облачными сервисами

# Set up AWS integration
deno deploy setup-aws --org my-company --app my-api

# Set up GCP integration
deno deploy setup-gcp --org my-company --app my-api

Справка

• Используйте deno deploy --help для получения общей справки
• Используйте deno deploy <subcommand> --help для получения справки по конкретной подкоманде
• Сведения о платформе см. в документации Deno Deploy

deno deploy [OPTIONS] [args]...