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

# 컨테이너 레지스트리

게임 서버 컨테이너 이미지를 Edgegap의 무료 내장 레지스트리에 저장하고, 글로벌 엣지 네트워크 전반에 배포할 준비를 하세요.

이제 플랫폼 사용 방법을 알았으니 게임 서버를 컨테이너화해야 합니다. 게임 서버를 배포할 때 액세스할 수 있도록 컨테이너 이미지를 저장할 장소가 필요합니다.

그래서 Edgegap Container Registry를 만들었습니다. 이는 표준 공개 컨테이너 레지스트리와 매우 유사하게 작동하는 비공개 관리형 컨테이너 리포지토리이지만, 강화된 보안, 취약점 검사 및 기타 유용한 기능이라는 추가 이점이 있습니다! 고가용성과 대시보드 통합을 통해 새로운 도구를 익히는 데 드는 시간이 줄어들고 서버는 항상 즉시 사용할 수 있습니다.

### 자격 증명 가져오기

이미지를 푸시하려면 먼저 레지스트리에 인증해야 하며, 이를 위해 자격 증명이 필요합니다. 다음을 찾으세요. `컨테이너 레지스트리` 탭을 `서비스` 섹션의 사이드바에서 찾아 자격 증명을 요청하세요. այնտեղ에서 레지스트리 액세스를 요청할 수 있습니다.

<figure><img src="https://1562312210-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://1562312210-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 (리눅스)" %}

```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 (윈도우)" %}

```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/ko/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 %}

스토리지 용량이 허용하는 만큼 이미지를 푸시하고 필요에 따라 서로 다른 리포지토리로 분리할 수 있습니다. 하지만 너무 많은 이미지를 푸시하기 전에 "앱 템플릿" 섹션을 읽어야 합니다!

새로 고침하면 같은 페이지에서 리포지토리를 찾을 수 있습니다.

### 동일한 빌드 아티팩트에 여러 번 태그 지정하기(중복 이미지 푸시)

동일한 빌드 아티팩트를 두 번 푸시하더라도 태그 값이 같으면 변경 사항이 적용되지 않습니다.

동일한 빌드 아티팩트를 서로 다른 두 태그 값으로 두 번 푸시하더라도 추가 스토리지 공간은 사용되지 않으며, 레지스트리는 동일한 빌드 아티팩트를 가리키는 새 태그를 생성할 뿐입니다.

### 이미지 관리하기

최소 하나의 이미지를 푸시한 후 같은 페이지로 이동하면 리포지토리를 볼 수 있습니다.

이러한 리포지토리 중 하나를 클릭하면 포함된 이미지를 아티팩트별로 그룹화하여 볼 수 있습니다. 동일한 이미지에 서로 다른 두 태그를 지정하여 레지스트리에 푸시한 경우, դրանք은 동일한 아티팩트로 표시됩니다.

<figure><img src="https://1562312210-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://1562312210-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를 통해 빌드 아티팩트 삭제하기

대시보드 UI가 너무 느리거나 레지스트리 사용량을 제한 내로 유지하기 위해 오래된 빌드 아티팩트를 자동으로 삭제하는 자동화된 지속적 통합 파이프라인이 필요한 경우, Container Registry API 사용을 고려해 보세요. 당사의 [Container Registry API](https://docs.edgegap.com/ko/docs/api.md) 는 특정 앱(이미지)의 모든 태그를 나열하고 개별 태그를 삭제할 수 있습니다. 각 이미지 아티팩트(빌드)에는 동시에 여러 태그가 연결될 수 있으므로(예: `v1.1.0`, `dev`, `latest`, 등) Edgegap Container Registry의 공간을 확보하려면 특정 아티팩트에 연결된 모든 태그를 삭제해야 합니다.

### 추가 스토리지 요청하기

레지스트리 액세스 요청이 승인되면 레지스트리에서 일정량의 스토리지 공간이 제공됩니다.

공간 사용량 표시기 옆의 "추가 스토리지 요청" 버튼을 클릭하여 추가 공간을 요청할 수 있습니다.

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