> 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/learn/orkestraciya/deployments.md).

# Развертывания

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

Узнайте о развертываниях и их жизненном цикле — концепции и лучшие практики для более глубокого понимания.

## 🗺️ Оркестрация

Запускайте новые серверы за считанные секунды, чтобы удовлетворять требованиям по мощности с нашим облачно-нативным подходом к периферийным вычислениям. Мы рассматриваем серверы как [скот, а не питомцев](https://cloudscaling.com/blog/cloud-computing/the-history-of-pets-vs-cattle/) - полностью заменяя неисправные экземпляры вместо того, чтобы вручную заботиться о каждом из них.

{% hint style="info" %}
Ваш выбор оркестрации будет **влиять на ваши расходы на devops, стоимость серверов и масштабируемость**.
{% endhint %}

{% hint style="success" %}
[Свяжитесь в Discord](https://discord.gg/MmJf8fWjnt) чтобы узнать о вариантах гибридной оркестрации и оптимизации стоимости хостинга.
{% endhint %}

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

### Привязка к матчу

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

Сессии обычно автоматизируются через [Матчмейкинг](https://docs.edgegap.com/ru/unity/matchmaking.md) сервис, который развертывает серверы точно в срок по строгим правилам и, при необходимости, позволяет заполнять уже работающие серверы, чтобы [повысить скорость заполнения матчей](https://edgegap.com/blog/how-session-fill-rate-affects-your-multiplayer-hosting-costs).

👍 **Преимущества**

* Лучшее соотношение цены и эффективности — масштабирование в реальном времени для удовлетворения спроса игроков поминутно.
* Минимальная стоимость devops благодаря хостингу без привязки к регионам; Edgegap автоматизирует 99% задач.
* Минимальный пинг благодаря более чем 615 площадкам в публичной облачной инфраструктуре Edgegap.
* Самое быстрое горизонтальное масштабирование (burst-способность) в случае неожиданного всплеска трафика.
* Высочайший стандарт безопасности и защиты игроков от читов (авторитетность сервера).
* Минимальное влияние неожиданного сбоя сервера на игроков, затрагивающее только один матч.

👎 **Недостатки**

* Внедрение новой ментальной модели оркестрации требует некоторого начального времени на адаптацию.
* Серверы, работающие дольше 24 часов, будут автоматически завершены.

🧩 **Лучше всего подходит для**

* Игры, чувствительные к задержке — **когда оптимизация netcode не может компенсировать высокий пинг:**
  * Шутеры от первого лица, файтинги, VR и XR (виртуальная и расширенная реальность), …
* Игры с **верхним пределом длительности матча по замыслу**,
  * Королевская битва, PvPvE[^1], кооперативные шутеры, MOBA, спортивные игры, ARPG и данж-кроулеры, …

{% hint style="info" %}
Edgegap автоматически масштабирует все более 615 серверных локаций вверх/вниз в зависимости от активности игроков в каждом регионе. Готовьтесь к успеху — безупречно [масштабироваться до 14 миллионов одновременных пользователей за 60 минут](https://edgegap.com/resources/performance-benchmark).
{% endhint %}

### Региональный резерв

Постоянный мир и социальная MMO-игра **срок жизни сервера часто превышает отдельные сессии игроков**.

Сессии обычно назначаются через [Браузер серверов](https://docs.edgegap.com/ru/learn/brauzer-serverov.md) на основе предпочтений игрока (автоматически по региону или через пользовательский поиск), с предварительным горизонтальным масштабированием на основе региональной емкости.

👍 **Преимущества**

* Знакомый и легкий для понимания, старомодный подход для закаленных ветеранов.
* Высочайший стандарт безопасности и защиты игроков от читов (авторитетность сервера).
* Легко прогнозируемая стоимость на основе ежемесячного обязательства.

👎 **Недостатки**

* Более высокая стоимость хостинга — каждому региону требуется один или несколько простаивающих серверов резерва (burst capacity).
* Более высокая стоимость devops — масштабирование, операции и обслуживание дублируются для каждого региона.
* Регионы с меньшей базой игроков испытывают высокий пинг из-за подключения к удаленным серверам.

🧩 **Лучше всего подходит для**

* Постоянные миры с пользовательским контентом, хранящимся на сервере даже когда игроки офлайн.
  * MMO, песочницы с строительством базы или размещением объектов, extraction-шутеры, ...
* игры, терпимые к задержкам — **когда не требуется серверная авторитетная физика в реальном времени**:
  * мобильные игры, кооперативные игры, TCG/CCG, пошаговые стратегии, …
* Асинхронный мультиплеер, **где сбои сервера минимально влияют на опыт игроков:**
  * гонка против призраков, грабеж базы противника, игры по строительству/фермерству на таймере, …
* приложения с тяжелым процессом инициализации — когда подготовка серверов занимает минуты.

### Peer to Peer

Перенесите усилия разработки с ~~выделенных серверов~~ на **relay netcode для не соревновательных игр**.

Связанные темы: listen-серверы, авторитет игрока-хоста, NAT punch-through.

👍 **Преимущества**

* Минимальная стоимость хостинга, требуются только Relay-серверы для решения NAT punch-through.
* Минимальная стоимость devops — обслуживание требуется только для клиентских сборок и каналов распространения.
* Минимальное влияние неожиданного сбоя сервера на игроков, затрагивающее только один матч.
* Легко реализовать и быстро получить прототип, без необходимости в бэкенд-разработке.

👎 **Недостатки**

* Повышенные усилия на разработку peer-to-peer netcode, требующие навыков параллельного программирования.
* Худшее время пинга и наибольшая чувствительность к неблагоприятным сетевым условиям (например, мобильному интернету).
* Слабейшая безопасность, уязвимость к атакам man-in-the-middle и угону сессии.
* Риск потери сессий при выходе хоста, если не реализовать собственную миграцию хоста.

🧩 **Лучше всего подходит для**

* Кооперативные и казуальные игры — **когда читерство не лишает удовольствия и не ломает игру**,
  * Детские игры, игры на исследование, приключения, …

{% hint style="success" %}
Смотрите наши [Распределенные Relay](https://docs.edgegap.com/docs/distributed-relay-manager) для сервиса, обеспечивающего peer-to-peer с лучшей в классе задержкой и безопасностью.
{% endhint %}

## 📍 Размещение серверов

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

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

{% hint style="success" %}
**Edgegap развертывает в** [**наилучшем возможном месте**](#server-score) **с доступной емкостью**, для быстрых матчей с низкой задержкой.
{% endhint %}

<figure><img src="https://3845012722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2FjiPRa6gGEku2oGm3qW5s%2Fimage.png?alt=media&amp;token=306897d4-8ab1-4766-bc90-5d02882b573c" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Смотрите [#deployment-balance-points](#deployment-balance-points "mention") на **анализировать размещение серверов в реальном времени**, в масштабе.
{% endhint %}

### Оценка сервера

Стратегия оценки сервера использует запатентованную методологию Edgegap, которая **оптимизирует размещение серверов для каждого матча индивидуально**. Выполняет ненавязчивую телеметрию, чтобы приблизительно оценить сетевую близость каждого игрока к нашим серверным локациям и выбрать сервер, который обеспечивает лучшие:

* **отзывчивость** - обеспечивает в среднем наименьший пинг для всех игроков,
* **справедливость** - обеспечивает сбалансированный и справедливый пинг для всех игроков.

{% hint style="success" %}
Наша [система подбора матчей](https://docs.edgegap.com/ru/learn/matchmeiking.md) использует **стратегию Server Score по умолчанию, чтобы обеспечить наилучший возможный опыт**. Чтобы использовать эту стратегию с [API развертывания](https://docs.edgegap.com/api/#tag/Deployments), укажите публичные IP игроков или геокоординаты в запросе на развертывание.
{% endhint %}

**Невозвратимое размещение** - сервер далеко, высокий пинг для всех игроков:

<figure><img src="https://3845012722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2FNszxk3uRY78L7V6nLPlp%2Fimage.png?alt=media&amp;token=904b9b3d-7499-45d3-81c6-cc2b5cb6dd32" alt=""><figcaption></figcaption></figure>

**Несправедливое размещение** - неравномерный пинг, один игрок в невыгодном положении из-за большей задержки:

<figure><img src="https://3845012722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2FxjsD6ijYWHljBAVuV57w%2Fimage.png?alt=media&amp;token=ab477e89-4afe-4203-9b7f-b85b035dc9eb" alt=""><figcaption></figcaption></figure>

**Пример хорошего размещения** - отзывчивый и справедливый пинг для всех игроков:

<figure><img src="https://3845012722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2FQfSd4uo9twyxEWCkPLqu%2Fimage.png?alt=media&amp;token=8d3cd64b-9527-48fe-886b-96393c15449d" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Эта стратегия **особенно эффективна для хостинга группы игроков, находящихся далеко друг от друга** (Северная Америка против Южной Америки, или западное побережье против восточного), частый случай для небольшой базы игроков.
{% endhint %}

### Геолокация

В качестве альтернативы, **укажите желаемые координаты широты и долготы расположения сервера:**

⭐ **Рекомендуется:** Найдите маяк с самым быстрым пингом и отправьте его координаты или IP в поле пользователя.

⚙️ **Пользовательский**: Определите регионы (с координатами) в своем игровом бэкенде, извлекайте через пользовательский API.

👉 **Проще всего для тестирования:** Определите регионы (с координатами) жестко заданными в клиенте игры в dev-сборках.

{% hint style="warning" %}
Эта стратегия не рекомендуется для [#match-bound](#match-bound "mention") оркестрации, за исключением приложений со строгими нормативными требованиями к межрегиональной передаче данных, или когда IP игрока недоступен.
{% endhint %}

{% hint style="success" %}
В качестве альтернативы, позвольте игрокам **выбрать постоянный (всегда онлайн) сервер** из списка с [Браузер серверов](https://docs.edgegap.com/ru/learn/brauzer-serverov.md).
{% endhint %}

### Блокировка региона

Некоторые студии предпочитают фиксировать стабильные и предсказуемые локации (например, MMO с [Постоянство](https://docs.edgegap.com/ru/learn/orkestraciya/postoyanstvo.md)). Рассмотрите [Браузер серверов](https://docs.edgegap.com/ru/learn/brauzer-serverov.md) с [региональными политиками масштабирования](https://docs.edgegap.com/ru/learn/brauzer-serverov.md#automated-scaling) и [автоназначаемыми резервами](https://docs.edgegap.com/ru/learn/brauzer-serverov.md#auto-assigned-reservation).

{% hint style="warning" %}
Эта стратегия не рекомендуется для [#match-bound](#match-bound "mention") оркестрации, за исключением приложений со строгими нормативными требованиями к межрегиональной передаче данных, или когда IP игрока недоступен.
{% endhint %}

## 🟢 Качество соединения

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

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

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

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

#### Низкая задержка

Задержка игрока — это сочетание задержек при передаче данных между:

* **Физические устройства —** физический сигнал, проходящий через [топологию интернет-сети](https://en.wikipedia.org/wiki/Internet#Routing).
* **От хоста к хосту** - возникающие из-за протокола, транспорта и мер безопасности.
* **От процесса к процессу** - возникающие из-за (распаковки) и обработки данных в клиенте/сервере.

Edgegap снижает физическую задержку, размещая серверы ближе к вашим игрокам, что обеспечивает более быстрые ответы и меньшее число сетевых переходов. Благодаря локациям, охватывающим 17 облачных и bare metal провайдеров, вы получаете **лучшую в классе задержку для игроков в любой точке мира**.

Покрытие серверов и интернета по всему миру (не только у Edgegap) ограничено такими факторами, как:

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

#### Высокая доступность

Доступность серверов в различных локациях по всему миру меняется со временем, многократно в течение дня. Edgegap автоматически **масштабирует вверх/вниз** локации **по требованию**, учитывая:

* **Всплески трафика** - развертывания, выполненные в течение 15-минутного периода, влияют на тенденции масштабирования.
* **Требования к ресурсам** - общий спрос на vCPU в каждой локации определяет темп масштабирования.
* **Альтернативы провайдера** - в некоторых удаленных локациях доступно меньше вариантов провайдеров.
* **Мощность провайдера** - в некоторых локациях могут предлагаться только машины на 4 vCPU или 8 vCPU.
* **Качество сервиса** - некоторые провайдеры предлагают лучшее качество сети среди ISP в одной и той же области.
* **Расписание студии** - специальные запросы для тестирования и QA, закрытых бета-версий или турниров.

Все запросы на развертывание приложений объединяются для оценки спроса в каждой локации. По умолчанию все организации имеют равный приоритет распределения. **Студии имеют возможность добавить пользовательские** [Частные флоты](https://docs.edgegap.com/ru/learn/orkestraciya/chastnye-floty.md).

{% hint style="success" %}
Пожалуйста, **свяжитесь с нами, чтобы спланировать релиз**, или если у вас есть какие-либо запросы относительно доступности локаций.
{% endhint %}

#### Разрешение проблем игроков

Проблемы игроков иногда могут быть вызваны багами сервера или хостинга, но часто не связаны с ними — учитывайте также проблемы с кабельным/wifi-соединением, интернет-провайдером, бэкенд-сервисами или багами в низкоуровневых библиотеках клиента/сервера.

При расследовании отчетов или инцидентов игроков учитывайте факторы:

* **Качество матчмейкинга** - по возможности оптимизируйте подбор по матчам в пределах одного региона:
  * [Матчмейкинг](https://docs.edgegap.com/ru/learn/matchmeiking.md) и [Пинг-маяки](https://docs.edgegap.com/ru/learn/orkestraciya/ping-beacons.md) в наших рекомендациях,
  * [Подробный обзор](https://docs.edgegap.com/ru/learn/matchmeiking/matchmaker-in-depth.md#player-tracing) чтобы найти серверные логи, связанные с отчетами игроков.
* **Проблемы региональной сети и ISP:**
  * локальные интернет-провайдеры (ISP) могут в данный момент устранять инцидент,
  * некоторые регионы (например, Китай, Россия) могут быть ограничены из-за локальных санкций.
* **Уровень кэширования** - без кэширования ваши сессии могут завершаться по тайм-ауту из-за более медленных развертываний:
  * [включите кэширование, чтобы развертывать серверы за считанные секунды](https://docs.edgegap.com/ru/learn/orkestraciya/application-and-versions.md#other-parameters-optional).
* **Максимальное время на развертывание** - развертывания могут не удаваться из-за медленного и тяжелого процесса инициализации:
  * смотрите [Приложения и версии](https://docs.edgegap.com/ru/learn/orkestraciya/application-and-versions.md#safety-guardrails) чтобы увеличить период тайм-аута.
* **Проблемы с образом сервера или интеграцией** на ранних итерациях конвейеров пользовательской сборки.

{% hint style="success" %}
**Показывать ID развертывания в UI истории матчей клиента** чтобы отслеживать отчеты игроков при устранении неполадок.
{% endhint %}

{% hint style="info" %}
Сообщайте пользователям о массовых багах, временных проблемах и сбоях, чтобы снизить негативное отношение.
{% endhint %}

## 🔄 Жизненный цикл развертывания

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

#### 1. Начать развертывание

Развертывание для **тестовых целей** может быть запущено с помощью:

* [Unreal Engine](https://docs.edgegap.com/ru/unreal-engine.md) - Docker Extension или плагина EGIK для проектов Unreal Engine.
* [Unity](https://docs.edgegap.com/ru/unity.md) - плагина quickstart для хостинга проектов Unity.
* [Godot](https://docs.edgegap.com/ru/godot.md) - плагина quickstart для хостинга проектов Godot.
* [Веб-интерфейс Dashboard](https://app.edgegap.com/deployment-management/deployments/list) - простой веб-интерфейс для быстрого тестирования и итераций серверов.

При тестировании новых сборок с разработчиками или командами 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" %}
**Сохранить** `request_id`  **(ID развертывания) и помечайте развертывания тегами** чтобы потом идентифицировать и устранять проблемы.
{% endhint %}

#### 2. Развертывание

Как только развертывание запущено, наша система выполнит ряд шагов в быстрой последовательности:

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

{% hint style="success" %}
Включить [Активное кэширование в вашей версии приложения](https://docs.edgegap.com/ru/learn/orkestraciya/application-and-versions.md#active-caching) для развертывания серверов за считанные секунды.
{% endhint %}

{% hint style="warning" %}
**Слишком много запросов 429** - чтобы обеспечить стабильность и предотвратить неожиданные счета, мы ограничиваем rate limit вашей организации до **40 запросов/с**. [Свяжитесь с нами](mailto:info@edgegap.com) чтобы планировать релизы, оценивать трафик на запуске и готовиться к успеху.
{% endhint %}

#### 3. Готовность развертывания

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

{% hint style="success" %}
**Повторить подключение игрока несколько раз**, пока не истечет заранее заданный тайм-аут, прежде чем выйти и начать новую сессию. Серверы обычно не принимают новые подключения игроков, пока полностью не инициализированы.
{% endhint %}

{% hint style="danger" %}
**Обработка сбоя сервера зависит от вашей** [**политики перезапуска процесса**](https://docs.edgegap.com/ru/learn/orkestraciya/application-and-versions.md#safety-guardrails)**.** [Состояние сервера может быть потеряно](https://docs.edgegap.com/ru/learn/orkestraciya/postoyanstvo.md#state-management).
{% endhint %}

В зависимости от [Приложения и версии](https://docs.edgegap.com/ru/learn/orkestraciya/application-and-versions.md#active-caching) статуса версии,

🟢 **Попадание в кэш**

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

🟡 **Теплый старт**

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

🔴 **Промах кэша**

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

🔴 **Холодный старт**

Кэширование отключено. Развертывание было медленнее, образ загружался во время развертывания. Включите кэширование для более быстрого развертывания.

#### 4. Ошибка развертывания

Ваше развертывание может в любой момент перейти в состояние Unprocessable по неожиданным причинам. Это более вероятно при тестировании интеграции или тестировании новых серверных сборок.

**За развертывания с ошибкой с вас не взимается плата; они автоматически останавливаются через 24 часа.**

Шаги по устранению неполадок:

* Проверьте статус сервиса Edgegap с помощью [нашей страницы мониторинга аптайма](https://status.edgegap.com/).
* Попробуйте протестировать контейнер вашего сервера локально с помощью Docker Desktop, чтобы исключить проблемы Edgegap.

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

{% hint style="success" %}
**Когда просите о помощи,** **укажите ID вашего развертывания и любые полезные детали** чтобы мы могли быстро разобраться!
{% endhint %}

#### 5. Развертывание остановлено

**Облачные развертывания будут завершены после 24 часов работы** в соответствии с нашей политикой санитации серверов для обслуживания инфраструктуры и чтобы предотвратить накопление неожиданных расходов, когда развертывание не было корректно остановлено из-за неожиданного бага.

Для долгоживущих серверов старше 24 часов рассмотрите использование [Частные флоты](https://docs.edgegap.com/ru/learn/orkestraciya/chastnye-floty.md) с [Постоянство](https://docs.edgegap.com/ru/learn/orkestraciya/postoyanstvo.md).

Оптимизируйте свои расходы и останавливайте простаивающие развертывания раньше, используя методы:

* **Версия приложения** [**Политика перезапуска**](https://docs.edgegap.com/ru/learn/orkestraciya/application-and-versions.md#safety-guardrails) - предотвращает автоматический перезапуск при остановке или сбоях.
* **Максимальная длительность игры** - отведенное время в вашем [Приложения и версии](https://docs.edgegap.com/ru/learn/orkestraciya/application-and-versions.md#safety-guardrails) истекло.
* **Самоостановка через** [**DELETE\_URL**](https://docs.edgegap.com/ru/learn/orkestraciya/deployments.md#injected-environment-variables) - развертывание самостоятельно остановилось после ухода игроков и завершения матча.
  * Смотрите [Unreal Engine](https://docs.edgegap.com/ru/unreal-engine.md#stop-deployments) и [Unity](https://docs.edgegap.com/ru/unity.md#stop-deployments) руководства по утилитам SDK и простой интеграции, или используйте API.
* **Остановить из пользовательского бэкенда** - ваша пользовательская оркестрация сессий может использовать [API развертываний](https://docs.edgegap.com/api/#tag/Deployments/operation/deployment-delete).
* [Частные флоты](https://docs.edgegap.com/ru/learn/orkestraciya/chastnye-floty.md) Хост, на котором выполнялось ваше развертывание, был удален в рамках запланированного действия.

{% hint style="info" %}
После того как развертывание остановлено, **мы инициируем корректное завершение** отправляя `сигнал SIGTERM` вашему основному процессу, предоставляя короткий период для завершения. После истечения `сигнал SIGKILL` отправляется для остановки развертывания.
{% endhint %}

## 👀 Наблюдаемость

Позвольте игровым серверам взаимодействовать со сторонними сервисами и получать операционную аналитику.

{% hint style="info" %}
**Беспокоят неожиданные расходы на облако?** [Настройте облачные оповещения](https://app.edgegap.com/notifications?notification-table-limit=10\&notification-table-page=1#alarms) чтобы получать уведомления при достижении пользовательских биллинговых порогов, или [свяжитесь с нами](https://discord.com/invite/NgCnkHbsGp) об автоматизированных мерах безопасности.
{% endhint %}

### Обнаруживаемость

После Ready развертыванию присваивается URL ([fqdn](https://en.wikipedia.org/wiki/Fully_qualified_domain_name)) и внешний порт для каждого внутреннего порта.

{% hint style="success" %}
Используйте **теги развертывания (до 40 символов), чтобы легко помечать ваши развертывания** и находить их позже.
{% endhint %}

{% hint style="info" %}
**Исходящий трафик (к клиентам или бэкенду) с ваших игровых серверов никогда не блокируется** или не фильтруется.
{% endhint %}

#### **WebSockets (WS) и Secure WebSockets (WSS)**

Чтобы использовать netcode на базе websocket с Edgegap, у вас есть два варианта:

* **управляемый сертификат**, настраивается за 1 минуту без написания кода:
  * настройте ваш [Приложения и версии](https://docs.edgegap.com/ru/learn/orkestraciya/application-and-versions.md) на **используйте Websocket (WS) и Enable TLS Upgrade,**
  * используйте URL Edgegap для подключения клиентов (например. `https://5fa53fa00a57.pr.edgegap.net/`)
* **самостоятельно управляемый сертификат**, если вы хотите использовать свой собственный пользовательский домен:
  * настройте ваш [Приложения и версии](https://docs.edgegap.com/ru/learn/orkestraciya/application-and-versions.md) на **используйте Secure WebSocket (WSS)**,
  * настройте собственный поток TLS-сертификата с помощью пользовательской DNS-записи (например, в [Cloudflare](https://www.cloudflare.com/application-services/products/ssl/)).

{% hint style="danger" %}
Необработанные исключения сервера приведут к перезапуску контейнера развертывания и сделают TLS-защиту недействительной. В таком случае, [остановите свой сервер](#id-5.-deployment-stopped) и [переназначьте игроков на новое развертывание](https://docs.edgegap.com/ru/learn/matchmeiking.md#custom-lobby). [Состояние сервера может быть потеряно](https://docs.edgegap.com/ru/learn/orkestraciya/postoyanstvo.md#state-management).
{% endhint %}

### Внедрённые переменные <a href="#injected-environment-variables" id="injected-environment-variables"></a>

Игровым серверам часто нужна дополнительная информация, например IP-адрес сервера, значения внутренних портов или другое. Внедрение переменных окружения только для чтения — это надёжный, не зависящий от облака способ передавать параметры.

{% hint style="success" %}
Получайте значения переменных с помощью [Unity SDK](https://docs.edgegap.com/ru/unity/developer-tools.md#software-development-kit), [Unreal EGIK](https://docs.edgegap.com/ru/unreal-engine/developer-tools.md#integration-kit), или с помощью методов env. переменных вашей среды выполнения.
{% endhint %}

{% hint style="info" %}
Смотрите [Переменные версии приложения](https://docs.edgegap.com/ru/learn/orkestraciya/application-and-versions.md#injected-variables) и [Переменные матчмейкера](https://docs.edgegap.com/ru/learn/matchmeiking/matchmaker-in-depth.md#injected-variables) в дополнение к переменным развертывания ниже.
{% endhint %}

#### **Пользовательские переменные**

Определите до 20 пользовательских переменных для каждого развертывания, каждая из которых может содержать до 4 КБ строковых данных.

{% hint style="warning" %}
**Избегайте использования зарезервированных имён (ниже), иначе ваши пользовательские переменные будут перезаписаны!**
{% endhint %}

Получайте важную информацию, читая переменные, внедряемые Edgegap на ваши серверы:

#### **Идентификаторы**

* **`ARBITRIUM_REQUEST_ID`**  - например, `f68e011bfb01` .
  * Уникальный ID развертывания, также называемый ID запроса. Используется для получения дополнительной информации.
  * URL-адреса развертывания всегда имеют формат `{ARBITRIUM_REQUEST_ID}.pr.edgegap.net`.
* **`ARBITRIUM_PUBLIC_IP`**  - например, `162.254.141.66` .
  * Публичный IP-адрес этого хоста; может использоваться для подключения вместо URL.
* **`ARBITRIUM_HOST_ID`**  - например, `alpha-north-america-70364ef8` .
  * Уникальный идентификатор машины, на которой размещено ваше развертывание, общий с другими развертываниями.
* **`ARBITRIUM_DEPLOYMENT_TAGS`**  - например, `tag1,tag2` .
  * Разделённые запятыми пользовательские теги развертывания, [полезные для удобного поиска и фильтрации](#filter-deployments).
* **`ARBITRIUM_PRIVATE_FLEET_ID`** - например, `PUBLIC_CLOUD` , или ID флота, если размещено в [Частные флоты](https://docs.edgegap.com/ru/learn/orkestraciya/chastnye-floty.md).

#### Спецификации ресурсов

* **`ARBITRIUM_HOST_IN_PRIVATE_FLEET`** - например, `false` , указывающее, размещено ли на [Частные флоты](https://docs.edgegap.com/ru/learn/orkestraciya/chastnye-floty.md).
* **`ARBITRIUM_HOST_BASE_CLOCK_FREQUENCY`**  - например, `2300` , частота процессора в МГц.
* **`ARBITRIUM_DEPLOYMENT_VCPU_UNITS`**  - например, `256`, выделенные единицы vCPU (1024 = 1 vCPU).
* **`ARBITRIUM_DEPLOYMENT_MEMORY_MB`**  - например, `512`, выделенная ОЗУ в МБ (1024 = 1 ГБ).

#### **Управление жизненным циклом**

* **`ARBITRIUM_DELETE_URL`**  - например, `https://api.edgegap.com/v1/self/stop/9f511e17/660`.
  * Можно вызвать из развертывания, [развертывание будет корректно остановлено](#id-5.-deployment-stopped).
  * Требует уникальный одноразовый `ARBITRIUM_DELETE_TOKEN` в `заголовке Authorization` .
* **`ARBITRIUM_DELETE_TOKEN`**  - например, `7df4cd933df87084b34ae80d8abde293`.
* **`ARBITRIUM_CONTEXT_URL`**  - например, `https://api.edgegap.com/v1/context/9170f5211e17/17`.
  * Можно вызвать только из развертывания, возвращает больше сведений о развертывании.
  * Требует уникальный `ARBITRIUM_CONTEXT_TOKEN` в `заголовке Authorization` .
* **`ARBITRIUM_CONTEXT_TOKEN`**  - например, `dfaf50b9333b9ee07b22ed247e4a17e6`.

#### **Обнаруживаемость**

* **`ARBITRIUM_PORT_GAMEPORT_INTERNAL`**  - например, `7777` , внутренний порт для прослушивателя сервера.
* **`ARBITRIUM_PORT_GAMEPORT_EXTERNAL`**  - например, `31504` , внешний порт для подключений клиентов.
  * Значения внешних портов рандомизируются для каждого развертывания в целях безопасности.
* **`ARBITRIUM_PORT_GAMEPORT_PROTOCOL`**  - например, `UDP` , протокол вашего транспорта netcode.

{% hint style="success" %}
В примерах предполагается, что вы назвали свой порт `gameport` (по умолчанию). **Каждый порт добавляет дополнительный набор очищенных** [Приложения и версии](https://docs.edgegap.com/ru/learn/orkestraciya/application-and-versions.md#port-mapping) **переменных:** `@Super Port!` ⇒ `ARBITRIUM_PORT_SUPER_PORT_INTERNAL` .
{% endhint %}

* **`ARBITRIUM_BEACON_ENABLED`**  - например, `true`, если развертывание выполняется на [Частные флоты](https://docs.edgegap.com/ru/learn/orkestraciya/chastnye-floty.md) с [Пинг-маяки](https://docs.edgegap.com/ru/learn/orkestraciya/ping-beacons.md).
* **`ARBITRIUM_HOST_BEACON_PUBLIC_IP`**  - например, `139.177.198.69` , публичный IP ближайшего маяка.
* **`ARBITRIUM_HOST_BEACON_PORT_UDP_EXTERNAL`**  - например, `30199`, для измерения пинга по UDP.
* **`ARBITRIUM_HOST_BEACON_PORT_TCP_EXTERNAL`**  - например, `30456`, для измерения пинга по TCP.

#### **Структурированная информация (JSON как строка)**

{% hint style="info" %}
Переменные окружения **хранятся как JSON-строки**, разбирайте их с помощью SDK или собственного метода.
{% endhint %}

<details>

<summary><strong><code>ARBITRIUM_DEPLOYMENT_LOCATION</code></strong></summary>

```json
ARBITRIUM_DEPLOYMENT_LOCATION="{
  "city": "Монреаль",
  "country": "Канада",
  "continent": "Северная Америка",
  "administrative_division": "Квебек",
  "timezone": "Восточное время",
  "latitude": 45.513707,
  "longitude": -73.619073
}"
```

</details>

<details>

<summary><strong><code>ARBITRIUM_PORTS_MAPPING</code></strong></summary>

```json
ARBITRIUM_PORTS_MAPPING="{
  "ports": {
    "gameport": {
      "name": "Игровой порт",
      "internal": 7777,
      "external": 31504,
      "protocol": "UDP"
    },
    "webport": {
      "name": "Веб-порт",
      "internal": 8888,
      "external": 31553,
      "protocol": "TCP"
    }
  }
}"
```

</details>

### Мониторинг в панели управления

Наша [Панель управления](https://app.edgegap.com/) предоставляет утилиты для мониторинга масштабируемости вашего сервера и помощи в операциях.

#### Аналитика

{% hint style="success" %}
Найдите [панели аналитики в боковом меню](https://app.edgegap.com/analytics/dashboards/list) в категории Хостинг и оркестрация серверов.
{% endhint %}

:star2: [**Перейдите на тариф Pay as You Go**](https://app.edgegap.com/user-settings?tab=memberships) **чтобы разблокировать подробные метрики производительности сервера и аналитические данные:**

* **Общая аналитика:** отслеживайте релизы с количеством живых серверов по версиям + обзором использования ресурсов,
* **Аналитика CPU**: устраняйте неполадки на медленных серверах из-за ресурсоёмких операций,
* **Аналитика памяти**: уменьшайте перезапуски серверов из-за превышения выделенной памяти,
* **Сетевые аналитические данные:** обнаруживайте неэффективные сетевые паттерны и оптимизируйте netcode.

<figure><img src="https://3845012722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2FLxDp1yFvkj5kB6AC4xVb%2Fimage.png?alt=media&amp;token=c0eff5f1-a374-41e0-a49a-9b3ecf0bfd1b" alt=""><figcaption></figcaption></figure>

#### Карта развертывания

{% hint style="success" %}
Найдите карту развертывания в [на странице сведений о вашем развертывании на панели управления](https://app.edgegap.com/deployment-management/deployments/list).
{% endhint %}

Просматривайте местоположение развертывания, доступные локации и предполагаемые местоположения игроков на карте:

<figure><img src="https://3845012722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2FM4h0itPU5ntPaV5N5ZlW%2Fimage.png?alt=media&amp;token=98028901-9a40-4a2d-969e-db5f990e334f" alt=""><figcaption></figcaption></figure>

#### Точки баланса развертывания

{% hint style="success" %}
Найдите тепловую карту точек баланса развертывания в [на странице сведений о вашем приложении на панели управления](https://app.edgegap.com/application-management/applications/list).
{% endhint %}

Просматривайте тепловую карту точек баланса развертывания и фильтруйте по [Приложения и версии](https://docs.edgegap.com/ru/learn/orkestraciya/application-and-versions.md). Точки баланса — это приблизительные локации с одинаковой сетевой близостью к каждому игроку в данном развертывании:

<figure><img src="https://3845012722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2FfDpIQxoFUJZNE77LJIwZ%2Fimage.png?alt=media&amp;token=94e730ad-3907-486b-8a06-0f469acd19ea" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Горячие точки баланса в странных местах (например, Гренландия) указывают на подбор игроков, находящихся далеко друг от друга. Узнайте о [#connection-quality](#connection-quality "mention") и [Пинг-маяки](https://docs.edgegap.com/ru/learn/orkestraciya/ping-beacons.md) чтобы оптимизировать подбор игроков.
{% endhint %}

#### Журналы развертывания

{% hint style="success" %}
Найдите журналы развертывания в [на странице сведений о вашем развертывании на панели управления](https://app.edgegap.com/deployment-management/deployments/list).
{% endhint %}

Журналы развертывания отображают информацию о [#deployment-lifecycle](#deployment-lifecycle "mention"):

<figure><img src="https://3845012722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2FfkyAYtylnOFmSp3yyiId%2Fimage.png?alt=media&amp;token=6a4f6ac4-5780-46a7-bcdd-1d8829c4abd7" alt=""><figcaption></figcaption></figure>

#### Журналы контейнера

{% hint style="success" %}
Найдите журналы контейнера в [на странице сведений о вашем развертывании на панели управления](https://app.edgegap.com/deployment-management/deployments/list).
{% endhint %}

Проверяйте журналы вашего игрового сервера в случае проблем или при отладке:

<figure><img src="https://3845012722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Fpzg50T3fCNQ4Q8brGsQ4%2Fimage.png?alt=media&amp;token=f248fe9a-4f34-4f97-b549-cf271332ea3c" alt=""><figcaption></figcaption></figure>

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

#### Метрики контейнера

{% hint style="success" %}
Найдите метрики контейнера в [на странице сведений о вашем развертывании на панели управления](https://app.edgegap.com/deployment-management/deployments/list).
{% endhint %}

Просматривайте метрики контейнера (процессор, память, сеть), чтобы:

* выявлять распространённые проблемы с подключением, когда [#troubleshooting](#troubleshooting "mention"),
* обнаруживать неэффективные шаблоны реализации, вызывающие всплески использования ресурсов,
* точно определять неэффективное использование ресурсов в отдельных сценариях,
* проверять изменения в использовании ресурсов вашим сервером во время оптимизации,
* сравнивать потребление ресурсов при инициализации сервера и её длительность.

Исторические метрики отображают средние значения с интервалом 1 минута, доступны в бесплатном тарифе.

:star2: [**Перейдите на тариф Pay as You Go**](https://app.edgegap.com/user-settings?tab=memberships) **чтобы разблокировать точные метрики с интервалами в 1 секунду.**

<figure><img src="https://3845012722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2FoIpCR3x9ibiXMEIWFgKG%2Fimage.png?alt=media&amp;token=86dcd914-db9f-4e81-8444-6c83805be9b6" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
[Свяжитесь с нами](mailto:info@edgegap.com) до вашего релиза, чтобы запросить поддержку размещения в реальном времени для крупных релизов.
{% endhint %}

### Контекст и статус

Дополнительную информацию о развертывании можно получить в формате JSON:

* изнутри развертывания (игрового сервера), используя [API контекста развертывания](https://docs.edgegap.com/api/#tag/Context/operation/context-get),
* снаружи развертывания (backend / сторонний), используя [API статуса развертывания](https://docs.edgegap.com/api/#tag/Deployments/operation/deployment-status-get).

{% hint style="info" %}
API контекста (из развертывания) требует токен API контекста, тогда как API статуса использует ваш токен Edgegap.
{% endhint %}

{% hint style="danger" %}
**Слишком много запросов 429 — API контекста и статуса ограничены 20 запросами/с на одну организацию.** Эти API предназначены для использования во время особых операций, а не для автоматизированной оркестрации сессий.
{% endhint %}

{% hint style="success" %}
**Используйте** [#webhooks](#webhooks "mention") **для собственной оркестрации сессий, чтобы избежать ограничения частоты запросов и обеспечить масштабируемость.**
{% endhint %}

### Фильтрация развертываний

Чтобы быстро искать среди всех развертываний, вы можете [использовать нашу панель управления](https://app.edgegap.com/deployment-management/deployments/list):

<figure><img src="https://3845012722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2F42IaKG0pFQXSkvPCRH1T%2Fimage.png?alt=media&amp;token=6aba8781-13c9-4c0f-87e9-2d9612a57342" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
В качестве альтернативы, позвольте игрокам **выбрать постоянный (всегда онлайн) сервер** из списка с [Браузер серверов](https://docs.edgegap.com/ru/learn/brauzer-serverov.md).
{% endhint %}

[Список развертываний через API](https://docs.edgegap.com/api/#tag/Deployments/operation/deployments-get) и применять фильтры через backend-интеграции:

<table><thead><tr><th width="237">Атрибут развертывания</th><th width="193">Операторы</th><th>Пример значения</th></tr></thead><tbody><tr><td><a href="https://docs.edgegap.com/ru/learn/orkestraciya/deployments.md#deployment-lifecycle"><code>status</code></a></td><td><a data-footnote-ref href="#user-content-fn-2"><code>eq</code></a>  или <a data-footnote-ref href="#user-content-fn-3"><code>neq</code></a></td><td><code>"ready"</code> или <code>"error"</code></td></tr><tr><td><a href="#observability"><code>request_id</code></a></td><td><a data-footnote-ref href="#user-content-fn-2"><code>eq</code></a> </td><td><a data-footnote-ref href="#user-content-fn-4"><code>"7e709a0d8efd"</code></a></td></tr><tr><td></td><td><a data-footnote-ref href="#user-content-fn-5"><code>в</code></a>  или <a data-footnote-ref href="#user-content-fn-6"><code>nin</code></a></td><td><a data-footnote-ref href="#user-content-fn-4"><code>[ "7e709a0d8efd", "4ba353100b4b" ]</code></a></td></tr><tr><td><a href="#discoverability"><code>tags</code></a></td><td><a data-footnote-ref href="#user-content-fn-2"><code>eq</code></a>  или <a data-footnote-ref href="#user-content-fn-3"><code>neq</code></a></td><td><code>"tagA"</code></td></tr><tr><td></td><td><a data-footnote-ref href="#user-content-fn-5"><code>в</code></a>  или <a data-footnote-ref href="#user-content-fn-6"><code>nin</code></a></td><td><code>[ "tagA", "tagB" ]</code></td></tr><tr><td><a href="#id-1.-start-a-deployment"><code>created_at</code></a></td><td><a data-footnote-ref href="#user-content-fn-2"><code>eq</code></a>  или <a data-footnote-ref href="#user-content-fn-7"><code>lte</code></a>  или <a data-footnote-ref href="#user-content-fn-8"><code>gte</code></a></td><td><a href="https://en.wikipedia.org/wiki/ISO_8601"><code>2025-05-12T20:03:20Z</code></a></td></tr><tr><td><a href="https://docs.edgegap.com/ru/learn/orkestraciya/application-and-versions.md"><code>application</code></a></td><td><a data-footnote-ref href="#user-content-fn-2"><code>eq</code></a>  или <a data-footnote-ref href="#user-content-fn-3"><code>neq</code></a></td><td><code>"my-app"</code></td></tr><tr><td></td><td><a data-footnote-ref href="#user-content-fn-5"><code>в</code></a>  или <a data-footnote-ref href="#user-content-fn-6"><code>nin</code></a></td><td><code>[ "my-app", "my-other-app" ]</code></td></tr><tr><td><a href="https://docs.edgegap.com/ru/learn/orkestraciya/application-and-versions.md"><code>version</code></a></td><td><a data-footnote-ref href="#user-content-fn-2"><code>eq</code></a>  или <a data-footnote-ref href="#user-content-fn-3"><code>neq</code></a></td><td><code>"1.0.0"</code></td></tr><tr><td></td><td><a data-footnote-ref href="#user-content-fn-9"><code>в</code></a>  или <a data-footnote-ref href="#user-content-fn-6"><code>nin</code></a></td><td><code>[ "1.0.0", "prod" ]</code></td></tr><tr><td><a href="https://docs.edgegap.com/ru/learn/orkestraciya/chastnye-floty.md"><code>fleet_name</code></a></td><td><a data-footnote-ref href="#user-content-fn-2"><code>eq</code></a>  или <a data-footnote-ref href="#user-content-fn-3"><code>neq</code></a></td><td><code>"my-app-fleet-europe"</code></td></tr><tr><td></td><td><a data-footnote-ref href="#user-content-fn-5"><code>в</code></a>  или <a data-footnote-ref href="#user-content-fn-6"><code>nin</code></a></td><td><code>[ "fleet-eu", "fleet-us" ]</code></td></tr><tr><td></td><td><a data-footnote-ref href="#user-content-fn-10"><code>ilike</code></a></td><td><code>"%-eu%"</code></td></tr><tr><td><a href="https://docs.edgegap.com/ru/learn/orkestraciya/chastnye-floty.md"><code>host_name</code></a></td><td><a data-footnote-ref href="#user-content-fn-2"><code>eq</code></a>  или <a data-footnote-ref href="#user-content-fn-3"><code>neq</code></a></td><td><code>"alpha-north-america-95fab093"</code></td></tr><tr><td></td><td><a data-footnote-ref href="#user-content-fn-5"><code>в</code></a>  или <a data-footnote-ref href="#user-content-fn-6"><code>nin</code></a></td><td><code>[ "alpha-north-america-95fab093" ]</code></td></tr><tr><td></td><td><a data-footnote-ref href="#user-content-fn-10"><code>ilike</code></a></td><td><code>"%north-america%"</code></td></tr></tbody></table>

{% hint style="info" %}
Каждый атрибут может иметь не более 1 оператора фильтра в одном запросе. См. [Справочник API](https://docs.edgegap.com/ru/docs/api.md) для получения дополнительной информации.
{% endhint %}

Сортируйте результаты по нескольким полям в порядке их появления в запросе:

| Атрибут развертывания                                                                  | Порядок                                                                  |
| -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
| [`created_at`](#id-1.-start-a-deployment)                                              | [`asc`](#user-content-fn-11)[^11] или [`desc`](#user-content-fn-12)[^12] |
| [`available_session_sockets`](broken://pages/af47f00633ef43a181ec41a0562bbc4e007a3046) | [`asc`](#user-content-fn-13)[^13] или [`desc`](#user-content-fn-14)[^14] |

Примеры запросов фильтра:

<details>

<summary>Список <a href="#id-4.-deployment-error">Развертывания с ошибкой</a> для устранения неполадок и удаления.</summary>

Закодированный URL:

```
https://api.edgegap.com/v1/deployments?query={"filters":[{"field":"status","operator":"eq","value":"error"},{"field":"application","operator":"eq","value":"my-app"},{"field":"version","operator":"eq","value":"green"}],"order_by":[{"field":"created_at","order":"desc"}]}
```

Отформатированный JSON-запрос:

```json
{
  "filters": [
    {
      "field": "status",
      "operator": "eq",
      "value": "error"
    },
    {
      "field": "application",
      "operator": "eq",
      "value": "my-app"
    },
    {
      "field": "version",
      "operator": "eq",
      "value": "green"
    }
  ],
  "order_by": [
    {
      "field": "created_at",
      "order": "desc"
    }
  ]
}
```

</details>

<details>

<summary>Список <a href="https://docs.edgegap.com/ru/learn/matchmeiking/matchmaker-in-depth.md#rolling-updates-and-ab-tests">Развертывания с устаревшей версией приложения</a> чтобы подтвердить, что релиз завершён.</summary>

Закодированный URL:

```
https://api.edgegap.com/v1/deployments?query={"filters":[{"field":"status","operator":"eq","value":"ready"},{"field":"application","operator":"eq","value":"my-app"},{"field":"version","operator":"eq","value":"blue"}],"order_by":[{"field":"created_at","order":"desc"}]}
```

Отформатированный JSON-запрос:

```json
{
  "filters": [
    {
      "field": "status",
      "operator": "eq",
      "ready"
    },
    {
      "field": "application",
      "operator": "eq",
      "value": "my-app"
    },
    {
      "field": "version",
      "operator": "eq",
      "blue"
    }
  ],
  "order_by": [
    {
      "field": "created_at",
      "order": "desc"
    }
  ]
}
```

</details>

{% hint style="success" %}
Не забудьте добавить `заголовке Authorization` заголовок с вашим токеном Edgegap API в запросе.
{% endhint %}

### Вебхуки

Получайте простые HTTP-уведомления в backend вашей игры об изменениях в [#deployment-lifecycle](#deployment-lifecycle "mention") путём указания URL вебхука в вашем [запросе API развертывания](https://docs.edgegap.com/ru/docs/api/vydelennye-servery.md#post-deployments). Доступно для:

* При готовности: контейнер развертывания [успешно запущен](#id-1.-start-a-deployment) (после этого сервер начинает инициализацию).
* При ошибке: развертывание не удалось запустить и [#id-4.-deployment-error](#id-4.-deployment-error "mention") произошла ошибка.
* При завершении: [#id-5.-deployment-stopped](#id-5.-deployment-stopped "mention") и игровой сервер больше недоступен.

Вебхуки Ready и Error никогда не будут срабатывать для одного и того же развертывания.

<details>

<summary>Пример полезной нагрузки вебхука</summary>

```json
{
  "request_id": "f68e011bfb01",
  "application": "my-game-server",
  "version": "2024.01.30-16.23.00-UTC",
  "fqdn": "f68e011bfb01.pr.edgegap.net",
  "public_ip": "162.254.141.66",
  "deployed_at": "2026-02-10T20:35:48Z",
  "termination_scheduled_at": "2026-02-10T21:35:48Z",
  "ports": {
    "gameport": {
      "external": 31504,
      "internal": 7777,
      "protocol": "UDP",
      "name": "gameport",
      "tls_upgrade": false,
      "link": "f68e011bfb01.pr.edgegap.net:31504",
      "proxy": null
    }
  },
  "location": {
    "city": "Монреаль",
    "country": "Канада",
    "continent": "Северная Америка",
    "administrative_division": "Квебек",
    "timezone": "Восточное время",
    "latitude": 45.513707,
    "longitude": -73.619073
  },
  "tags": [
    "tag1",
    "tag2"
  ],
  "host_id": "alpha-north-america-70364ef8",
  "host_in_private_fleet": false,
  "private_fleet_id": "PUBLIC_CLOUD",
  "vcpu_units": 256,
  "memory_mib": 512
}
```

</details>

{% hint style="success" %}
**Вебхуки являются основным рекомендуемым методом для пользовательских интеграций развертывания с backend.**
{% endhint %}

{% hint style="warning" %}
**Вебхуки не повторяются**, и могут быть потеряны, если ваш бэкенд не обработает запрос из-за ограничения частоты или ошибки. Если вы не получите вебхук в ожидаемый срок, используйте Status API.
{% endhint %}

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

## 🚨 Устранение неполадок

При устранении неполадок с деплоями:

1. проверьте, что в вашем [#deployment-logs](#deployment-logs "mention") и [#container-logs](#container-logs "mention"),
2. запустите сервер локально, чтобы исключить ошибки интеграции,
3. ознакомьтесь с шагами по устранению неполадок на этой странице,
4. свяжитесь с нами в [Discord-сообществе](https://discord.gg/MmJf8fWjnt) и укажите ID вашего деплоя.

{% hint style="info" %}
Смотрите [#player-issue-resolution](#player-issue-resolution "mention") чтобы ознакомиться с нашими рекомендациями по работе с отзывами игрового сообщества.
{% endhint %}

<details>

<summary>Не удается подключить клиентов к серверу - <code>Истекло время ожидания запроса.</code>, <code>Время ожидания запроса истекло.</code> , <code>Ошибка подключения</code> , или <code>Проверка порта не удалась</code>.</summary>

* Сначала убедитесь, что деплой находится в состоянии Ready и что в журнале деплоя нет исключений или ошибок во время выполнения. Если ваш деплой остановился, просмотрите журналы в нашем [Панель управления](https://app.edgegap.com/deployment-management/deployments/list).
* Если вы используете netcode Mirror, вам нужно иметь [«Auto Start Server»](https://mirror-networking.gitbook.io/docs/hosting/edgegap-hosting-plugin-guide#build-and-push) выбранным в вашем `NetworkManager` , пересоберите, отправьте и повторно задеплойте ваш сервер.
* Если вы используете netcode FishNet, вам нужно включить [«Start on Headless»](https://fish-networking.gitbook.io/docs/manual/components/managers/server-manager#settings-are-general-settings-related-to-the-servermanager) в вашем `ServerManager`, пересоберите, отправьте и повторно задеплойте ваш сервер.
* Если вы используете netcode Photon Fusion 2, убедитесь, что ваш сервер передает публичный IP деплоя, внешний порт и `код комнаты` на сервере, а также тот же код комнаты в клиенте в [«NeworkRunner.StartGame»](https://doc.photonengine.com/fusion/current/manual/network-runner#creating-or-joining-a-room) параметре `StartGameArgs`. ID деплоя (например, `b63e6003b19f`) — отличный выбор, поскольку он глобально уникален и легко доступен клиенту через [система подбора матчей](https://docs.edgegap.com/ru/learn/matchmeiking/matchmaker-in-depth.md) назначение, а также к [Подробный обзор](https://docs.edgegap.com/ru/learn/matchmeiking/matchmaker-in-depth.md#injected-environment-variables).
* Далее проверьте, что настройка порта в netcode-настройках сборки вашего сервера совпадает с внутренним портом в вашем [версии приложения](https://app.edgegap.com/application-management/applications/list). Вы можете изменить сопоставление портов, отредактировав [версии приложения](https://app.edgegap.com/application-management/applications/list) без пересборки. Найдите свой протокол в вашей интеграции netcode.
* Убедитесь, что игровой клиент подключается к **внешнему порту** , указанному на странице сведений о вашем деплое; это значение всегда будет случайным по соображениям безопасности.
* Если вы используете протокол Secure WebSocket (WSS) в своей интеграции netcode, убедитесь, что ваш [версии приложения](https://app.edgegap.com/application-management/applications/list) в конфигурации порта для WSS-порта включено обновление TLS.
* Вы находитесь в Китае и используете [Smart Fleets](https://docs.edgegap.com/docs/deployment/session/fleet-manager/fleet)? Ваше соединение может быть заблокировано Великим китайским файрволом. Рассмотрите возможность добавить в свой флот сервер, расположенный в Китае, или использовать VPN для подключения.

</details>

<details>

<summary>Мой деплой остановился/перезапустился, и я больше не могу получить доступ к его журналам.</summary>

* Если процесс сервера аварийно завершится из-за исключения, наша система автоматически попытается перезапустить сервер. Рассмотрите возможность локального тестирования сервера, чтобы выявить первопричину.
* Мы храним журналы только на время действия деплоя; если вы хотите просмотреть журналы после остановки деплоя, пожалуйста, [интегрируйте стороннее хранилище журналов](https://docs.edgegap.com/docs/deployment/endpoint-storage).
* Смотрите [#id-5.-deployment-stopped](#id-5.-deployment-stopped "mention") чтобы выявить все причины остановки вашего деплоя.

</details>

<details>

<summary>Мой деплой автоматически остановился через X минут.</summary>

* Для деплоев в бесплатном тарифе действует лимит 60 минут; пожалуйста, рассмотрите возможность обновления аккаунта.
* Cloud-деплои будут завершены после 24 часов работы в соответствии с нашей политикой очистки серверов, для обслуживания инфраструктуры и чтобы предотвратить непредвиденные расходы, если деплой не был корректно остановлен. Для длительно работающих серверов свыше 24 часов рассмотрите использование [Частные флоты](https://docs.edgegap.com/ru/learn/orkestraciya/chastnye-floty.md) с [Постоянство](https://docs.edgegap.com/ru/learn/orkestraciya/postoyanstvo.md).
* Смотрите [#id-5.-deployment-stopped](#id-5.-deployment-stopped "mention") чтобы выявить все причины остановки вашего деплоя.

</details>

<details>

<summary>Мой деплой готов, но я не могу подключиться еще несколько минут после этого.</summary>

* Когда деплой становится Ready, начинается инициализация игрового движка. Этот процесс может занять от нескольких секунд до нескольких минут, и в этот период сервер не принимает подключения игроков.
* Рассмотрите возможность оптимизировать инициализацию сервера, чтобы сократить это время.
* Игровые клиенты должны повторять попытку подключения с интервалом в 1 секунду в течение ограниченного времени (в зависимости от длительности инициализации), после чего они возвращаются к подбору игроков.
* Рассмотрите возможность добавить загрузочную сцену, чтобы сервер мог выполнять инициализацию (и переход в случае Unreal Engine) одновременно с клиентами, синхронизируя состояние обеих сторон.

</details>

<details>

<summary>На моем устройстве Meta Quest возникает <code>HTTP 0: Не удается разрешить адрес назначения</code> .</summary>

* При сборке приложений Unity для Android разрешение на доступ к Интернету может автоматически удаляться из выходного клиентского APK-артефакта сборки.
* Снова добавьте разрешения в (после этого потребуется пересобрать клиент):
  * Project Settings / OpenXR / :gear: Meta Quest Support / Force Remove Internet Permissions (снимите галочку).
  * Player Settings / Internet Access (установите require).

</details>

<details>

<summary>Что произойдет, если игрок покинет мой деплой?</summary>

* По умолчанию серверы не отклоняют подключения игроков. Аутентификация игроков — на усмотрение ваших разработчиков, поскольку можно использовать множество разных методов и провайдеров аутентификации игроков.
* Игровые клиенты могут хранить информацию о подключении локально, чтобы попытаться переподключиться в случае непредвиденного сбоя клиента.
* Чтобы позволить игрокам присоединяться к уже идущим играм, рассмотрите использование [Подробный обзор](https://docs.edgegap.com/ru/learn/matchmeiking/matchmaker-in-depth.md#backfill) или [Сессии](https://docs.edgegap.com/docs/deployment/session).

</details>

<details>

<summary>Мой сервер показывает 100% загрузку CPU после перехода в Ready.</summary>

* Это может не быть проблемой, поскольку игровые движки обычно выполняют ресурсоемкие операции CPU во время инициализации сервера. Если загрузка CPU не снизится через 2–3 минуты после запуска деплоя, возможно, вам нужно оптимизировать сервер или увеличить ресурсы версии приложения.
* Снижение tick rate может повлиять на загрузку CPU, поскольку сервер будет выполнять меньше операций обмена сообщениями.
* Если вы используете netcode Mirror, вам нужно иметь [«Auto Start Server»](https://mirror-networking.gitbook.io/docs/hosting/edgegap-hosting-plugin-guide#build-and-push) выбранным в вашем `NetworkManager` , пересоберите, отправьте и повторно задеплойте ваш сервер.
* Если вы используете netcode FishNet, вам нужно включить [«Start on Headless»](https://fish-networking.gitbook.io/docs/manual/components/managers/server-manager#settings-are-general-settings-related-to-the-servermanager) в вашем `ServerManager`, пересоберите, отправьте и повторно задеплойте ваш сервер.
* В бесплатном тарифе вам доступно только 1,5 vCPU и 3 ГБ памяти (RAM).
* Вы можете увеличить выделенные ресурсы при создании новой версии приложения. Вы можете дублировать версию приложения в нашей панели управления и при необходимости изменить эти значения без пересборки сервера или образа.

</details>

<details>

<summary>Мой деплой постоянно перезапускается и показывает ошибку `OOM kill`.</summary>

* Такое поведение вызвано превышением выделенного объема памяти. Рассмотрите возможность оптимизации использования памяти с помощью object pooling, сжатия или удаления ненужных объектов в вашей сцене.
* Убедитесь, что ваш проект загружает сцену по умолчанию, содержащую ваш `NetworkManager` и что эта сцена включена в Build Settings Unity.
* В бесплатном тарифе вам доступно только 1,5 vCPU и 3 ГБ памяти (RAM).
* Вы можете увеличить выделенные ресурсы при создании новой версии приложения. Вы можете дублировать версию приложения в нашей панели управления и при необходимости изменить эти значения без пересборки сервера или образа.

</details>

<details>

<summary>Иногда использование памяти (RAM) на моем сервере резко возрастает до высокого значения — это проблема?</summary>

* Пока вы остаетесь в пределах выделенного объема памяти версии приложения, это не проблема.&#x20;
* Превышение выделенного объема памяти версии приложения приведет к \`OOM kill\` (см. выше).

</details>

<details>

<summary>Будет ли производительность моего сервера затронута другими серверами, работающими на той же машине?</summary>

* Нет, наша платформа гарантирует, что выделенные ресурсы не будут использоваться другими студиями или другими серверами на общей инфраструктуре. С Edgegap нет «шумных соседей».

</details>

[^1]: сессии могут длиться до 24 часов

[^2]: равно

[^3]: не равно

[^4]: request\_id (deployment ID)

[^5]: в массиве

[^6]: не в массиве

[^7]: меньше или равно

[^8]: больше или равно

[^9]: &#x20;в массиве

[^10]: сопоставление шаблона без учёта регистра:

    * используйте `%`  для любой последовательности
    * используйте `_`  для любого одного символа

[^11]: по возрастанию, сначала самые старые

[^12]: по убыванию, сначала самые новые

[^13]: по возрастанию, сначала заполненные

[^14]: по убыванию, сначала пустые
