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

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

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

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

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

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

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

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

<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://store.godotengine.org/asset/edgegap-godot/dedicated-game-server-hosting-for-godot/">Установите плагин быстрого запуска Edgegap для выделенных серверов Godot</a></summary>

Плагин протестирован и поддерживает Godot версии 4.3.x и новее.

Вариант 1. Установка из Asset Store:

1. Откройте проект в редакторе Godot.
2. Откройте вкладку Asset Store и выполните поиск по запросу «edgegap».
3. Выберите «Game Server Hosting for Godot» и нажмите Download.

{% hint style="info" %}
Чтобы обновить плагин, перейдите в Project / Project Settings / Plugins / Edit и выберите Update.
{% endhint %}

Вариант 2. Установка из исходного кода:

1. [Установите клиент Git (например, git-scm).](https://git-scm.com/).
2. В корневой папке проекта клонируйте репозиторий нашего плагина в `addons/edgegap`.

{% code collapsedlinecount="10" %}

```bash
git clone https://github.com/edgegap/buildtool-godot-plugin.git addons/edgegap
```

{% endcode %}

{% hint style="info" %}
Чтобы обновить плагин, установленный через Git, откройте командную строку в папке плагина и выполните команду `git pull`.
{% endhint %}

</details>

{% hint style="info" %}
**Включите новый плагин Edgegap Servers Quickstart в разделе Project / Project Settings / Plugins.** На панели справа, рядом с Inspector, появится новая вкладка «Edgegap». Если позже вы закроете эту панель и захотите открыть её снова, найдите соответствующий пункт в Project / Tools / Edgegap.
{% endhint %}

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

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

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

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

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

☑️ **Проверьте шаблоны экспорта, чтобы убедиться, что плагин правильно настроил шаблон сервера Linux.**

{% hint style="info" %}
**Для опытных пользователей**  — при желании настройте [шаблон экспорта](https://docs.godotengine.org/en/latest/tutorials/export/exporting_projects.html). Внимание! Это может нарушить сборку.
{% endhint %}

☑️ **Добавьте в проект новый скрипт начальной настройки, чтобы автоматически запускать игру как выделенный сервер.** Создайте новый узел в основной сцене и укажите новый скрипт в Inspector / Script / Load.

{% tabs %}
{% tab title="Пример скрипта начальной настройки по умолчанию" %}
Это минимальный шаблон скрипта, который можно расширить в соответствии с потребностями проекта.

{% file src="/files/a8dceb63cbea51009186e6f0c2cc2bdaf033645c" %}
{% endtab %}

{% tab title="Пример Netfox Forest Brawl" %}
Это настроенная версия скрипта начальной настройки для [netfox forest brawl](#netfox-forest-brawl-example)  — примера.

{% file src="/files/00bc477ce891e7aded2e9d041822391b636dfbd3" %}
{% endtab %}
{% endtabs %}

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

☑️ Когда конфигурация будет готова, нажмите **Собрать сервер**, дождитесь завершения процесса и убедитесь, что в Output не появилось новых ошибок. После выполнения этого шага в папке проекта появится **новая сборка в папке** `build`**.**

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

☑️ Когда настройки будут готовы, нажмите **Upload image and create App version**, дождитесь завершения процесса и убедитесь, что в разделе Output не появилось новых ошибок.

☑️ Откроется наша панель [Dashboard](https://app.edgegap.com/), где можно настроить дополнительные параметры. После выполнения этого шага будет создана [новая версия приложения](https://app.edgegap.com/application-management/applications/list), а [артефакт сборки будет помечен тегом и загружен в реестр контейнеров 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") (по умолчанию — 7777).

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

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

☑️ Теперь проведём заключительный тест и **подключим игровой клиент в Godot Editor к вашему развертыванию в облаке**. Возьмите **адрес хоста развертывания** вместо IP-адреса сервера, а также **внешний порт**развертывания, укажите их в данных для подключения клиента и запустите игру.

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

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

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

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

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

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

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

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

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

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

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

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

{% hint style="success" %}
Примеры для Godot Script скоро появятся!
{% endhint %}

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

### Передаваемые переменные

Получайте полезную информацию — например, идентификатор развертывания, 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" %}
Примеры для Godot Script скоро появятся!
{% endhint %}

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

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

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

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

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

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

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

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

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

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

{% hint style="success" %}
Примеры для Godot Script скоро появятся!
{% endhint %}

### Steam (сервер GodotSteam)

Публикация игры в Steam с помощью [GodotSteam](https://godotsteam.com/)? Ваш выделенный сервер может использовать [GodotSteam Server](https://codeberg.org/godotsteam/godotsteam-server) для входа в Steam и проверки, что каждый подключившийся игрок — настоящий пользователь Steam, владеющий вашей игрой.

Следуйте руководству [«Размещение выделенного сервера GodotSteam Server на Edgegap»](https://docs.edgegap.com/ru/docs/sample-projects/godot/godotsteam-server.md) чтобы:

* экспортировать headless-сервер для Linux с расширением GDExtension GodotSteam Server;
* войти на сервере в Steam и проверять билеты аутентификации Steam игроков;
* добавить `steamclient.so` из Steam в образ Docker с помощью SteamCMD;
* развернуть сервер на Edgegap и подключить клиенты Steam.

{% hint style="warning" %}
Стандартный Dockerfile плагина Edgegap копирует только исполняемый файл сервера и `.pck`. GodotSteam Server также нужны файлы `.so` и `steamclient.so` в образе: используйте Dockerfile из руководства.
{% endhint %}

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

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

**Чем выше частота тиков, тем больше обновлений, а значит, выше нагрузка на ЦП и объём исходящего трафика.**

* По умолчанию Godot выполняет 60 тиков в секунду — это отлично подходит для динамичных шутеров и игр, особенно чувствительных к задержкам. Для других жанров может быть достаточно 30 или даже 15 Гц.
* Скрытая цена высокой частоты тиков — дополнительные циклы ЦП (в секунду), необходимые для упаковки и распаковки данных, а также повторного вычисления свойств и процедур, авторитетных на стороне сервера. Будьте осторожны, если в матче много игроков (10 и более), узлов с коллайдерами, сложных физических симуляций или ботов-противников и ботов-союзников.
* Проверьте отзывчивость игры при разных значениях частоты тиков в настройках сетевого кода. Для ENET см. «Настройки проекта» / «Физика» / «Общие» / «Тиков в секунду (физика)».

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

* Встроенный в Godot протокол ENET с настройками UDP по умолчанию — отличный вариант: он обеспечивает высокую производительность и совместимость с широким спектром устройств и сценариев использования.
* Для некоторых игр может быть полезно поэкспериментировать с TCP, WS, WebRTC или другими протоколами. Это может повысить надёжность соединения на мобильных устройствах и консолях, особенно в общедоступных сетях (мобильных, корпоративных, в интернет-кафе, гостиницах и т. п.), но потребует дополнительной работы над проектом. Подумайте, насколько это важно для вашей целевой аудитории.
* Одновременное использование нескольких протоколов, чтобы важные обновления доставлялись с приоритетом, может улучшить игровой процесс в некоторых жанрах (например, в MMO). Однако это потребует значительных дополнительных усилий и может сильно усложнить проект.
* Тщательно выбирайте, за что браться: в разработке игр и без того хватает сложностей.

### Настройка образа

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