---
title: "Container Registry 사용 준비"
slug: "containerregistry-spec"
tags: ["Container Registry"]
updated: 2026-09-17T09:07:35Z
published: 2026-09-17T09:07:35Z
canonical: "guide.ncloud-docs.com/containerregistry-spec"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://guide.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Container Registry 사용 준비

Classic/VPC 환경에서 이용 가능합니다.

Container Registry의 원활한 이용을 위한 지원 환경 사양, 연동 서비스, 제약 사항, 요금제 등을 확인합니다.

## 클라우드 환경 사양

Container Registry가 지원하는 클라우드 환경 사양은 다음과 같습니다.

| 항목 | 지원 사양 |
| --- | --- |
| 리전(존) | 한국, 싱가포르, 일본 |
| Classic | 지원 |
| VPC | 지원 |
| 리전 코드 | - 한국(KR): kr - 싱가포르(SGN): sg - 일본(JPN): jp |
| 언어 | 한국어, 영어, 일본어 |

참고

VPC 환경은 네이버 클라우드 플랫폼 포털의 [서비스 소개](https://www.ncloud.com/product/networking/vpc)를, 서비스별 VPC 환경 지원 여부는 [Ncloud 사용 환경 가이드](/docs/environment-environment-1-1)를 참조해 주십시오.

참고

- 리전 코드는 레지스트리에 대한 엔드포인트로 사용됩니다. 레지스트리 이름과 리전 코드는 아래와 같이 레지스트리 엔드포인트에 사용됩니다. 퍼블릭 엔드포인트는 필요에 따라 사용할 수 없도록 비활성화할 수 있습니다.
  - 퍼블릭 엔드포인트: `<registry-name>`.`<region-code>`.ncr.ntruss.com
  - 프라이빗 엔드포인트: `<random-id>`.`<region-code>`.private-ncr.ntruss.com
- 퍼블릭 엔드포인트로 접근할 경우, 외부 인터넷 사용을 위한 환경을 구성해야 합니다. NAT Gateway와 Public Subnet으로 구성되어 있으면 Public IP와 같은 리소스가 필요하며, 추가 요금이 부과될 수 있습니다.
- 프라이빗 엔드포인트로 접근할 경우, 사설 통신 구간에 해당하기 때문에 연동된 스토리지 버킷과 통신 시에 네트워크 요금이 부과될 수 있습니다.

## 필수 연동 부가 서비스

Container Registry의 프라이빗 도커 컨테이너 이미지는 스토리지에 연동하여 저장됩니다. 레지스트리를 생성할 때 연동할 스토리지 타입(Object Storage 또는 Ncloud Storage)을 선택할 수 있으며, 선택한 스토리지에 따라 사전 준비 사항이 다릅니다.

- Object Storage: Container Registry 서비스를 신청하기 전에 Object Storage를 신청한 후 프라이빗 도커 컨테이너 이미지를 저장할 버킷을 생성해야 합니다. 자세한 내용은 [Object Storage 사용 가이드](/docs/storage-storage-6-1)를 참조해 주십시오.
- Ncloud Storage: 레지스트리 생성 시 Ncloud Storage를 선택하면 이미지를 저장할 버킷을 자동으로 생성하여 연동합니다. 자세한 내용은 [Ncloud Storage 사용 가이드](/docs/ncloudstorage-overview)를 참조해 주십시오.

참고

Ncloud Storage는 한국 리전에서만 제공됩니다.

## 제약 사항

Container Registry 이용 시 제약 사항은 다음과 같습니다.

### Docker 버전

네이버 클라우드 플랫폼의 Container Registry를 이용하려면 Docker Engine 1.13 버전 이상이 필요합니다.

### Object Storage

- 스토리지 타입으로 Object Storage를 선택해 연동할 때는 네이버 클라우드 플랫폼의 Object Storage 이용을 신청해 주십시오. Object Storage의 버킷에 Docker 컨테이너 이미지가 저장됩니다.
- 다음 기능을 활성화하면 서비스를 정상적으로 이용하지 못할 수 있습니다.
  - WORM(Write Once Read Many)
  - Lifecycle Management
  - ACL(Access Control List)
- ACL 기능을 활성화한 경우에는 접근 제어가 설정된 서버 내에서 프라이빗 엔드포인트를 이용하여 컨테이너 레지스트리 서비스를 이용할 수 있습니다.

### Ncloud Storage

- 스토리지 타입으로 Ncloud Storage를 선택해 연동할 때 수명 주기 관리(Lifecycle Management) 기능을 사용하면 서비스를 정상적으로 이용하지 못할 수 있습니다. 수명 주기 규칙에 따라 도커 컨테이너 이미지 객체가 만료되어 삭제되거나 Deep Archive Class 등 다른 스토리지 클래스로 이전되면 이미지를 정상적으로 다운로드(Pull)할 수 없습니다.

## 이용 요금

프라이빗 도커 컨테이너 이미지는 연동된 스토리지에 저장되므로 저장된 데이터 양, API 요청 수, 네트워크 전송 요금이 사용량에 따라 별도로 부과됩니다. Container Registry의 이용 요금에 대한 자세한 기준은 **포털 > 서비스 > Containers > Container Registry**의 요금 안내를 참조해 주십시오.

- [**포털 > 서비스 > Containers > Container Registry**](https://www.ncloud.com/product/containers/containerRegistry)