> 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/unity.md).

# Unity — начало работы

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

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

{% embed url="<https://youtu.be/4FR04V4YEUk>" %}

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

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

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

<details>

<summary>Установите модули поддержки сборки Unity для Linux</summary>

* Используйте Unity Hub, чтобы выбрать вкладку **Устанавливает**, доступ **Настройки** и **Добавить модули** для каждой версии Unity, которую вы планируете использовать с платформой Edgegap:

<figure><img src="https://3845012722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2FylRG4r8orenZrw5ijjpJ%2Fimage.png?alt=media&amp;token=fb981825-8a15-4c07-9180-0f79a6a77a91" alt=""><figcaption></figcaption></figure>

* Прокрутите вниз, чтобы выбрать и установить следующие модули Unity:
  * **Поддержка сборки для Linux (IL2CPP),**
    * **Поддержка сборки для Linux (Mono),**
    * **Поддержка сборки выделенного сервера для Linux**

<figure><img src="https://3845012722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2FuXtyqoLhBOk8CZJ4WdzA%2Fimage.png?alt=media&amp;token=19e956ed-a731-420d-b911-130c334794fc" alt=""><figcaption></figcaption></figure>

</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>

<details>

<summary><a href="https://github.com/edgegap/buildtool-unity-plugin">Установите плагин быстрого старта Edgegap для выделенных серверов Unity</a></summary>

