> 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/docs/tools-and-integrations/docker.md).

# Docker и контейнеры

Почему Edgegap запускает игровые серверы в контейнерах и как настроить Docker перед сборкой своего первого образа сервера.

{% columns %}
{% column width="25%" %}

<figure><img src="https://3845012722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Fgit-blob-e6111f686dccc8bebc29f2f10fe2ce093f9c2b9c%2Fdocker.png?alt=media" alt="" width="100"><figcaption></figcaption></figure>
{% endcolumn %}

{% column width="75%" %}
Docker — это открытая платформа для разработки, доставки и запуска приложений. Docker позволяет отделить ваши приложения от инфраструктуры, чтобы вы могли быстро поставлять программное обеспечение.
{% endcolumn %}
{% endcolumns %}

## Зачем использовать Docker?

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

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

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

## Контейнеры

А **контейнер — это стандартная единица программного обеспечения, которая упаковывает код** и все его зависимости, чтобы приложение работало быстро и надежно из одной вычислительной среды в другую. Контейнеры изолируют ПО от своей среды и обеспечивают его единообразную работу, несмотря на различия, например, между средой разработки и промежуточной средой.

\
После запуска упакованных образов Docker они становятся:

* **Контейнеры** если запускать в Docker Desktop или Docker Engine (обычно локально),
* &#x20;[Развертывания](https://docs.edgegap.com/ru/learn/orkestraciya/deployments.md) если запускать на Edgegap (как в Edge Cloud, так и в Private Fleet).

Контейнер нативно работает в Linux (или в Docker Desktop) и разделяет ядро хост-машины с другими контейнерами. Он выполняет отдельный процесс, потребляя не больше памяти, чем любой дополнительный исполняемый файл, что делает его легковесным.

<figure><img src="https://3845012722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Fgit-blob-f150d345ddba740a7babd5338aca3f557cc1886c%2Fcontainer-architecture.png?alt=media" alt=""><figcaption></figcaption></figure>

## **Попробуйте сами**

Чтобы использовать Docker и собирать или запускать образы Docker локально, вам нужно установить Docker:

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

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

{% code collapsedlinecount="10" %}

```sh
docker run -d -p 80:80 --name speedtest edgegap/speedtest-edge
```

{% endcode %}

Это автоматически выполнит следующие шаги:

