ECR 토큰 갱신 Cron

문제

ECR 토큰은 12시간 후 만료돼요
Docker 컨테이너는 보통 시작할 때만 로그인해요
컨테이너가 12시간 이상 실행되면 이후 docker pull 명령이 실패해요
에러: authorization token has expired

해결 방법

만료 전에 ECR 토큰을 6시간마다 갱신하는 cron job을 설정하면 돼요.

# Cron 항목 (6시간마다 실행)
0 */6 * * * HOME=/home/ec2-user /usr/bin/aws ecr get-login-password --region ap-northeast-2 | /usr/bin/docker login --username AWS --password-stdin <ECR_REGISTRY> >> /var/log/ecr-refresh.log 2>&1

핵심 포인트

토큰 수명: 12시간(AWS 제한)
갱신 간격: 6시간(안전 마진)
cron에서는 전체 경로(/usr/bin/aws, /usr/bin/docker)를 사용해야 해요
AWS CLI가 자격 증명을 찾을 수 있도록 HOME을 설정해야 해요
디버깅을 위해 파일에 로그를 남겨요

Amazon Linux 2023 설정

# cronie 설치 (기본으로 포함되어 있지 않음)
sudo yum install -y cronie

# 활성화 및 시작
sudo systemctl enable crond
sudo systemctl start crond

# 특정 사용자에게 cron 설치
sudo -u ec2-user crontab -e

구현 위치

인스턴스가 교체돼도 cron이 살아남도록 두 곳에 설치해요.

배포 job: 호스트를 다시 프로비저닝하는 파이프라인 단계에서 cron을 재설치해요. 인스턴스가 교체돼도 자동으로 복구돼요.
부트스트랩 스크립트: EC2 user-data에서도 설치해요. 다음 배포를 기다리지 않고 첫 부팅부터 갱신이 동작해요.

트러블슈팅

# cron이 실행 중인지 확인
systemctl status crond

# cron 로그 확인
cat /var/log/ecr-refresh.log

# 수동 갱신 테스트
aws ecr get-login-password --region ap-northeast-2 | docker login --username AWS --password-stdin <ECR_REGISTRY>

# 현재 로그인 상태 확인
cat ~/.docker/config.json

흔한 실수

이슈	해결
잘못된 사용자로 cron 설치	`sudo -u ec2-user crontab` 사용
원격(AWS SSM Run Command)으로 설치할 때 따옴표가 깨짐	인라인 대신 임시 파일에 항목을 쓰고 그 파일로 설치
cronie 미설치	AL2023에서 `yum install -y cronie`

문제

해결 방법

핵심 포인트

Amazon Linux 2023 설정

구현 위치

트러블슈팅

흔한 실수

댓글