re:re:actable
Урок 092 минуты чтения

Что такое Single Executable Applications в Node.js?

На этой странице
Кратко

Single Executable Applications, или SEA, позволяют упаковать Node.js-приложение в один исполняемый файл. Это удобно для CLI и internal tools, но для backend-сервисов чаще используют Docker image.

Вопрос

Что такое Single Executable Applications в Node.js?

Зачем SEA?

SEA нужен, чтобы:

  • распространять CLI без установки Node.js;
  • отдавать один executable пользователю;
  • упростить internal tooling;
  • зафиксировать runtime;
  • уменьшить setup для оператора.

Базовая идея

app.js + node binary + sea config -> executable

Пример config:

{
  "main": "./dist/cli.js",
  "output": "./dist/my-cli",
  "assets": {
    "help.txt": "./assets/help.txt"
  }
}

Сборка:

node --build-sea sea-config.json

Детальный процесс зависит от OS: на macOS/Windows может понадобиться подпись бинарника.

Как читать assets?

import { getAsset, getAssetKeys } from 'node:sea';
 
console.log(getAssetKeys());
 
const help = getAsset('help.txt', 'utf8');
console.log(help);

Когда SEA хороший выбор?

  • CLI;
  • миграционный tool;
  • internal admin utility;
  • self-contained dev tool;
  • agent/daemon для controlled environment.

Когда лучше Docker?

Для server backend обычно лучше Docker:

  • проще runtime config;
  • проще networking;
  • проще observability;
  • привычнее orchestration;
  • легче обновлять зависимости ОС;
  • не нужно думать о binary signing.

Что важно помнить

  • SEA упаковывает скрипт и бинарник Node.js в один исполняемый файл.
  • Удобно для CLI-утилит без установки Node.js у пользователя.
  • Код нужно собрать в один файл заранее (бандлером), нативные модули поддерживаются ограниченно.
  • Файл получается большим — в нем весь runtime Node.js.

Мини-шпаргалка

  • SEA упаковывает Node-приложение в executable.
  • Хорошо для CLI/tools.
  • node:sea читает bundled assets.
  • Для web backend чаще Docker.
  • API находится в active development, проверяй версию Node.js.

Документация

Node.js: Single executable applications.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам