> 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/advanced-features/edgegap-container-registry.md).

# реестр контейнеров

Храните образы контейнеров вашего игрового сервера в бесплатном встроенном реестре Edgegap, готовом к развертыванию по глобальной периферийной сети.

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

Именно поэтому мы создали Edgegap Container Registry. Это частно управляемый репозиторий контейнеров, который работает во многом как стандартные публичные реестры контейнеров, но с дополнительными преимуществами: повышенной безопасностью, сканированием уязвимостей и другими полезными возможностями! Благодаря высокой доступности и интеграции с панелью управления вы будете тратить меньше времени на изучение новых инструментов, а ваши серверы всегда будут готовы к работе.

### Получение ваших учетных данных

Чтобы загружать образы, сначала вам нужно пройти аутентификацию в нашем реестре, а для этого вам нужны учетные данные. Найдите `Реестр контейнеров` вкладку в разделе `Служба` в боковой панели, чтобы запросить свои учетные данные. Оттуда вы сможете запросить доступ к нашему реестру.

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

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

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

| Поле             | Описание                                                                               |
| ---------------- | -------------------------------------------------------------------------------------- |
| URL              | URL нашего реестра контейнеров. Он понадобится вам при входе и загрузке образов.       |
| Проект           | Название назначенного вам проекта. Вы должны включить его в путь к репозиторию образа. |
| Имя пользователя | Имя пользователя, которое нужно использовать для входа в реестр.                       |
| Токен            | Пароль, который нужно использовать для входа в реестр.                                 |

Войдите в реестр с помощью Docker, используя название проекта реестра, имя пользователя и токен:

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

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

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

{% endtab %}

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

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

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

{% endtab %}
{% endtabs %}

### Предупреждение о входе в Docker

{% code collapsedlinecount="10" %}

```
ВНИМАНИЕ! Ваш пароль будет храниться без шифрования в /home/user/.docker/config.json.
```

{% endcode %}

Вы можете настроить хранилище учетных данных, следуя [этой инструкции](https://docs.docker.com/engine/reference/commandline/login/#credentials-store). Помните, что это предупреждение — нормальное поведение Docker.

Это **важно** понимать, что имя пользователя вашего робота и токен для вашего частного репозитория закодированы в base64 на вашей машине по этому пути `$HOME/.docker/config.json`. Любой, у кого есть доступ к этому файлу, может легко расшифровать токен вашей учетной записи робота с помощью декодера base64. Убедитесь, что среда `docker login registry.edgegap.com` которую вы используете, безопасна, а права доступа к этому файлу ограничены.

Чтобы удалить свои учетные данные из этого файла, вы можете просто использовать `docker logout registry.edgegap.com` каждый раз, когда вы загружаете и извлекаете свои частные образы.

### Загрузка образа в реестр

Если вам нужна помощь с контейнеризацией вашего проекта, см. [нашу документацию по этой теме](https://docs.edgegap.com/ru/docs/tools-and-integrations/docker.md) чтобы начать.

Сначала вам нужно добавить тег к вашему образу, соответствующий реестру. Затем, поскольку вы уже вошли в реестр, все, что вам нужно сделать, — это отправить ваш образ по URL и в проект, указанные на странице:

{% code collapsedlinecount="10" %}

```bash
docker image tag <IMAGE_NAME>:<TAG> registry.edgegap.com/<PROJECT_NAME>/<IMAGE_NAME>:<TAG>
docker push registry.edgegap.com/<PROJECT_NAME>/<IMAGE_NAME>:<TAG>
```

{% endcode %}

Вы можете загружать столько образов, сколько позволяет ваше хранилище, и разделять их по разным репозиториям по своему усмотрению. Однако вам следует прочитать раздел "App templates" перед тем, как загружать слишком много образов!

Затем вы найдете свои репозитории на той же странице после обновления.

### Множественное тегирование одного и того же артефакта сборки (загрузка дубликата образа)

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

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

### Управление вашими образами

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

Нажав на один из этих репозиториев, вы можете увидеть содержащиеся в нем образы, сгруппированные по артефактам. Если вы пометили один и тот же образ двумя разными тегами и загрузили их в реестр, вы увидите их как один и тот же артефакт.

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

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

Образы с тегами `1.0.1` и `1.0.2` на изображении выше имеют один и тот же артефакт. Образ с тегом `1.0.3`, однако, имеет другой артефакт.

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

### Удаление артефактов сборки через API

Если интерфейс панели управления слишком медленный для вас, или если вам нужен автоматизированный конвейер непрерывной интеграции, который будет автоматически удалять устаревшие артефакты сборки, чтобы объем использования реестра оставался в пределах лимитов, рассмотрите возможность использования нашего Container Registry API. Наш [Container Registry API](https://docs.edgegap.com/ru/docs/api.md) позволяет выводить список всех тегов для данного приложения (образа), а также удалять отдельные теги. Поскольку каждый артефакт образа (сборка) может одновременно иметь несколько связанных тегов (например `v1.1.0`, `dev`, `latest`, или больше), вам нужно удалить все теги, связанные с конкретным артефактом, чтобы освободить место в вашем Edgegap Container Registry.

### Запрос дополнительного хранилища

Когда ваш запрос на доступ к реестру будет одобрен, вам будет выделен определенный объем места в реестре.

Вы можете запросить дополнительное место, нажав кнопку "Request more storage" рядом с индикатором использования пространства.

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

Когда сотрудник одобрит ваш запрос, у вас будет больше места для загрузки ваших образов.

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

Узнайте, как контейнеризировать ваше приложение, с помощью нашего руководства: [Начало работы с Docker](https://docs.edgegap.com/ru/docs/tools-and-integrations/docker.md).
