

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Amazon ECR에 이미지 보관
<a name="archive_restore_image"></a>

## ECR 아카이브 스토리지 클래스란 무엇입니까?
<a name="archive-what-is"></a>

Amazon ECR 아카이브 스토리지 클래스는 컨테이너 이미지를 위한 저렴한 장기 스토리지를 제공하는 새로운 스토리지 클래스입니다. Amazon ECR은 두 가지 스토리지 클래스를 제공합니다.
+ **ECR 표준 스토리지 클래스** - 정기적으로 액세스하는 활성 이미지의 기본 스토리지 클래스입니다.
+ **ECR 아카이브 스토리지 클래스** - 거의 액세스하지 않지만 규정 준수 또는 장기 참조를 위해 보존해야 하는 이미지의 저비용 스토리지 클래스입니다. 아카이브 스토리지 클래스는 장기 이미지 보존을 위해 표준 스토리지 클래스에 비해 대용량 이미지에 대한 비용을 절감합니다. 자세한 요금 정보는 [Amazon ECR 요금을](https://aws.amazon.com/ecr/pricing/) 참조하세요.

이미지를 아카이브하려면 두 가지 옵션이 있습니다. 먼저 다음을 기반으로 이미지를 자동으로 보관하도록 수명 주기 규칙을 구성할 수 있습니다.
+ 이미지가 푸시된 이후 경과 시간
+ 이미지를 마지막으로 가져온 후 경과한 시간
+ 리포지토리의 이미지 수

지정된 기간 동안 보관된 이미지를 영구적으로 삭제하도록 설정을 구성할 수도 있습니다. 자세한 내용은 [Amazon ECR의 수명 주기 정책을 사용하여 이미지 정리 자동화](LifecyclePolicies.md) 섹션을 참조하세요.

Amazon ECR 콘솔 또는를 사용하여 이미지를 아카이브할 수도 있습니다 AWS CLI. 자세한 내용은 [이미지 보관](archive-image.md) 섹션을 참조하세요.

아카이브된 이미지를 다시 사용해야 하는 경우 ECR Standard 스토리지 클래스로 복원할 수 있습니다. ECR이 20분 이내에 이미지를 복원할 것으로 예상할 수 있습니다. 복원된 이미지는 새로 푸시된 이미지처럼 동작하며 복원이 완료되면 즉시 사용할 수 있습니다. 복원된 이미지에는 스캔, 복제 및 리포지토리 수명 주기 정책이 적용됩니다. 자세한 내용은 [이미지 복원](restore-image.md) 섹션을 참조하세요.

# 이미지 보관
<a name="archive-image"></a>

Amazon ECR 콘솔을 사용하거나 수명 주기 정책을 사용하여 이미지를 수동으로 아카이브 AWS CLI하거나 자동으로 아카이브할 수 있습니다. 이미지가 아카이브된 경우:
+ 이미지가 아카이브 스토리지 클래스로 이동합니다.
+ 보관된 이미지는 가져올 수 없습니다. 보관된 이미지 가져오기 요청은 404 오류와 함께 실패합니다.
+ 이미지를 가져올 수는 없지만 ** describe-images** 명령을 사용하여 설명하거나 **list-images** 명령을 사용하여 나열할 수 있습니다. 이미지 상태는 로 표시됩니다`ARCHIVED`.
+ 보관된 이미지의 최소 저장 기간은 90일입니다. 아카이브에 90일 미만으로 보관된 이미지는 삭제하는 수명 주기 정책을 구성할 수 없습니다. 90일 미만 동안 보관된 이미지를 삭제해야 하는 경우 **batch-delete-image** API를 사용해야 하지만 최소 90일 스토리지 기간에 대한 요금이 부과됩니다.
+ 이미지가 리포지토리 보기의 **아카이브된 이미지** 탭에 나타납니다(이 탭은 리포지토리에 이미지가 하나 이상 아카이브된 경우에만 표시됨).
+ 복원할 이미지를 수동으로 선택하거나 이미지를 리포지토리에 다시 푸시하여 이미지를 활성 이미지로 복원할 수 있습니다.
+ 리포지토리에 아카이브 시간과 같은 기준이 있는 이미지를 삭제하는 수명 주기 정책이 있는 경우 이미지가 삭제됩니다.

------
#### [ AWS Management Console ]

**이미지를 아카이브하려면**

1. Amazon ECR 콘솔([https://console.aws.amazon.com/ecr/repositories](https://console.aws.amazon.com/ecr/repositories))을 엽니다.

1. 탐색 모음에서 아카이브하려는 이미지가 있는 리포지토리가 포함된 리전을 선택합니다.

1. 탐색 창에서 **리포지토리**를 선택합니다.

1. **리포지토리** 페이지에서 아카이브하려는 이미지가 포함된 리포지토리를 선택합니다.

1. 아카이브하려는 이미지를 선택합니다. 이미지 세부 정보가 표시됩니다.

1. 이미지를 아카이브하려면 **아카이브** 버튼을 선택하고 메시지가 표시되면 **확인을** 선택합니다.

1. 리포지토리에 처음 아카이브된 이미지인 경우 새로 **아카이브된 이미지** 탭이 새로 아카이브된 이미지와 함께 나타납니다. 다른 아카이브된 이미지가 있는 경우이 이미지가 해당 탭에 추가됩니다.

------
#### [ AWS CLI ]

**이미지를 아카이브하려면**
+ **update-image-storage-class** 명령을 사용하여 스토리지 클래스를 로 업데이트하여 이미지를 아카이브합니다. `ARCHIVE` 

  ```
  aws ecr update-image-storage-class \
      --repository-name my-repository \
      --image-id imageDigest=sha256:4f70ef7a4d29e8c0c302b13e25962d8f7a0bd304EXAMPLE \
      --target-storage-class ARCHIVE
  ```

------

**수명 주기 정책을 사용하여 이미지를 아카이브하려면**
+ 수명 주기 정책을 사용하여 리포지토리에 대한 아카이브 규칙을 구성하여 이미지를 자동으로 아카이브할 수 있습니다. 수명 주기 정책을 사용하면 다음과 같은 기준에 따라 이미지를 자동으로 아카이브할 수 있습니다.
  + 이미지가 푸시된 이후 경과 시간
  + 이미지를 마지막으로 가져온 후 경과한 시간
  + 활성 상태로 유지할 최대 이미지 수

  지정된 기간 동안 보관된 이미지를 영구적으로 삭제하도록 수명 주기 정책을 구성할 수도 있습니다. 아카이브 작업이 포함된 수명 주기 정책에 대한 자세한 내용과 예제는 섹션을 참조하세요[Amazon ECR의 수명 주기 정책을 사용하여 이미지 정리 자동화](LifecyclePolicies.md).
**참고**  
보관된 이미지의 최소 저장 기간은 90일입니다. 아카이브에 90일 미만으로 보관된 이미지는 삭제하는 수명 주기 정책을 구성할 수 없습니다. 90일 미만 동안 보관된 이미지를 삭제해야 하는 경우 **batch-delete-image** API를 사용해야 하지만 최소 90일 스토리지 기간에 대한 요금이 부과됩니다.

**describe-images** 명령을 사용하여 이미지를 설명하면 아카이브된 이미지`image-status`의는 입니다`ARCHIVED`. 를 기준으로 이미지를 필터링`image-status`하여 아카이브된 이미지만 보거나 활성 이미지만 볼 수 있습니다.

# 이미지 복원
<a name="restore-image"></a>

아카이브된 이미지를 복원하면 ECR Archive 스토리지 클래스에서 ECR Standard 스토리지 클래스로 다시 이동합니다. 복원된 이미지는 표준 스토리지 요금으로 청구됩니다. 복원 프로세스는 새 이미지가 생성될 때 발생하는 유사한 작업을 수행합니다.
+ 복원이 완료되면 이미지를 가져올 수 있습니다. 복원은 일반적으로 최대 20분이 걸리지만 더 빠르게 완료될 수 있습니다.
+ 리포지토리에 대해 푸시 시 스캔이 활성화된 경우 복원된 이미지가 스캔됩니다. 이미지가 아카이브되기 전의 이전 스캔 결과는 사용할 수 없습니다.
+ 리포지토리에 복제가 구성된 경우 복원 시 복제가 활성화된 경우 복원된 이미지가 복제됩니다.
+ 복원된 이미지가 활성 이미지 목록에 나타납니다.

이미지를 복원하는 데는 일반적으로 최대 20분이 걸리지만 더 빠르게 완료될 수 있습니다. 복원 프로세스 중에 이미지는 아카이브된 상태로 유지되며 복원이 완료될 때까지 가져올 수 없습니다.

------
#### [ AWS Management Console ]

**아카이브된 이미지를 복원하려면**

1. Amazon ECR 콘솔([https://console.aws.amazon.com/ecr/repositories](https://console.aws.amazon.com/ecr/repositories))을 엽니다.

1. 탐색 모음에서 복원하려는 아카이브된 이미지가 있는 리포지토리가 포함된 리전을 선택합니다.

1. 탐색 창에서 **리포지토리**를 선택합니다.

1. **리포지토**리 페이지에서 아카이브된 이미지가 포함된 리포지토리를 선택합니다.

1. **보관된 이미지** 탭을 선택합니다.

1. 복원하려는 아카이브된 이미지를 선택합니다.

1. **복원**을 선택하고 복원 작업을 확인합니다.

1. 복원이 완료될 때까지 기다립니다. 복원이 완료되면 이미지가 활성 이미지 목록에 표시됩니다.

------
#### [ AWS CLI ]

**아카이브된 이미지를 복원하려면**
+ **update-image-storage-class** 명령을 사용하여 스토리지 클래스를 로 업데이트하여 아카이브된 이미지를 복원합니다. `STANDARD` 

  ```
  aws ecr update-image-storage-class \
      --repository-name my-repository \
      --image-id imageDigest=sha256:4f70ef7a4d29e8c0c302b13e25962d8f7a0bd304EXAMPLE \
      --target-storage-class STANDARD
  ```

------

**describe-images** 명령을 사용하여 이미지를 설명하면 복원 중인 이미지`image-status`의는 입니다`ACTIVATING`. 값을 `image-status` 사용하여 로 이미지를 필터링`ACTIVATING`하여 현재 복원 중인 이미지를 볼 수 있습니다.

아카이브된 이미지를 복원하는 다른 방법은 이미지를 리포지토리에 다시 푸시하는 것입니다. 현재 아카이브된 이미지를 푸시하면 해당 이미지가 즉시 복원되고 아카이브에서 제거됩니다.