# Розгортання застосунку

На цій сторінці сервер на TypeScript пакується в образ контейнера на основі `elide.dev/elide`.

## Написання застосунку

```ts
// server.ts
import { Hono } from "hono";

const app = new Hono();

app.use(async (c, next) => {
  await next();
  console.log(JSON.stringify({ method: c.req.method, path: c.req.path, status: c.res.status }));
});

app.get("/healthz", (c) => c.text("ok"));
app.get("/", (c) => c.json({ greeting: process.env.GREETING ?? "hello" }));

export default app;
```

```js
// healthcheck.mjs
const res = await fetch("http://127.0.0.1:8080/healthz");
process.exit(res.ok ? 0 : 1);
```

```json
{
  "name": "deploy-app",
  "type": "module",
  "dependencies": {
    "hono": "^4.7.0"
  }
}
```

Один раз виконайте `elide install --ecosystems=npm`, щоб записати `aube-lock.yaml`.

## Написання Dockerfile

```dockerfile
FROM elide.dev/elide:1.6.0
WORKDIR /app
COPY package.json aube-lock.yaml ./
RUN elide install --ecosystems=npm
COPY . .
EXPOSE 8080
HEALTHCHECK --interval=10s --timeout=3s CMD ["elide", "healthcheck.mjs"]
CMD ["--allow-read=/app,/root/.cache/aube", "--allow-net=api.example.com", "serve", "--no-tui", "--host", "0.0.0.0", "--port", "8080", "server.ts"]
```

```text
# .dockerignore
node_modules
.env
```

| Рядок | Навіщо |
| --- | --- |
| `FROM elide.dev/elide:1.6.0` | Точка входу образу — `elide`, тому `CMD` містить лише її аргументи. Теги: [Образи контейнерів](/docs/installation/containers). |
| `RUN elide install --ecosystems=npm` | Встановлює залежності всередині образу. `node_modules` посилається на `/root/.cache/aube`, тому `node_modules` із хоста не працюватиме. |
| `--host 0.0.0.0` | Обробник, експортований за замовчуванням, прив'язується до `127.0.0.1`, який недоступний ззовні контейнера. |
| `--no-tui` | Без цього прапорця `docker run -t` запускає термінальний інтерфейс, і вивід застосунку не потрапляє в `docker logs`. |
| `HEALTHCHECK` | В образі немає `curl` і `wget`; перевірку виконує короткий скрипт Elide. |

```bash
docker build -t my-app .
docker run -d --name my-app -p 8080:8080 -e GREETING=hi my-app
curl http://127.0.0.1:8080/
```

```text
{"greeting":"hi"}
```

`docker inspect --format '{{.State.Health.Status}}' my-app` виводить `healthy`, щойно проходить перша перевірка.
`docker stop` зупиняє сервер менш ніж за секунду з кодом виходу `143`.

## Передавання змінних оточення

`process.env` містить змінні контейнера; передайте їх через `docker run -e NAME=value` або параметр Docker
`--env-file .env`. Так конфігурація надходить без копіювання файла в образ.

Під час локального запуску в Elide 1.6.2 і новіших версіях лаунчер автоматично читає `.env` та `.env.local`.
Вибирайте інші файли через `--env-file` або вимикайте завантаження через `--no-env`. Elide не встановлює `NODE_ENV`.
Про пріоритет див. [Оточення та властивості](/docs/environment), про доступ із JavaScript — [Змінні оточення](/docs/env-variables).

## Обмеження сервера

Програми працюють без обмежень, доки не задано прапорець пісочниці. Дайте серверу те, що йому потрібно, і нічого
більше:

| Прапорець | У Dockerfile вище |
| --- | --- |
| `--allow-read=PATHS` | `/app` і сховище npm `/root/.cache/aube`. |
| `--allow-net=HOSTS` | Вихідні хости. Для прослуховування порту дозвіл не потрібен. |
| `--allow-run=CMDS` | Не задано: підпроцеси залишаються дозволеними. Вкажіть список, щоб обмежити їх. |
| `--deny-net=HOSTS` | Хости, заблоковані навіть за наявності дозволу, наприклад `--deny-net=169.254.169.254`. |
| `--max-mem=SIZE`, `--timeout=DURATION` | Розмір купи й загальний час роботи. |

Глобальні прапорці вказуються перед командою (`serve`, `run`). `--deny-net` і `--deny-run` потребують форми з `=`.
Якщо сховища npm немає в `--allow-read`, сервер зупиняється під час запуску:

```text
Error: Filesystem read denied by policy: /app/node_modules/hono
```

Заблокований вихідний виклик називає прапорець:

```text
fetch to '169.254.169.254:80' denied by --deny-net
```

Усі прапорці: [Пісочниця та обмеження](/docs/sandbox).

## Читання журналів

`console.log` пише в stdout, а `console.error` — у stderr; `docker logs` показує обидва потоки:

```text
{"method":"GET","path":"/healthz","status":200}
{"method":"GET","path":"/","status":200}
```

`elide serve --no-tui` не виводить журнал доступу, а обробник, який кинув виняток, відповідає `500`, не виводячи
помилку. Записуйте запити й помилки в журнал із застосунку або експортуйте спани запитів, метрики й помилки через
[OpenTelemetry](/docs/opentelemetry).

## Розгортання застосунку JVM

- Зберіть образ JVM з `elide.pkl` за допомогою артефакту `ContainerImage`: [JVM-контейнери](/docs/toolchain/jvm/containers).
- Скомпілюйте нативний виконуваний файл: [Native Image](/docs/toolchain/jvm/native-image).
