도커 이미지 태그에는 '/'가 못 들어간다는 것 알고 있으셨나요?

오늘은 도커 이미지 태그에 '/'가 포함되면 에러가 발생하는 것을 알게 된 경험을 기록하려고 합니다.

 

 

저희들은 브랜치를 다음과 같이 관리하고 있습니다.

• develop: 최신 브랜치
• feat/{task-id}/{description}: 기능 개발 브랜치
• support/{deployed version}: 운영 환경에 배포된 버전 관리 브랜치

어느 날 특정 환경을 develop 브랜치에 머지하기 전에 개발 환경에서 테스트 하고 싶어서 기능 개발 브랜치명 그대로 이미지 태그를 생성했습니다.

그런데 ERROR: invalid tag "12345678.dkr.ecr.ap-northeast-2.amazonaws.com/service:feat/TASK-ID/description": invalid reference format" 이런 에러가 발생하더라고요...

 

도커 공식 문서를 참고하면 도커 이미지 태그에는 알파벳 대소문자, 숫자, -, . _ 문자만 포함될 수 있다고 적혀져 있기는 하더라고요...

도커 공식 문서

• 참고: https://docs.docker.com/reference/cli/docker/image/tag/#extended-description

 

실제로 테스트 해보니 허용된 문자로만 이미지 태그가 생성되고 그 외의 문자로 도커 이미지 태그를 설정하려고 하면 에러가 발생하는 것을 확인할 수 있었습니다! 끝!

도커 이미지 빌드 성공!

 

'/' 문자가 있으니 도커 이미지 빌드 실패!