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

# Amazon ECR에서 이미지 태그를 덮어쓰지 않도록 방지
<a name="image-tag-mutability"></a>

리포지토리에서 태그 불변성을 켜 이미지 태그 덮어쓰기를 방지할 수 있습니다. 태그 불변성를 켠 후 리포지토리에 이미 존재하는 태그가 지정된 이미지를 푸시하면 ` ImageTagAlreadyExistsException` 오류가 반환됩니다. 태그 불변성은 모든 태그에 영향을 미칩니다. 일부 태그는 변경 불가로 지정하고 다른 태그는 변경 가능하도록 지정할 수 없습니다.

 AWS Management Console 및 AWS CLI 도구를 사용하여 새 리포지토리 또는 기존 리포지토리의 이미지 태그 변경 가능성을 설정할 수 있습니다. 콘솔 단계를 사용하여 리포지토리를 생성하려면 [이미지를 저장할 Amazon ECR 프라이빗 리포지토리 생성](repository-create.md) 섹션을 참조하세요.

## 이미지 태그 변경 가능성 설정(AWS Management Console)
<a name="repository-edit"></a>

**이미지 태그 변경 가능성을 설정하려면**

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

1. 탐색 모음에서 편집할 리포지토리가 포함된 리전을 선택합니다.

1. 탐색 창의 **프라이빗 레지스트리**에서 **리포지토리**를 선택합니다.

   **리포지토**리가 표시되지 않으면 **프라이빗 레지스트리**를 선택하여 메뉴를 확장한 다음 **리포지토리**를 선택합니다.

1. **프라이빗 리포지토리** 페이지에서 이미지 태그 변경 가능성 설정을 원하는 리포지토리 이름 앞에 있는 라디오 버튼을 선택합니다.

1. **작업**을 선택한 다음 **편집**에서 **리포지토리**를 선택합니다.

1. **이미지 태그 변경 가능성)**에서 다음과 같은 리포지토리 태그 변경 가능성 설정 중 하나를 선택합니다.
   + **변경 가능** - 이미지 태그를 덮어쓰려면 이 옵션을 선택합니다. Amazon ECR이 캐시된 이미지를 업데이트할 수 있도록 풀 스루 캐시 작업을 사용하는 리포지토리에 권장됩니다. 또한, 일부 변경 가능 태그에 대한 태그 업데이트를 비활성화하려면 **변경 가능 태그 제외** 텍스트 상자에 태그 이름을 입력하거나 유사한 여러 태그를 매칭하는 와일드카드(\$1)를 사용합니다.
   + **변경 불가능** - 이미지 태그를 덮어쓰는 것을 방지하려면 이 옵션을 선택합니다. 선택한 옵션은 기존 태그가 있는 이미지를 푸시할 때 리포지토리의 모든 태그와 제외 항목에 적용됩니다. 기존 태그가 있는 이미지를 푸시하려고 하면 Amazon ECR이 `ImageTagAlreadyExistsException`을 반환합니다. 또한, 일부 변경 불가능 태그에 대한 태그 업데이트를 활성화하려면 **변경 불가능 태그 제외** 텍스트 상자에 태그 이름을 입력하거나 유사한 여러 태그를 매칭하는 와일드카드(\$1)를 사용합니다.

1. **이미지 스캔 설정(Image scan settings)**의 경우 기본 스캔을 위해 리포지토리 수준에서 스캔 설정을 지정할 수 있지만 프라이빗 레지스트리 수준에서 스캔 구성을 지정하는 것이 가장 좋습니다. 프라이빗 레지스트리에서 스캔 설정을 지정하면 고급 스캔 또는 기본 스캔을 사용하고 필터를 정의하여 스캔할 리포지토리를 지정할 수 있습니다. 자세한 내용은 [이미지에서 Amazon ECR의 소프트웨어 취약성 스캔](image-scanning.md) 단원을 참조하십시오.

1. **암호화 설정(Encryption settings)**의 경우 리포지토리가 생성되면 리포지토리에 대한 암호화 설정을 변경할 수 없으므로 이 항목은 보기 전용 필드입니다.