1. Скачать образ speedtest из репозитория Edgegap (только в первый раз).
2. Создать и запустить новый контейнер с использованием этого образа на вашем компьютере.
3. Назначить имя "speedtest" (с использованием `--name` параметра).
4. Открыть [Приложения и версии](https://docs.edgegap.com/ru/learn/orkestraciya/application-and-versions.md#port-mapping) чтобы связать порт вашей машины `80`  с портом контейнера `80` , обеспечив доступ к контейнеру с вашей машины.

✅ Откройте [http://localhost:80](http://localhost/) в предпочитаемом браузере, чтобы убедиться, что контейнер успешно запустился.

При запущенном контейнере мы можем выполнять базовые действия — перезапуск, остановку, мониторинг.&#x20;

Сначала посмотрим, что запущено на вашем Docker Engine, используя предпочитаемый терминал.

{% code collapsedlinecount="10" %}

```sh
docker ps
```

{% endcode %}

Это выведет информацию о запущенных контейнерах, например:

{% code collapsedlinecount="10" %}

```
ИД КОНТЕЙНЕРА        ОБРАЗ                    КОМАНДА                  СОЗДАН         СТАТУС              ПОРТЫ                ИМЕНА
dbf4d3734111        edgegap/speedtest-edge   "docker-php-entrypoi…"   29 минут назад      Работает 29 минут    0.0.0.0:80->80/tcp   speedtest
```

{% endcode %}

Вы можете запустить любое количество контейнеров.

Давайте попробуем получить больше информации о вашем контейнере:

{% code collapsedlinecount="10" %}

```sh
docker container inspect speedtest
```

{% endcode %}

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

{% code collapsedlinecount="10" %}

```sh
docker network ls
```

{% endcode %}

Это выведет информацию о сети, запущенной Docker Engine на вашем компьютере.

{% code collapsedlinecount="10" %}

```
ИД СЕТИ          ИМЯ                 ДРАЙВЕР             ОБЛАСТЬ
67b24038b9ca        bridge              bridge              local
6f7fe43a489d        host                host                local
3d80cdb86a7e        none                null                local
```

{% endcode %}

Также можно подробнее изучить отдельные сети:

{% code collapsedlinecount="10" %}

```sh
docker network inspect 67b24038b9ca
# где 678b24038b9ca — это ваша сеть, подключенная к вашему контейнеру
```

{% endcode %}

Когда закончите тестирование контейнера, обязательно остановите его, чтобы освободить ресурсы (CPU и RAM), которые контейнер использовал:

{% code collapsedlinecount="10" %}

```sh
docker container stop speedtest
```

{% endcode %}

## SSH-туннель

Чтобы глубоко разбирать проблемы сервера, вы можете открыть SSH-службу в ваших образах и подключаться к контейнеру или развертыванию так же, как к любому удаленному хосту или ВМ.

{% hint style="danger" %}
**Никогда не открывайте SSH-службу в production-развертываниях** - это серьезная проблема безопасности.
{% endhint %}

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

Нам потребуется внести несколько изменений в ваш Dockerfile. Давайте установим службу OpenSSH, создадим пользователя с паролем и включим службу.

{% hint style="success" %}
**Порядок команд в Dockerfile имеет значение!** [Docker кэширует слои, чтобы ускорить сборки.](https://docs.docker.com/build/cache/) Сохраняйте некэшируемые слои, такие как `RUN` и `COPY` в конце вашего Dockerfile (перед `CMD`).
{% endhint %}

Объедините эти команды Dockerfile в вашем Dockerfile:

{% tabs %}
{% tab title="Базовый образ Ubuntu" %}
{% code collapsedlinecount="10" %}

```dockerfile
RUN apt-get update
RUN apt-get install openssh-server sudo -y

RUN useradd -rm -d /home/ubuntu -s /bin/bash -g root -G sudo -u 1000
RUN echo 'tester:$ecureP@ss' | chpasswd
# не забудьте сменить пароль ^

EXPOSE 22
```

{% endcode %}
{% endtab %}

{% tab title="Базовый образ Alpine" %}
{% code collapsedlinecount="10" %}

```dockerfile
RUN apk --update add --no-cache openssh bash
RUN sed -i s/#PermitRootLogin.*/PermitRootLogin\ yes/ /etc/ssh/sshd_config

RUN echo "tester:$ecureP@ss" | chpasswd
# не забудьте сменить пароль ^

EXPOSE 22
```

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

{% hint style="info" %}
`EXPOSE` не публикует порты автоматически, это подсказка для Docker Engine и разработчиков.
{% endhint %}

Нам также нужно будет запустить службу ssh в контейнере:

{% tabs %}
{% tab title="Начиная с Dockerfile (плагин Unity)" %}
{% code title="Dockerfile" collapsedlinecount="10" %}

```docker
CMD [ \
  "/bin/bash", "-c", \
  "service ssh start; exec /path/to/server-executable" \
]
# запускает SSH, затем заменяет оболочку игровым сервером
```

{% endcode %}
{% endtab %}

{% tab title="Начиная с shell-скрипта .sh (Unreal)" %}
{% code title="StartServer.sh" collapsedlinecount="10" %}

```sh
service ssh start
```

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

{% hint style="warning" %}
Вы не можете запустить службу SSH с помощью `RUN` команды, поскольку она выполняется только на этапе сборки.
{% endhint %}

✅ Теперь `docker build`, и протестируйте `docker run`  локально, затем проверьте с помощью `ssh localhost:22`.

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

{% hint style="success" %}
**Сначала разберите проблемы локально (и безопасно), не отправляя образ в реестр.**
{% endhint %}

### Развернуть в облаке

Если у вас не получилось с [#test-locally](#test-locally "mention"), вы можете протестировать в среде развертывания.

✅ [Войдите в свой Docker-реестр](https://app.edgegap.com/registry-management/repositories/list) и  `docker push`  новый тег:

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

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

project='<REGISTRY_PROJECT>';
image='<MY_IMAGE_NAME>';
tag='<MY_TAG>';

echo "$token" | docker login registry.edgegap.com -u "$username" --password-stdin 2>&1;
docker push "${registry}/${project}/${image}:${tag}";
```

{% endcode %}

✅ [Создайте новую тестовую версию приложения для этого образа через панель управления.](https://app.edgegap.com/application-management/applications/list)

* Добавьте сопоставление порта для 22/TCP, чтобы повторить `-p` опцию из `docker run`.

✅ [Развернуть](https://app.edgegap.com/deployment-management/deployments/create) и используйте URL или IP с внешним SSH-портом, назначенным для `ssh`.

✅ После завершения тестирования остановите развертывание и удалите ваш тестовый образ.
