> For the complete documentation index, see [llms.txt](https://docs.edgegap.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.edgegap.com/ru/web-games.md).

# Веб-игры (JS/TS) — начало работы

Разверните свой первый выделенный сервер на JavaScript или TypeScript в Edgegap. Практическое руководство с минимальным шаблоном Node.js, загрузкой и глобальным развертыванием для браузерных многопользовательских игр.

Учитесь на практике и разверните свой первый выделенный сервер на Edgegap. К концу этого руководства вы бесплатно развернёте выделенный сервер с Edgegap.

{% hint style="info" %}
**В этом руководстве используется минимальный шаблон WebSocket-сервера на Node.js**, который работает с любым браузерным игровым клиентом — Three.js, Babylon.js, PlayCanvas, Phaser или вашим собственным движком. Серверы, созданные с фреймворками вроде Colyseus или работающие на Bun и Deno, следуют тем же шагам.
{% endhint %}

## ✔️ Подготовка

Прежде чем начать, обязательно [создайте бесплатную учетную запись в Edgegap](https://app.edgegap.com/auth/register) (кредитная карта не требуется). Вы можете [позже пригласить членов вашей команды](https://app.edgegap.com/user-settings?tab=organizations), даже если у них ещё нет учётной записи Edgegap.

**Настройте несколько основных параметров на вашей машине для разработки:**

<details>

<summary><a href="https://nodejs.org/en/download">Установите Node.js 22 или новее</a></summary>

* [Установите Node.js из официального источника](https://nodejs.org/en/download), мы рекомендуем последнюю LTS-версию.
* Проверьте установку, выполнив `node -v` в командной строке.

</details>

<details>

<summary><a href="https://www.docker.com/products/docker-desktop/">Установите Docker Desktop (или Docker CLI)</a></summary>

* [Установите Docker Desktop из официального источника](https://www.docker.com/products/docker-desktop/) (аккаунт не требуется).
* Перезагрузите компьютер после завершения установки.

</details>

{% hint style="info" %}
**Уверены в своих сборках сервера?** Перейдите к [#customize-image](#customize-image "mention") или [Дополнительные возможности](https://docs.edgegap.com/ru/learn/advanced-features.md) для подробностей.
{% endhint %}

## ⚙️ 1. Подключение аккаунта

JavaScript-серверам не нужен плагин движка. Мы будем использовать вашу командную строку и наш [Панель управления](https://app.edgegap.com/) для сборки, загрузки и развертывания вашего сервера.

☑️ Войдите в нашу Панель управления и откройте [Container Registry](https://app.edgegap.com/registry-management/repositories/list). Запомните ваше **имя проекта** и **учётные данные реестра** (имя пользователя и токен), они понадобятся на следующих шагах.

☑️ Войдите в [Container Registry Edgegap](https://docs.edgegap.com/ru/learn/advanced-features/edgegap-container-registry.md) через Docker, используя имя проекта реестра, имя пользователя и токен:

{% tabs %}
{% tab title="Bash (Linux)" %}

```bash
project='<REGISTRY_PROJECT>';
username='robot$<REGISTRY_ORGANIZATION_ID>+client-push';
token='<REGISTRY_TOKEN>';

echo "$token" | docker login registry.edgegap.com -u "$username" --password-stdin 2>&1
```

{% endtab %}

{% tab title="PowerShell (Windows)" %}

```powershell
$project = '<REGISTRY_PROJECT>'
$username = 'robot$<REGISTRY_ORGANIZATION_ID>+client-push'
$token = '<REGISTRY_TOKEN>'

echo "$token" | docker login registry.edgegap.com -u "$username" --password-stdin 2>&1
```

{% endtab %}
{% endtabs %}

☑️ Проверьте, что вы видите `Вход выполнен успешно` в командной строке.

✅ Теперь вы можете перейти к следующему шагу.

## 🔧 2. Сборка игрового сервера

Независимо от того, используете ли вы Windows, Mac или Linux, ваш **сервер будет работать в среде Linux**, поскольку большинство облачных провайдеров сегодня (включая Edgegap) работают на Linux. Хорошая новость — JavaScript кроссплатформенный, поэтому не нужно выполнять кросс-компиляцию, а Docker установит ваши зависимости для Linux на следующем шаге.

☑️ **Создайте новую папку для вашего сервера с двумя файлами.** Этот минимальный шаблон принимает WebSocket-соединения и пересылает каждое сообщение всем подключённым игрокам. Позже замените пересылку на игровую логику.

{% tabs %}
{% tab title="TypeScript - node.js 22.18+ (рекомендуется)" %}
{% hint style="info" %}
Node.js 22.18+ запускает файлы TypeScript напрямую (удаляет аннотации), шаг сборки не нужен.
{% endhint %}

1. Скопируйте шаблон `server.ts` в ваш проект (если у вас его ещё нет):<br>

   <pre class="language-javascript" data-title="server.ts" data-expandable="true" data-collapsed-line-count="10"><code class="lang-javascript">import http from 'node:http'
   import { WebSocketServer } from 'ws'
   import { DeploymentEnvironment } from '@edgegap/sdk'

   const port = Number(process.env.PORT ?? 7777)
   const deployment = process.env.ARBITRIUM_REQUEST_ID ? DeploymentEnvironment.fromEnv(process.env) : null

   const server = http.createServer((_request: http.IncomingMessage, response: http.ServerResponse) => response.end('ok\n'))
   const wss = new WebSocketServer({ server })

   wss.on('connection', (socket) => {
     console.log(`player connected (${wss.clients.size} online)`)
     socket.on('message', (data) => {
       for (const client of wss.clients) client.send(data.toString())
     })
     socket.on('close', () => console.log(`player left (${wss.clients.size} online)`))
   })

   server.listen(port, '0.0.0.0', () => {
     console.log(`listening on 0.0.0.0:${port}`)
     console.log(deployment ? `deployment ${deployment.requestId} in ${deployment.location?.city}` : 'running locally')
   })

   process.on('SIGTERM', () => {
     for (const client of wss.clients) client.close(1001, 'server stopping')
     server.close(() => process.exit(0))
   })
   </code></pre>
2. Скопируйте шаблон `package.json` в вашем проекте (или объедините с существующим).<br>

   <pre class="language-json" data-title="package.json" data-expandable="true" data-collapsed-line-count="10"><code class="lang-json">{
     "name": "my-game-server",
     "private": true,
     "type": "module",
     "engines": {
       "node": ">=22"
     },
     "scripts": {
       "start": "node server.ts"
     },
     "dependencies": {
       "@edgegap/sdk": "^1.1.0",
       "ws": "^8.18.3"
     }
   }
   </code></pre>
3. Установите определения типов для вашего редактора:<br>

   <pre class="language-bash" data-collapsed-line-count="10"><code class="lang-bash">npm install --save-dev @types/node @types/ws
   </code></pre>

{% hint style="warning" %}
**Удаление типов поддерживает только стираемый синтаксис.** Избегайте `enum`, `namespace`, а также свойств параметров конструктора, или [соберите сервер вместо этого](#customize-image).
{% endhint %}
{% endtab %}

{% tab title="JavaScript (ранний node.js)" %}

1. Скопируйте шаблон `server.js` в ваш проект (если у вас его ещё нет):<br>

   <pre class="language-javascript" data-title="server.js" data-expandable="true" data-collapsed-line-count="10"><code class="lang-javascript">import http from 'node:http'
   import { WebSocketServer } from 'ws'
   import { DeploymentEnvironment } from '@edgegap/sdk'

   const port = Number(process.env.PORT ?? 7777)
   const deployment = process.env.ARBITRIUM_REQUEST_ID ? DeploymentEnvironment.fromEnv(process.env) : null

   const server = http.createServer((_request, response) => response.end('ok\n'))
   const wss = new WebSocketServer({ server })

   wss.on('connection', (socket) => {
     console.log(`player connected (${wss.clients.size} online)`)
     socket.on('message', (data) => {
       for (const client of wss.clients) client.send(data.toString())
     })
     socket.on('close', () => console.log(`player left (${wss.clients.size} online)`))
   })

   server.listen(port, '0.0.0.0', () => {
     console.log(`listening on 0.0.0.0:${port}`)
     console.log(deployment ? `deployment ${deployment.requestId} in ${deployment.location?.city}` : 'running locally')
   })

   process.on('SIGTERM', () => {
     for (const client of wss.clients) client.close(1001, 'server stopping')
     server.close(() => process.exit(0))
   })
   </code></pre>
2. Скопируйте шаблон `package.json` в вашем проекте (или объедините с существующим).<br>

   <pre class="language-json" data-title="package.json" data-expandable="true" data-collapsed-line-count="10"><code class="lang-json">{
     "name": "my-game-server",
     "private": true,
     "type": "module",
     "engines": {
       "node": ">=22"
     },
     "scripts": {
       "start": "node server.js"
     },
     "dependencies": {
       "@edgegap/sdk": "^1.1.0",
       "ws": "^8.18.3"
     }
   }
   </code></pre>

{% endtab %}
{% endtabs %}

{% hint style="success" %}
`@edgegap/sdk` необязателен, этот шаблон использует его для чтения [внедрённых переменных](#injected-variables) на Edgegap. Используйте наш [JavaScript SDK](https://docs.edgegap.com/ru/web-games/matchmaking.md) для [#session-automation](#session-automation "mention"), или добавьте сторонний матчмейкер.
{% endhint %}

☑️ Установите зависимости и запустите сервер локально:

{% code collapsedlinecount="10" %}

```bash
npm install
npm start
```

{% endcode %}

☑️ Проверьте, что вы видите `listening on 0.0.0.0:7777` и `запущен локально` в консоли, затем остановите сервер с помощью `Ctrl+C`.

{% hint style="success" %}
Сборки сервера должны использовать адрес `0.0.0.0` и порт `7777`. Если вы измените порт, пожалуйста, укажите тот же самый в вашем [Приложения и версии](https://docs.edgegap.com/ru/learn/orkestraciya/application-and-versions.md#port-mapping) после того как вы [#id-5.-upload-to-edgegap](#id-5.-upload-to-edgegap "mention").
{% endhint %}

✅ Теперь вы можете перейти к следующему шагу.

## 🐋 3. Контейнеризация сервера

Работа в команде разработчиков предполагает совместное использование кода. Когда что-то идет не так, последнее, что вы хотите услышать — «у меня работает». Серверы игр должны надежно запускаться на любой машине, поскольку успешные игровые серверы работают на тысячах серверов по всему миру.

Чтобы сделать ваш сервер надежным, мы используем Docker — виртуализационное ПО, гарантирующее, что все зависимости вашего серверного кода вплоть до уровня операционной системы всегда будут точно такими же, независимо от того, как и где запускается сервер.

{% hint style="info" %}
Мы рекомендуем посмотреть [«Никогда не устанавливайте локально» (видео)](https://www.youtube.com/watch?v=J0NuOlA2xDc\&ab_channel=Coderized). **Вам НЕ нужно использовать Dockerhub с Docker**.  Docker ≠ Dockerhub. Думайте о Docker как о движке для программирования, а о Dockerhub — как о его магазине приложений.
{% endhint %}

☑️ Начните с выполнения `docker version` в командной строке, чтобы убедиться, что вы завершили [#preparation](#preparation "mention").

<details>

<summary><a href="https://www.docker.com/products/docker-desktop/">Установите Docker Desktop (или Docker CLI)</a></summary>

* [Установите Docker Desktop из официального источника](https://www.docker.com/products/docker-desktop/) (аккаунт не требуется).
* Перезагрузите компьютер после завершения установки.

</details>

☑️ **Добавьте Dockerfile и `.dockerignore` файл в папку вашего сервера**, рецепт для вашего образа:

{% tabs %}
{% tab title="TypeScript - node.js 22.18+ (рекомендуется)" %}
{% code title="Dockerfile" collapsedlinecount="10" %}

```docker
FROM node:22-slim
WORKDIR /app
ENV NODE_ENV=production
COPY package.json package-lock.json ./
RUN npm ci --omit=dev
COPY server.ts ./
USER node
CMD ["node", "server.ts"]
```

{% endcode %}
{% endtab %}

{% tab title="JavaScript (ранний node.js)" %}
{% code title="Dockerfile" collapsedlinecount="10" %}

```docker
FROM node:22-slim
WORKDIR /app
ENV NODE_ENV=production
COPY package.json package-lock.json ./
RUN npm ci --omit=dev
COPY server.js ./
USER node
CMD ["node", "server.js"]
```

{% endcode %}
{% endtab %}
{% endtabs %}

{% code title=".dockerignore" collapsedlinecount="10" %}

```
node_modules
.git
*.md
```

{% endcode %}

{% hint style="info" %}
**Запускайте сервер с помощью `node`, а не `npm start`.** Edgegap отправляет `SIGTERM` когда ваше развёртывание останавливается, и только основной процесс вашего контейнера получает его — обработайте это, чтобы реализовать корректное завершение работы.
{% endhint %}

☑️ Соберите образ, выбрав имя и тег образа:

{% code collapsedlinecount="10" %}

```bash
docker build --platform linux/amd64 \\
  -t registry.edgegap.com/<project>/<game-name>:<tag> .
```

{% endcode %}

* **Имя образа** — это уникальный идентификатор по вашему выбору, которым вы обозначаете сборку сервера перед публикацией.
  * Обычно сюда включают название игры — например, «my-game-server».
  * Добавьте префикс `registry.edgegap.com/<project>/` используя имя проекта из шага [#id-1.-connect-account](#id-1.-connect-account "mention"), чтобы потом можно было загрузить его.
* **Тег образа** — это идентификатор, указывающий на конкретную версию вашего образа.
  * Термин «артефакт сборки» иногда используется для обозначения конкретной версии вашего образа.
  * Временные метки — отличный вариант по умолчанию для тегов, например `2026.11.02-16.25.00-UTC` .
* **Платформа** `linux/amd64` гарантирует, что ваш образ будет работать на серверах Edgegap, даже если вы собираете его на машине с архитектурой ARM (macOS M1, M2, M3 и т. д.).

{% hint style="danger" %}
:x: **НЕ ДЕЛАЙТЕ — не перезаписывайте существующие теги и не используйте `latest`  тег** — это приведёт к развёртыванию устаревшего кэша.\
:white\_check\_mark: **ДЕЛАЙТЕ — всегда увеличивайте номер версии в теге** и развёртывайте новую сборку.
{% endhint %}

☑️ Дождитесь завершения сборки и убедитесь, что в командной строке нет новых ошибок. Выполнение этого шага приведёт к тому, что **на локальной машине появится новый образ**. Вы можете проверить это либо в Docker Desktop, на вкладке Images в разделе Local (по умолчанию), либо через CLI Docker, выполнив `docker images` .

✅ Теперь вы можете перейти к следующему шагу.

## 🧪 4. Тестирование сервера локально

Давайте попробуем развернуть локально (на вашей машине) и подключить игровой клиент, чтобы убедиться, что образ сервера работает правильно, прежде чем мы загружать и развертывать (что может занять некоторое время).

☑️ Запустите новый контейнер из вашего образа:

{% code collapsedlinecount="10" %}

```bash
docker run -p 7777/tcp registry.edgegap.com/<project>/<game-name>:<tag>
```

{% endcode %}

* `-p {внутренний порт}/{протокол}` публикует и сопоставляет порт вашего сервера `7777` с случайным внешним портом. WebSocket использует протокол TCP.
* Если вы используете машину с архитектурой ARM (macOS M1, M2, M3 и т. д.), добавьте параметр `--platform=linux/amd64` .

☑️ Проверьте, что вы видите `listening on 0.0.0.0:7777` в командной строке. Выполнение этого шага приведёт к тому, что **будет запущен новый контейнер** на вашей машине разработки.

{% hint style="info" %}
Для более подробной информации см. Docker Desktop / Containers или команду Docker CLI `docker ps` .
{% endhint %}

☑️ Теперь пришло время **подключить игровой клиент к вашему локальному Docker-контейнеру** чтобы проверить, что образ вашего сервера работает корректно. Откройте две вкладки браузера, откройте консоль инструментов разработчика (`F12`) в каждой вкладке и подключитесь к контейнеру, используя:

* `localhost` вместо IP сервера,
* случайное значение внешнего порта, указанное в Docker Desktop / Containers.

{% code collapsedlinecount="10" %}

```javascript
const socket = new WebSocket('ws://localhost:<external port>')
socket.onmessage = (event) => console.log('received', event.data)
```

{% endcode %}

☑️ Отправьте сообщение из одной вкладки с помощью `socket.send('hello')` и убедитесь, что обе вкладки выводят `received hello`.

<figure><img src="https://3845012722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2FCDGTUe5ests3DI3u9rTV%2Fimage.png?alt=media&amp;token=8c4799d8-0622-4142-91a5-93fd1816149c" alt=""><figcaption></figcaption></figure>

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

✅ Теперь вы можете перейти к следующему шагу.

## ☁️ 5. Загрузка в Edgegap

Пора разместить ваш сервер в интернете! Теперь, когда ваш образ успешно может обслуживать игроков, мы можем загрузить его в Edgegap и начать запускать в любой точке мира. В этом руководстве мы будем использовать [**Реестр контейнеров Edgegap**](https://docs.edgegap.com/ru/learn/advanced-features/edgegap-container-registry.md) (хранилище для образов).

☑️ Загрузите ваш образ в Container Registry Edgegap:

{% code collapsedlinecount="10" %}

```bash
docker push registry.edgegap.com/<project>/<game-name>:<tag>
```

{% endcode %}

{% hint style="success" %}
Найдите любое имя образа и тег, хранящиеся на вашем компьютере в **Docker Desktop / Образы**.
{% endhint %}

☑️ Дождитесь завершения загрузки и убедитесь, что в командной строке нет новых ошибок. Выполнение этого шага приведёт к тому, что ваш [артефакт сборки будет загружен в Container Registry Edgegap](https://app.edgegap.com/registry-management/repositories/list).

☑️ Откройте нашу [Панель управления](https://app.edgegap.com/application-management/applications/list) и создайте новое приложение. Вы можете настроить следующие параметры (или оставить значения по умолчанию):

* **Имя приложения** на Edgegap может совпадать с именем вашего образа или быть настроено вручную.
* **Версия приложения** на Edgegap может совпадать с вашим тегом или быть настроена вручную.
  * Временные метки — отличный вариант для названий версий приложения, например `2026.11.02-16.25.00-UTC` .
  * Несколько версий приложения могут указывать на один и тот же тег образа, например `v1.1.0` и `dev` .
  * Узнайте больше о [приложениях и версиях](https://docs.edgegap.com/ru/learn/orkestraciya/application-and-versions.md) позже.
* **Образ** из шага [#id-3.-containerize-server](#id-3.-containerize-server "mention"), выберите свой репозиторий и тег.
* **Ресурсы** 0,25 vCPU и 512 МБ памяти вполне достаточно, чтобы начать работу с этим шаблоном.

☑️ Теперь вас попросят указать порт для новой версии приложения:

* **Порт** `7777` соответствующий порту вашего сервера из шага [#id-2.-build-game-server](#id-2.-build-game-server "mention"),
* **Протокол** `WS` (WebSocket),
* **TLS Upgrade** включён,
* **Имя** `gameport`.

{% hint style="info" %}
**TLS Upgrade позволяет браузерам подключаться через защищённые WebSocket** (`wss://`). Страницы, обслуживаемые по `https://` не могут открывать незащищённые `ws://` соединения, поэтому для браузерных игр оставляйте TLS Upgrade включённым.
{% endhint %}

{% hint style="info" %}
Бесплатный тариф ограничен 2 приложениями, 2 версиями и 10 ГБ хранилища Container Registry.
{% endhint %}

{% hint style="success" %}
**Используете агент для кодирования?** Смотрите [MCP Integration](https://docs.edgegap.com/ru/docs/integraciya-mcp.md) чтобы создавать приложения, версии и развёртывания, не покидая редактор.
{% endhint %}

✅ Теперь вы можете перейти к следующему шагу.

## 🚀 6. Развертывание в облаке

Это последний шаг в этом руководстве, после которого у вас будет сервер, развернутый в облаке Edgegap, к которому игроки из любой точки мира смогут подключаться.

☑️ **Выберите приложение и версию** из предыдущего шага для развертывания.

☑️ Как только будете готовы, нажмите **Развернуть в облаке**, дождитесь достижения [/pages/4ad5d792bc82dceeaec6d7dd56165ae188da0417#id-3.-deployment-ready](https://docs.edgegap.com/pages/4ad5d792bc82dceeaec6d7dd56165ae188da0417#id-3.-deployment-ready "mention"). Выполнение этого шага приведёт к [запуску нового Развертывания](https://app.edgegap.com/deployment-management/deployments/list) в вашей учетной записи Edgegap.

☑️ Убедитесь, что в выводе консоли нет новых ошибок. Также проверьте, что ваши [Развертывания](https://docs.edgegap.com/ru/learn/orkestraciya/deployments.md#container-logs) не показывают ошибок и ваши [Развертывания](https://docs.edgegap.com/ru/learn/orkestraciya/deployments.md#container-metrics) не указывают на 100% загрузку ресурсов (vCPU или память), иначе новые подключения игроков могут быть отклонены, или ваш сервер застрянет в цикле перезапуска. См. ниже шаги по устранению неполадок для решения любых проблем.

☑️ Теперь мы выполним финальный тест и **подключим ваш игровой клиент к облачному развёртыванию**. Возьмите **Host развёртывания** вместо IP сервера и **внешний порт** из `gameport`, и подключитесь через защищённый WebSocket из консоли браузера:

{% code collapsedlinecount="10" %}

```javascript
const socket = new WebSocket('wss://<host>:<external port>')
socket.onmessage = (event) => console.log('received', event.data)
```

{% endcode %}

<figure><img src="https://3845012722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Fz9xjzvZwKSIp9IeC9qo8%2Fimage.png?alt=media&amp;token=e3f345ac-848d-4469-b66f-3655cd393cf3" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Внешний порт вашего развёртывания в облаке Edgegap будет выбран случайным образом, чтобы потенциальный злоумышленник (хакер) замедлялся и обнаруживался до того, как сможет нанести ущерб.
{% endhint %}

{% hint style="warning" %}
**Отключите VPN при тестировании** для более реалистичных условий и получения [развёртывания с низкой задержкой](https://docs.edgegap.com/ru/learn/orkestraciya/deployments.md#server-placement).
{% endhint %}

☑️ Как только вы убедитесь, что можете подключиться к вашему развёртыванию без проблем и завершите тестирование, **Остановите ваше развёртывание** чтобы освободить ресурсы в вашем аккаунте для следующей сборки.

* Если вы столкнётесь с проблемами, [просмотрите логи на Панели управления вашего развёртывания](https://app.edgegap.com/deployment-management/deployments/list).
* Если вы не сможете разобраться с проблемой, мы сидим в нашем [сообществе Discord](https://discord.gg/NgCnkHbsGp) и будем рады помочь.

🙌 Поздравляем с вашим первым развёртыванием в Edgegap! Если хотите узнать больше, продолжайте чтение.

## 👉 Следующие шаги

После того как у вас настроена рабочая клиент/серверная система, убедитесь, что **сохранили копию вашего проекта** (используя систему контроля версий, такую как git), чтобы вы всегда могли проследить свои шаги в случае возникновения проблем.

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

{% hint style="info" %}
Если вам нужна помощь, [свяжитесь с нами через Discord](https://discord.gg/MmJf8fWjnt). Для поддержки по играм в реальном времени см. нашу [систему тикетов](https://edgegap.atlassian.net/servicedesk/customer/portal/3).
{% endhint %}

### Остановка развёртываний

Когда матч заканчивается (или игроки уходят), ваше развёртывание можно остановить, чтобы сэкономить средства. [Пустые или лишь частично заполненные развёртывания могут неоправданно увеличивать ваши расходы!](https://edgegap.com/blog/how-session-fill-rate-affects-your-multiplayer-hosting-costs)

Останавливайте развёртывание из кода вашего сервера, после этого Edgegap отправит `SIGTERM` на ваш сервер:

{% code collapsedlinecount="10" %}

```javascript
const stopDeployment = () =>
  fetch(deployment.selfStopUrl, {
    method: 'DELETE',
    headers: { authorization: deployment.selfStopToken }
  }) // пример использует JavaScript SDK для чтения информации о самостоятельной остановке развёртывания
```

{% endcode %}

{% hint style="success" %}
**Вызовите `stopDeployment` когда матч завершён, когда все игроки ушли или когда никто не подключился** в разумное время после запуска развёртывания.
{% endhint %}

{% hint style="warning" %}
Подключите свой [Хранилище конечной точки](https://docs.edgegap.com/ru/docs/endpoint-storage.md) чтобы сохранять журналы развертывания, иначе они будут удалены!
{% endhint %}

### внедрённых переменных

Читайте полезную информацию, такую как ID развёртывания, IP-адрес сервера, местоположение сервера и многое другое, обращаясь к внедрённым переменным окружения. Каждое развёртывание автоматически включает:

* [Переменные развёртывания](https://docs.edgegap.com/ru/learn/orkestraciya/deployments.md#injected-environment-variables) — автоматически предоставляются Edgegap,
* [Переменные матчмейкинга](https://docs.edgegap.com/ru/learn/matchmeiking/matchmaker-in-depth.md#injected-environment-variables) — автоматически предоставляются Edgegap при использовании [Матчмейкинг](https://docs.edgegap.com/ru/learn/matchmeiking.md),
* [Переменные версии приложения](https://docs.edgegap.com/ru/learn/orkestraciya/application-and-versions.md#injected-variables) — настраиваемые парные ключ-значение, которые вы можете задать.

Читайте любую переменную с помощью `process.env`, или преобразуйте их в типизированные объекты с помощью нашего необязательного SDK:

{% code collapsedlinecount="10" %}

```javascript
import { DeploymentEnvironment } from '@edgegap/sdk'
import { MatchEnvironment } from '@edgegap/sdk/matchmaking'

const deployment = DeploymentEnvironment.fromEnv(process.env)
const match = MatchEnvironment.fromEnv(process.env)
```

{% endcode %}

{% hint style="info" %}
Парсинг никогда не вызывает ошибок, поэтому тот же сервер работает локально. Отсутствующие переменные перечисляются в одном предупреждении.
{% endhint %}

### Автоматизация сессий

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

{% hint style="warning" %}
**Ручного запуска развертываний и вставки URL и портов недостаточно для живой игры.**
{% endhint %}

Автоматизируйте популярные игровые сценарии для [Сеансы игроков](https://docs.edgegap.com/ru/learn/orkestraciya/seansy-igrokov.md) и масштабирования серверов с помощью одного из следующих вариантов:

{% columns %}
{% column width="33.33333333333333%" %}
[Матчмейкинг](https://docs.edgegap.com/ru/learn/matchmeiking.md):

* Соревновательные игры
* Матчи по запросу
* Рейтинг навыка и/или\
  Пользовательские правила
  {% endcolumn %}

{% column width="33.33333333333333%" %}
[Браузер серверов](https://docs.edgegap.com/ru/learn/brauzer-serverov.md):

* Постоянные или социальные
* Длительные сессии
* Автораспределение и/или\
  Пользовательский поиск
  {% endcolumn %}

{% column width="33.33333333333333%" %}
Пользовательский бэкенд:

* Переносите игры в продакшене
* [Развертывайте с API v2](https://docs.edgegap.com/ru/docs/api/vydelennye-servery.md)
* [Отслеживайте вебхуки](https://docs.edgegap.com/ru/learn/orkestraciya/deployments.md#webhooks)
  {% endcolumn %}
  {% endcolumns %}

{% hint style="success" %}
Добавьте матчмейкинг в свою браузерную игру с помощью нашего необязательного [JavaScript SDK](https://docs.edgegap.com/ru/web-games/matchmaking.md), включая групповой клиент и автоматизацию backfill-сервера.
{% endhint %}

### Примеры

[Вдохновитесь пятью браузерными многопользовательскими мини-играми, созданными с Three.js и авторитетными серверами Node.js.](https://docs.edgegap.com/ru/docs/sample-projects/veb-igry/threejs-minigames.md) Включает матчмейкинг из браузера, один образ для нескольких игр, назначение команд и развёртывания, которые останавливаются сами, когда матч заканчивается.

{% hint style="success" %}
[Просмотрите наши образцы игр](https://docs.edgegap.com/ru/docs/sample-projects.md) чтобы вдохновиться и обрести уверенность для продвижения вашего проекта.
{% endhint %}

### Оптимизация использования

Несколько советов, которые помогут начать оптимизировать использование вашего сервера:

**Более высокая частота тиков означает больше обновлений, что требует больше CPU и исходящего трафика данных.**

* Браузерные игры часто выполняют симуляцию с частотой 30–60 тиков в секунду и отправляют состояние игрокам с частотой 10–20 Гц, а клиенты интерполируют между обновлениями. Наш пример на Three.js отправляет 20 обновлений в секунду.
* Node.js запускает игровой цикл в одном потоке, поэтому медленный тик задерживает сообщения для каждого игрока. Будьте осторожны, если в вашей игре много игроков в матче (10+), сложные физические симуляции или много ботов-противников/союзников. Профилируйте сервер с помощью `node --cpu-prof` чтобы найти узкие места.
* JSON-сообщения легко отлаживать, двоичные сообщения (`ArrayBuffer`) уменьшают объём исходящих данных при частых обновлениях состояния.

**Как выбрать правильный сетевой протокол? Сначала заставьте работать, затем сделайте лучше.**

* Браузеры не могут открывать сырые UDP- или TCP-соединения, только WebSocket, WebRTC и WebTransport. WebSocket — отличный вариант по умолчанию, обеспечивающий совместимость с наибольшим количеством устройств и сетей.
* Некоторые динамичные игры могут захотеть поэкспериментировать с каналами данных WebRTC или WebTransport для ненадёжной доставки, но это, безусловно, потребует дополнительных усилий по разработке. Спросите себя, насколько это критично для вашей целевой аудитории.
* Выбирайте свои сражения осторожно: в разработке игр и так хватает сложностей.

### Настроить образ

Ваш Dockerfile из шага [#id-3.-containerize-server](#id-3.-containerize-server "mention") можно настроить для оптимизации размера сборки, удаления лишних зависимостей или более сложного процесса запуска. Теперь мы поделимся несколькими советами «сделай сам» и лучшими практиками.

**Соберите ваш сервер в один файл с помощью многоэтапной сборки.**

* Такие сборщики, как [esbuild](https://esbuild.github.io/) компилируют TypeScript и объединяют ваш код и зависимости в один файл, так что в вашем конечном образе не нужны `node_modules` или исходные файлы. Экономия растёт вместе с размером дерева зависимостей.
* Установите esbuild с помощью `npm install --save-dev esbuild` и замените ваш Dockerfile на:

{% code title="Dockerfile" collapsedlinecount="10" %}

```docker
FROM node:22-slim AS build
WORKDIR /app
COPY package.json package-lock.json ./
RUN npm ci
COPY server.js ./
RUN npx esbuild server.js --bundle --platform=node --target=node22 --outfile=dist/server.cjs

FROM node:22-slim
WORKDIR /app
ENV NODE_ENV=production
COPY --from=build /app/dist/server.cjs ./
USER node
CMD ["node", "server.cjs"]
```

{% endcode %}

**Всегда убедитесь, что вы работаете с рабочей сборкой сервера.**

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

**Всегда тестируйте локально перед загрузкой.**

* Локальное тестирование вашего образа сэкономит вам массу времени, пока вы ждёте завершения загрузки. Это также совершенно бесплатно ✨, поскольку не требует ресурсов Edgegap.
* При локальном тестировании обязательно правильно задайте внутренний порт:

  ```bash
  docker run \
    -p 7777/udp \
    -e ARBITRIUM_PORTS_MAPPING='{"ports":{"gameport":{"internal":7777}}}' \
    'registry.edgegap.com/<repository>:<tag>'
  ```

**Убедитесь, что у вас есть базовые навыки. Каждый Dockerfile нуждается в нескольких обязательных командах:**

* `FROM {image}` — это ваш базовый образ; обычно мы используем долгосрочно поддерживаемый Linux, но подойдёт любой базовый образ на Linux. Обычно это публичные образы, хранящиеся на Docker Hub. Справочник по Dockerfile здесь. [Справочник по Dockerfile здесь](https://docs.docker.com/reference/dockerfile/#from).
* `COPY {source} {destination}` чтобы скопировать вашу серверную сборку Linux с хост-машины внутрь образа, чтобы вы могли запустить её позже. [Справочник по Dockerfile здесь](https://docs.docker.com/reference/dockerfile/#copy).
* `USER {user}` должен следовать после команды [useradd (ubuntu)](https://manpages.ubuntu.com/manpages/bionic/man8/useradd.8.html) или эквивалентной; лучше не запускать всё от `root` на случай большей безопасности. [Справочник по Dockerfile здесь](https://docs.docker.com/reference/dockerfile/#user).
* `CMD {command}` будет последней строкой, скорее всего вызывающей `StartServer.sh` или какой-то скрипт запуска, чтобы убедиться, что ваш сервер корректно инициализируется после завершения настройки. [Справочник по Dockerfile здесь](https://docs.docker.com/reference/dockerfile/#cmd).
* НЕ используйте `VOLUME` — вы не сможете смонтировать таким образом какое-либо локальное хранилище на Edgegap; вместо этого рассмотрите нашу функцию Endpoint Storage и используйте S3 bucket, см. [Endpoint Storage](https://docs.edgegap.com/docs/deployment/endpoint-storage),
* `EXPOSE 7777/UDP`  не требуется! На самом деле это не сделает внутренний порт сервера доступным извне контейнера; это лишь подсказка для разработчика, а порт должен быть
  * опубликован при локальном тестировании с помощью `docker run <image> -p 7777/udp` ,
  * или сопоставлен в [Сопоставлении портов Edgegap](https://docs.edgegap.com/ru/learn/orkestraciya/application-and-versions.md#other-parameters-optional).

**Откладывайте объявление параметров до самого последнего возможного момента. Из-за долгого времени сборки сервера конфигурируемость важнее компонуемости.** [**Применяйте этот подход к командам Dockerfile, чтобы быстрее собирать и загружать.**](https://medium.com/@esotericmeans/optimizing-your-dockerfile-dc4b7b527756)

* Сценарий: вам нужно определить параметры, такие как стадия развертывания, версия, режим игры, карта, число игроков на сервер, частота резервного копирования или подобное.
* Плохое решение: создавать отдельный образ для каждой комбинации ваших параметров. Вы потратите всё своё время на пересборку образов, получив при этом очень мало пользы от такого подхода.
* Лучшее решение — подставлять параметры конфигурации в последний момент:
  1. параметры развертывания — передаются непосредственно перед выполнением развертывания — селекторы матчмейкинга передаются как переменные среды, или ваша собственная система управления сессиями передаёт переменные среды во время развертывания,
  2. параметры версии — общие для всех развертываний в версии приложения — стадия развертывания, тег артефакта, секреты и конечные точки сторонних сервисов и подобное; затем
  3. один-единственный образ — содержит и загружает все параметры конфигурации при запуске.

**НЕ запускайте базы данных в развертываниях Edgegap.**

* Развертывания Edgegap не предназначены для длительно работающих процессов и могут быть завершены после долгого времени работы без предварительного уведомления. База данных (даже распределённая), работающая таким образом, может быть завершена, что приведёт к необратимой потере данных. Если вам нужна база данных, рассмотрите сторонний DBaaS.
* Рассмотрите использование наших [Управляемых кластеров](https://app.edgegap.com/cluster-management/clusters/list) для размещения баз данных и длительно работающих сервисов.