Пожалуйста, обратитесь к [официальному репозиторию плагинов](https://github.com/edgegap/buildtool-unity-plugin) за подробными инструкциями по установке.

Этот плагин был протестирован и поддерживает версии Unity 2021.2+, включая все выпуски LTS, Unity 2023 и Unity 6.

{% embed url="<https://youtu.be/3a5veDyxpoE>" %}

</details>

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

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

☑️ Войдите в систему и убедитесь, что в консоли Unity нет новых ошибок, связанных с плагином Edgegap.

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

<details>

<summary>Устранение неполадок и FAQ</summary>

`!Успех: 400 BAD REQUEST - POST | https://api.edgegap.com/v1/wizard/init-quick-start - {"message": "The browser (or proxy) sent a request that this server could not understand."}`

* Если вы устанавливали, копируя ZIP-файл, или использовали пример проекта с копией плагина, установленной таким способом, вам нужно будет вручную установить зависимости пакета, включая библиотеку Newtonsoft JSON, см. [официальному репозиторию плагинов](https://github.com/edgegap/buildtool-unity-plugin/tree/main?tab=readme-ov-file#instructions-1).
* Пожалуйста, свяжитесь с нами на [Discord сообщества](https://discord.gg/NgCnkHbsGp) за помощью, если это не так.

</details>

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

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

☑️ **Убедитесь, что вы установили необходимые инструменты сборки Unity для Linux.**

<details>

<summary>Установите модули поддержки сборки Unity для Linux</summary>

* Используйте Unity Hub, чтобы выбрать вкладку **Устанавливает**, доступ **Настройки** и **Добавить модули** для каждой версии Unity, которую вы планируете использовать с платформой Edgegap:

<figure><img src="https://3845012722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2FylRG4r8orenZrw5ijjpJ%2Fimage.png?alt=media&amp;token=fb981825-8a15-4c07-9180-0f79a6a77a91" alt=""><figcaption></figcaption></figure>

* Прокрутите вниз, чтобы выбрать и установить следующие модули Unity:
  * **Поддержка сборки для Linux (IL2CPP),**
    * **Поддержка сборки для Linux (Mono),**
    * **Поддержка сборки выделенного сервера для Linux**

<figure><img src="https://3845012722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2FuXtyqoLhBOk8CZJ4WdzA%2Fimage.png?alt=media&amp;token=19e956ed-a731-420d-b911-130c334794fc" alt=""><figcaption></figcaption></figure>

</details>

☑️ Измените настройки сборки, чтобы **убедиться, что все необходимые сцены игры включены**.

{% hint style="info" %}
**Опытные пользователи Unity** - при желании измените [настройки сборки Unity](https://docs.unity3d.com/Manual/BuildSettings.html). Внимание! Это может сломать вашу сборку.
{% endhint %}

☑️ Необязательно: добавьте специфичный для netcode скрипт для проверки портов и инициализации окружения в вашу начальную серверную сцену из меню Edgegap Server Hosting (правый клик / :heavy\_plus\_sign: в окне Hierarchy).

<figure><img src="https://3845012722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2FZ8dV9ERoV3rczrXXUdV9%2Fimage.png?alt=media&amp;token=f7c44a27-7521-4392-9d11-276c48410ed0" alt="" width="360"><figcaption></figcaption></figure>

{% hint style="info" %}
После завершения шага [#id-6.-deploy-to-cloud](#id-6.-deploy-to-cloud "mention"), скрипт проверки порта выведет предупреждение, если адрес или порты netcode не совпадают с вашим [сопоставлением портов версии приложения Edgegap](https://docs.edgegap.com/ru/learn/orkestraciya/application-and-versions.md#other-parameters-optional) настройками.
{% endhint %}

{% hint style="success" %}
Сборки сервера должны использовать адрес `0.0.0.0`  и порт `7777`  в вашем транспортном слое netcode. Если вы настраиваете порт, укажите то же самое в вашем [Приложения и версии](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 %}

☑️ Когда вас устроит конфигурация, нажмите **Соберите сервер**, дождитесь завершения процесса и убедитесь, что в консоли Unity нет новых ошибок. Выполнение этого шага приведет к **появлению новой папки в корне проекта** - `Builds/EdgegapServer/ServerBuild` .

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

<details>

<summary>Устранение неполадок и FAQ</summary>

Unity: Единственные поддерживаемые автономные цели — Windows x64 и OSX с OpenXR.

* Откройте Packages и отключите OpenXR перед сборкой сервера.
* Плагин OpenXR нужен только клиентам и несовместим со сборками Linux-сервера. Исключая его из серверных сборок, вы не теряете никакой функциональности.

</details>

## 🐋 3. Контейнеризируйте сервер

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

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

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

☑️ Начните, нажав **Проверить** кнопку, чтобы убедиться, что вы завершили [#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>

☑️ Вы можете настроить следующие параметры (или оставить значения по умолчанию):

* **Путь сборки** — это относительный путь к артефакту вашей серверной сборки, пока оставим значение по умолчанию.

{% hint style="warning" %}
**Храните сборки внутри папки проекта**, Docker принимает только относительные пути сборки от корня проекта.
{% endhint %}

* **Имя образа** — это уникальный идентификатор на ваш выбор, которым вы помечаете сборку сервера перед публикацией.
  * Обычно сюда входит название вашей игры — например, «my-game-server».
* **Тег образа** — это идентификатор, указывающий на конкретную версию вашего образа.
  * Термин «артефакт сборки» иногда используется для обозначения конкретной версии вашего образа.
  * Отметки времени — отличный вариант по умолчанию для тегирования, например `2024.01.30-16.23.00-UTC` .
* **Путь к Dockerfile** можно использовать для настройки рецепта ваших образов.
  * Мы рекомендуем пока оставить значение по умолчанию, подробнее вы сможете прочитать позже в разделе [#customize-image](#customize-image "mention").
* **Необязательные параметры сборки Docker** можно использовать, чтобы дополнительно указать Docker более тонкие нюансы.
  * Мы рекомендуем пока оставить значение по умолчанию, вы можете [прочитать подробнее позже в документации Docker](https://docs.docker.com/reference/cli/docker/image/build/#options).

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

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

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

<details>

<summary>Устранение неполадок и FAQ</summary>

`/bin/bash: docker: command not found` , или `не удалось найти Packages\com.edgegap.unity-servers-plugin\Editor`

* Сначала убедитесь, что вы завершили [Инструменты разработчика](https://docs.edgegap.com/ru/unity/developer-tools.md#usage-requirements).
* Подтвердите, что вы верифицировали свою учетную запись Edgegap; вы должны были получить ссылку для подтверждения по электронной почте.
* Некоторые настройки могли сброситься после обновления Docker Desktop. Попробуйте перейти в Docker Desktop Settings / Advanced и в пункте “Choose how to configure the installation of Docker’s CLI tools:” выберите “System (requires password)”.

***

`docker build требует ровно 1 аргумент`

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

***

`(HTTP-код 400) неожиданно — неверный формат тега`

* Это [известная проблема версии Docker для macOS 4.33](https://github.com/docker/for-win/issues/14258), пожалуйста, рассмотрите откат до 4.32 или обновление до 4.35.

***

`ОШИБКА: не удалось решить: ubuntu:22.04: не удалось получить исходные метаданные для http://docker.io/library/ubuntu:22.04: не удалось авторизоваться: не удалось получить токен OAuth`

* Вы находитесь в Китае? Ваше соединение может прерываться Великим китайским файрволом. Попробуйте выполнить `docker pull ubuntu:22.04` в командной строке вручную (откройте командную строку, нажав Win+R, затем введите `cmd` и нажмите Enter).

***

`System.IndexOutOfRangeException: Индекс находился вне границ массива.`

* Если вы установили наш плагин быстрого старта Unity, скачав ZIP, кэш вашего Unity Editor может быть поврежден. Попробуйте удалить копию плагина и установить его, используя git URL или из Unity Asset Store. Пакет Newtonsoft.JSON больше не должен быть нужен, так как он автоматически включается вместе с другими исходными файлами.

***

Размер моего docker-образа огромный (более 1 ГБ) / крошечный (менее 100 МБ), это нормально?

* В некоторых случаях это может быть нормально, если вы можете запустить сервер и успешно подключиться (см. [#id-4.-test-your-server-locally](#id-4.-test-your-server-locally "mention")). Если это не так, рассмотрите ваши параметры сборки, сбросьте их до значений по умолчанию и постепенно добавляйте параметры, чтобы увидеть, как они влияют на размер сборки. См. также [#optimize-server-build-size](#optimize-server-build-size "mention").

***

Я сталкиваюсь с другой проблемой, не упомянутой нигде в этой документации.

* Сначала попробуйте [обновить ваш плагин Edgegap](https://github.com/edgegap/buildtool-unity-plugin?tab=readme-ov-file#update-the-plugin-in-unity) так как мы могли выпустить исправление. Если это не поможет, пожалуйста, свяжитесь с нами в нашем [Discord сообщества](https://discord.gg/NgCnkHbsGp) и мы оперативно разберемся вместе с вами.

</details>

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

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

☑️ Вы можете настроить следующие параметры (или оставить значения по умолчанию):

* **Тег образа сервера** из предыдущего шага.
  * По умолчанию используется последний тег, который вы собрали с помощью плагина.
* **Необязательные параметры docker run** можно указать для открытия нескольких портов или запуска вашего образа на машинах macOS.
  * При необходимости вы можете опубликовать несколько портов для вашего контейнера, просто добавьте параметр `-p {internal port}/{protocol}` для каждого, например `-p 8080/tcp -p 7777/udp` чтобы опубликовать и сопоставить порт вашего сервера `8080` с произвольным внешним портом для TCP-соединения и портом сервера `7777` с произвольным внешним портом для UDP-соединения одновременно. **Найдите настройку порта сервера в вашем Transport или в специфичных для netcode настройках.**
  * Если вы используете машину с архитектурой ARM (macOS M1, M2, M3 и т. д.), вы должны увидеть, что этот необязательный параметр включен в ваши Необязательные параметры сборки Docker: `--platform=linux/amd64` .

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

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

☑️ Теперь пришло время **подключить игровой клиент Unity Editor к вашему локальному docker-контейнеру** чтобы убедиться, что ваш образ сервера работает правильно. Найдите настройки клиента netcode и введите:

* `localhost` или `0.0.0.0` (в большинстве случаев эквивалентно) вместо IP сервера,
* случайное значение внешнего порта, указанное в Docker Desktop / Containers / edgegap-server-test.

<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>

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

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

<details>

<summary>Устранение неполадок и FAQ</summary>

Мне не удается подключиться к локальному docker-контейнеру с помощью игрового клиента Unity Editor.

* Сначала убедитесь, что статус контейнера Up и что он не находится в состояниях Restarting или Exited, что указывало бы на исключение во время выполнения. Если ваш контейнер не запущен, просмотрите его логи через вкладку Docker Desktop Containers (щелкните по вашему контейнеру) или с помощью `docker logs {container_id} --timestamps` через CLI Docker.
* Далее проверьте, что настройка порта Network Manager из вашей серверной сборки совпадает с опубликованным портом в **Необязательные параметры docker run**. Если это не так, попробуйте сбросить или вручную изменить значение этого поля, чтобы оно соответствовало `{container}` порту вашего Network Manager. Найдите свой протокол в настройках netcode.
* Наконец, убедитесь, что настройки netcode вашего игрового клиента Unity Editor используют порт, опубликованный в **Необязательные параметры docker run** (см. скриншот выше).

***

`(Ошибка сегментации) - core dumped`

* Если вы используете машину с архитектурой ARM (macOS M1, M2, M3 и т. д.), вы должны увидеть, что этот необязательный параметр включен в ваши Необязательные параметры сборки Docker: `--platform=linux/amd64` . Если это не так, попробуйте сбросить значение этого поля.

***

`SceneId 9120233082191360994 не найден в SceneObjects.`

* Это может означать, что сцена, которую вы пытаетесь загрузить, была неправильно включена в сборку, что является известной проблемой в старых версиях плагина. Чтобы исправить это, попробуйте обновить версию вашей интеграции netcode или [обновить ваш плагин Edgegap](https://github.com/edgegap/buildtool-unity-plugin?tab=readme-ov-file#update-the-plugin-in-unity).

***

`http2: server: error reading preface from client //./pipe/docker_engine: file has already been closed`

* Это [известная проблема старых версий Docker Desktop для Windows](https://github.com/docker/for-win/issues/13611). Обновите приложение Docker Desktop и попробуйте снова контейнеризировать.

***

`Ошибка Curl 35: Не удалось выполнить handshake сертификата. Фатальная ошибка. Код ошибки UnityTls: 7`

* Эта ошибка указывает на проблему проверки корневого SSL-сертификата, известную проблему в старых версиях плагина. Чтобы исправить это, попробуйте [обновить ваш плагин Edgegap](https://github.com/edgegap/buildtool-unity-plugin?tab=readme-ov-file#update-the-plugin-in-unity).

</details>

## ☁️ 5. Загрузите в Edgegap

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

☑️ Вы можете настроить следующие параметры (или оставить значения по умолчанию):

* **Имя приложения** в Edgegap может совпадать с именем вашего образа или быть настроено вручную.
  * Пока мы решили скопировать имя вашего образа.
* **Образ сервера** из шага [#id-3.-containerize-server](#id-3.-containerize-server "mention").

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

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

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

* **Версия приложения** в Edgegap может совпадать с вашим тегом или быть настроена вручную.
  * Метки времени — отличный вариант для названий версий приложения, например `2024.01.30-16.50.20-UTC` .
  * Несколько версий приложения могут указывать на один и тот же тег образа, например `v1.1.0` и `dev` .
  * Подробнее о [Приложения и версии](https://docs.edgegap.com/ru/learn/orkestraciya/application-and-versions.md) позже.

☑️ Теперь вам будет предложено задать порт для вашей новой версии приложения. Убедитесь, что установили то же значение порта сервера, что и на шаге [#id-4.-test-server-locally](#id-4.-test-server-locally "mention") из ваших настроек Transport или специфичных для netcode.

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

<details>

<summary>Устранение неполадок и FAQ</summary>

`отказано: добавление 756,6 МиБ ресурса хранения, которое при обновлении до текущего использования 4,3 ГиБ превысит настроенный верхний предел в 4,7 ГиБ` , `ошибка фиксации на ref "layer-sha256:--------": неожиданный статус от PUT-запроса к https://registry.edgegap.com/`

* Похоже, у вас закончилось место для хранения образов на [Регистр контейнеров](https://app.edgegap.com/registry-management/repositories/list). Рассмотрите возможность удаления неиспользуемых артефактов сборки (если они у вас есть) или оптимизации размера сборки сервера. Если вы используете пользовательский Dockerfile или .dockerignore, вы могли скопировать некоторые ненужные файлы в образ.

***

`Вы достигли лимита приложений: 2` , `Не удалось обновить тег/версию docker: вы достигли лимита версий приложения: 2`

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

***

Моя новая версия приложения не отображается в плагине/расширении.

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

</details>

## 🚀 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 или память), иначе новые подключения игроков могут быть отклонены, или ваш сервер застрянет в цикле перезапуска. См. ниже шаги по устранению неполадок для решения любых проблем.

☑️ Теперь мы выполним финальный тест и **подключите игровой клиент Unity Editor к вашему облачному развертыванию**. Введите данные подключения игрового клиента из Deployment:

* **хост** **URL** указывающий на IP сервера, обычно в `NetworkManager` компоненте.
* **Внешний порт** сопоставленный с [внутренним портом прослушивания сервера](https://docs.edgegap.com/ru/learn/orkestraciya/application-and-versions.md#port-mapping), обычно в компоненте Transport.

<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! Если хотите узнать больше, продолжайте чтение.

<details>

<summary>Устранение неполадок и FAQ</summary>

Не удаётся подключить клиентов к серверу - `Превышено время ожидания запроса.` , `Время ожидания запроса истекло` , `ConnectionFailed` , или `Проверка порта не удалась`

* Сначала убедитесь, что развёртывание находится в состоянии 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 развертывания, внешний порт и `roomCode` на сервере, а также тот же код комнаты в клиенте в [«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 Upgrade.
* Вы находитесь в Китае и используете [Обновлены игровые примеры](https://docs.edgegap.com/docs/deployment/session/fleet-manager/fleet)? Ваше соединение может быть заблокировано Великим китайским файрволом. Рассмотрите возможность добавить сервер, расположенный в Китае, в ваш пул или использовать VPN для подключения.

***

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

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

***

Моё развёртывание автоматически остановилось через X минут.

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

***

Моё развёртывание готово, но я не могу подключиться ещё несколько минут после этого.

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

***

Мое устройство Meta Quest выдает `HTTP 0: Не удается разрешить имя целевого хоста` .

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

***

Что произойдёт, если игрок покинет моё развёртывание?

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

***

Мой сервер показывает загрузку CPU 100% после того, как стал Ready.

* Это может не быть проблемой, поскольку игровые движки обычно выполняют ресурсоёмкие операции ЦП во время инициализации сервера. Если загрузка CPU не снизится через 2–3 минуты после запуска развёртывания, возможно, вам нужно оптимизировать сервер или увеличить ресурсы версии приложения.
* Снижение частоты тиков может повлиять на загрузку 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`, пересоберите, отправьте и заново разверните ваш сервер.
* В Free Tier вы ограничены 1,5 vCPU и 3 ГБ памяти (RAM).
* Вы можете редактировать выделенные ресурсы для существующих версий или дублировать свою версию и изменить ресурсы в новой копии. Ни то, ни другое не требует пересборки сервера.

***

Моё развёртывание перезапускается снова и снова и показывает ошибку `OOM kill`

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

***

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

* Пока вы не выходите за пределы выделенного объёма памяти для версии приложения, это не является проблемой.
* Превышение выделенного объёма памяти версии приложения приведёт к `OOM kill` (см. выше).

***

Будет ли производительность моего сервера ухудшаться из-за других серверов, работающих на той же машине?

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

</details>

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

После того как у вас настроена рабочая клиент/серверная система, убедитесь, что **сохранили копию вашего проекта** (используя систему контроля версий, такую как 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)

{% hint style="success" %}
Импортируйте наш `DeploymentAgent`  пример из Unity SDK, чтобы **легко и надежно останавливать серверы**.
{% 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) — настраиваемые пары ключ-значение, задаваемые вами.

{% hint style="success" %}
Импортируйте наш `DeploymentAgent`  пример из Unity SDK, чтобы **легко читать строго типизированные переменные**.
{% endhint %}

### Session Automation

При тестировании новых сборок с разработчиками или командами 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 %}

### Оптимизация сборок

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

Рассмотрите возможность использования [Инкрементальные сборки Unity](https://docs.unity3d.com/Manual/incremental-build-pipeline.html) чтобы ускорить время сборки.

* Рассмотрите возможность использования [Инкрементальные сборки Unity](https://docs.unity3d.com/Manual/incremental-build-pipeline.html) чтобы ускорить время сборки.

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

* Копирование неиспользуемых файлов в ваши образы приводит к их раздуванию, более долгой загрузке, более медленной скорости кэширования и более медленному общему запуску сервера. [Ознакомьтесь с рекомендациями по оптимизации Docker-образов](https://docs.docker.com/build-cloud/optimization/#dockerignore-files).

**Отключите статическую батчинг-сборку мешей, чтобы уменьшить размер образа.**

* [Отключите статическую батчинг-сборку для более быстрых сборок, загрузок и развертываний.](https://docs.unity3d.com/Manual/DrawCallBatching.html)

**Сжимайте меши, чтобы уменьшить размер образа.**

* [Установите сжатие мешей на High для более быстрых сборок, загрузок и развертываний.](https://docs.unity3d.com/6000.0/Documentation/Manual/compressing-mesh-data-optimization.html)
* Сжатие вершин не влияет на размер образа.

**Реализуйте условную ленивую загрузку ресурсов.**

* Исключайте ресурсы, предназначенные только для клиента, путем [отключения CPU read/write для текстур и мешей](https://docs.unity3d.com/6000.0/Documentation/Manual/dedicated-server-optimizations.html).
* Рассмотрите возможность использования [Unity Addressables](https://docs.unity3d.com/Packages/com.unity.addressables@2.1/manual/index.html) для ваших клиентских сборок, чтобы ускорить сборки и развертывания за счет [загрузки ресурсов точно в нужный момент](https://docs.unity3d.com/Packages/com.unity.addressables@1.19/manual/LoadingAddressableAssets.html), либо пропускайте загрузку некоторых ресурсов в серверных сборках, проверяя наличие [Развертывания](https://docs.edgegap.com/ru/learn/orkestraciya/deployments.md#injected-environment-variables).

**Рассмотрите возможность использования** [**многоэтапных сборок Docker (ссылка)**](https://docs.docker.com/build/building/multi-stage/)**.**

* Вынесите крупные зависимости сервера в отдельный образ, чтобы использовать их в многоэтапных сборках повторно. Docker будет кэшировать каждый слой и просто переиспользовать предыдущую версию, пропуская загрузку этой части, если явно не указано иное, экономя вам трафик и время ожидания завершения загрузки.
* Если вы не уверены, почему одна из команд вашего Dockerfile выдаёт ошибку, попробуйте отладку локально. Создайте новый этап непосредственно перед тем, как возникает проблема (добавьте вторую `FROM` команду), используйте `--target` чтобы указать процессу сборки остановиться на проблемном этапе, а затем `docker exec -it {container} /bin/bash` чтобы войти в интерактивный терминал внутри вашего контейнера. После этого вы можете использовать команды оболочки в вашем базовом образе, чтобы продолжить исследование (например, `top` в ubuntu).

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

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

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

* Прежде чем предполагать, что проблема связана с пользовательским 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) для размещения баз данных и длительно работающих сервисов.

{% hint style="info" %}
Уперлись в стену? Мы доступны в нашем [Discord сообщества](https://discord.gg/MmJf8fWjnt) и будем рады помочь.
{% endhint %}
