На цій сторінці сервер на TypeScript пакується в образ контейнера на основі elide.dev/elide.
Написання застосунку
// 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;
// healthcheck.mjs
const res = await fetch("http://127.0.0.1:8080/healthz");
process.exit(res.ok ? 0 : 1);
{
"name": "deploy-app",
"type": "module",
"dependencies": {
"hono": "^4.7.0"
}
}
Один раз виконайте elide install --ecosystems=npm, щоб записати aube-lock.yaml.
Написання 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"]
# .dockerignore
node_modules
.env
| Рядок | Навіщо |
|---|---|
FROM elide. | Точка входу образу — elide, тому CMD містить лише її аргументи. Теги: Образи контейнерів. |
RUN elide install --ecosystems= | Встановлює залежності всередині образу. 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. |
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/
{"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.
Про пріоритет див. Оточення та властивості, про доступ із JavaScript — Змінні оточення.
Обмеження сервера
Програми працюють без обмежень, доки не задано прапорець пісочниці. Дайте серверу те, що йому потрібно, і нічого більше:
| Прапорець | У Dockerfile вище |
|---|---|
--allow-read=PATHS | /app і сховище npm /root/.cache/aube. |
--allow-net=HOSTS | Вихідні хости. Для прослуховування порту дозвіл не потрібен. |
--allow-run=CMDS | Не задано: підпроцеси залишаються дозволеними. Вкажіть список, щоб обмежити їх. |
--deny-net=HOSTS | Хости, заблоковані навіть за наявності дозволу, наприклад --deny-net=. |
--max-mem=SIZE, --timeout=DURATION | Розмір купи й загальний час роботи. |
Глобальні прапорці вказуються перед командою (serve, run). --deny-net і --deny-run потребують форми з =.
Якщо сховища npm немає в --allow-read, сервер зупиняється під час запуску:
Error: Filesystem read denied by policy: /app/node_modules/hono
Заблокований вихідний виклик називає прапорець:
fetch to '169.254.169.254:80' denied by --deny-net
Усі прапорці: Пісочниця та обмеження.
Читання журналів
console.log пише в stdout, а console.error — у stderr; docker logs показує обидва потоки:
{"method":"GET","path":"/healthz","status":200}
{"method":"GET","path":"/","status":200}
elide serve --no-tui не виводить журнал доступу, а обробник, який кинув виняток, відповідає 500, не виводячи
помилку. Записуйте запити й помилки в журнал із застосунку або експортуйте спани запитів, метрики й помилки через
OpenTelemetry.
Розгортання застосунку JVM
- Зберіть образ JVM з
elide.pklза допомогою артефактуContainerImage: JVM-контейнери. - Скомпілюйте нативний виконуваний файл: Native Image.