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

# 容器镜像仓库

将你的游戏服务器容器镜像存储在 Edgegap 免费内置仓库中，可随时部署到全球边缘网络。

既然你已经知道如何使用我们的平台，你需要将你的游戏服务器容器化。你还需要一个地方来存储你的容器镜像，以便在部署游戏服务器时可以访问。

这就是我们创建 Edgegap 容器镜像仓库的原因。它是一个私有管理的容器仓库，运行方式与标准的公共容器仓库非常相似，但额外带来了更高的安全性、漏洞扫描以及其他优势！凭借高可用性和仪表盘集成，你将花更少的时间学习新工具，而你的服务器也将始终随时可用。

### 获取你的凭据

要推送镜像，你首先需要对我们的仓库进行身份验证，而为此你需要凭据。找到 `容器镜像仓库` 选项卡，在 `服务` 部分中可在侧边栏请求你的凭据。从那里，你可以请求访问我们的仓库。

<figure><img src="https://3334189208-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://3334189208-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/zh/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://3334189208-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://3334189208-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 删除构建产物

如果仪表盘界面对你来说太慢，或者你需要一个自动化的持续集成流水线来自动删除过时的构建产物，以保持你的仓库使用量在限制范围内，那么可以考虑使用我们的容器镜像仓库 API。我们的 [容器镜像仓库 API](https://docs.edgegap.com/zh/docs/api.md) 可以列出给定应用（镜像）的所有标签，以及删除单个标签。由于每个镜像产物（构建）可以同时关联多个标签（例如 `v1.1.0`, `dev`, `latest`，或更多），因此你需要删除与特定产物相关联的所有标签，才能释放 Edgegap 容器镜像仓库中的空间。

### 请求更多存储空间

当你访问仓库的请求获批后，你将获得仓库中一定数量的存储空间。

你可以点击空间使用指示器旁边的“请求更多存储”按钮来申请额外空间。

<figure><img src="https://3334189208-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/zh/docs/tools-and-integrations/docker.md).