1. **저장(Save)**을 선택하여 리포지토리 설정을 업데이트합니다.

## 이미지 태그 변경 가능성 설정(AWS CLI)
<a name="image-tag-mutability-cli"></a>

**변경 불가능 태그로 구성된 리포지토리를 생성하려면**

다음 명령 중 하나를 사용하여 변경 불가능 태그로 구성된 새 이미지 리포지토리를 생성합니다.
+ 이미지 태그 변경 가능성과 함께 [create-repository](https://docs.aws.amazon.com/cli/latest/reference/ecr/create-repository.html)(AWS CLI)

  ```
  aws ecr create-repository --repository-name name --image-tag-mutability IMMUTABLE --region us-east-2
  ```
+ 이미지 태그 변경성 제외 필터와 함께 [create-repository](https://docs.aws.amazon.com/cli/latest/reference/ecr/create-repository.html)(AWS CLI)

  ```
  aws ecr create-repository --repository-name name --image-tag-mutability IMMUTABLE_WITH_EXCLUSION --image-tag-mutability-exclusion-filters filterType=WILDCARD,filter=filter-text --region us-east-2
  ```
+ 이미지 태그 변경 가능성과 함께 [New-ECRRepository](https://docs.aws.amazon.com/powershell/latest/reference/items/New-ECRRepository.html)(AWS Tools for Windows PowerShell)

  ```
  New-ECRRepository -RepositoryName name -ImageTagMutability IMMUTABLE -Region us-east-2 -Force
  ```
+ 이미지 태그 변경성 제외 필터와 함께 [New-ECRRepository](https://docs.aws.amazon.com/powershell/latest/reference/items/New-ECRRepository.html)(AWS Tools for Windows PowerShell)

  ```
  New-ECRRepository -RepositoryName name -ImageTagMutability IMMUTABLE_WITH_EXCLUSION -ImageTagMutabilityExclusionFilter @{FilterType=WILDCARD Filter=filter-text} -Region us-east-2 -Force
  ```

**리포지토리에 대해 이미지 태그 변경 가능성 설정을 업데이트하려면**

다음 명령 중 하나를 사용하여 기존 리포지토리의 이미지 태그 변경 가능성 설정을 업데이트합니다.
+ 이미지 태그[ put-image-tag-mutability](https://docs.aws.amazon.com/cli/latest/reference/ecr/put-image-tag-mutability.html)mutability(AWS CLI)

  ```
  aws ecr put-image-tag-mutability --repository-name name --image-tag-mutability IMMUTABLE --region us-east-2
  ```
+ [ put-image-tag-mutability](https://docs.aws.amazon.com/cli/latest/reference/ecr/put-image-tag-mutability.html)(AWS CLI) 및 이미지 태그 변경 가능성 제외 필터

  ```
  aws ecr put-image-tag-mutability --repository-name name --image-tag-mutability IMMUTABLE_WITH_EXCLUSION --image-tag-mutability-exclusion-filters filterType=WILDCARD,filter=latest --region us-east-2
  ```
+ 이미지[ 태그 변경 가능성이 있는 Write-ECRImageTagMutability](https://docs.aws.amazon.com/powershell/latest/reference/items/Write-ECRImageTagMutability.html)(AWS Tools for Windows PowerShell)

  ```
  Write-ECRImageTagMutability -RepositoryName name -ImageTagMutability IMMUTABLE -Region us-east-2 -Force
  ```
+ 이미지[ 태그 변경성 제외 필터를 사용한 Write-ECRImageTagMutability](https://docs.aws.amazon.com/powershell/latest/reference/items/Write-ECRImageTagMutability.html)(AWS Tools for Windows PowerShell)

  ```
  Write-ECRImageTagMutability -RepositoryName name -ImageTagMutability IMMUTABLE_WITH_EXCLUSION -ImageTagMutabilityExclusionFilter @{FilterType=WILDCARD Filter=latest}
  ```