[AWS] ECR 리포지토리에서 모든 이미지 태그 조회하기

쿠버네티스 클러스터 안에서 사용하는 이미지를 확인하는 경우에는 kubectl 명령어를 이용하면 되지만, 이번에는 ECR(Amazon Elastic Container Registry)에 저장된 이미지 태그 목록을 조회하는 방법을 정리해보겠습니다.

1. 특정 리포지토리의 모든 태그 조회

가장 기본적인 방법은 list-images 명령어를 사용하는 것입니다.

aws ecr list-images \
  --repository-name <리포지토리명> \
  --query 'imageIds[*].imageTag' \
  --output text

이렇게 실행하면 해당 리포지토리에 저장된 모든 태그가 공백으로 구분되어 출력됩니다.

2. 태그가 없는 이미지까지 포함해서 조회

일부 이미지에는 태그가 붙어있지 않을 수 있습니다. 이 경우에는 tagStatus=ANY 옵션을 추가해야 합니다.

aws ecr list-images \
  --repository-name <리포지토리명> \
  --filter tagStatus=ANY

3. 전체 리포지토리에 대해 태그 조회

ECR에는 여러 개의 리포지토리가 있을 수 있습니다. 모든 리포지토리를 한 번에 확인하고 싶다면 다음과 같이 반복문을 활용할 수 있습니다.

for repo in $(aws ecr describe-repositories --query 'repositories[*].repositoryName' --output text); do
  echo "Repository: $repo"
  aws ecr list-images --repository-name $repo --query 'imageIds[*].imageTag' --output text
done

이 명령어는 리포지토리 이름을 먼저 출력하고, 그 아래에 태그 목록을 보여줍니다.

4. 상세 정보까지 함께 조회

단순히 태그만이 아니라 푸시된 시간도 함께 확인하고 싶다면 describe-images 명령어를 쓰면 편리합니다.

aws ecr describe-images \
  --repository-name <리포지토리명> \
  --query 'imageDetails[].{Tags:imageTags, Pushed:imagePushedAt}' \
  --output table

이렇게 하면 이미지 태그와 함께 푸시 시각까지 표 형식으로 확인할 수 있어 최신 이미지를 찾을 때 유용합니다.

정리

• 빠르게 태그만 확인 → list-images
• 태그 없는 이미지 포함 → list-images --filter tagStatus=ANY
• 전체 리포지토리 확인 → 반복문 활용
• 푸시 시간까지 확인 → describe-images

상황에 맞게 위 명령어들을 조합하면, ECR에 저장된 이미지 태그를 효과적으로 관리할 수 있습니다.