# ECR 토큰 갱신 Cron

> AWS ECR 인증 토큰은 12시간 후 만료돼요. 오래 실행되는 Docker 호스트에서는 자동 토큰 갱신을 구현해야 해요.

- Published: 2026-01-23
- Updated: 2026-08-02
- Category: devops
- Tags: devops, aws, ecr, docker, cron
- Page: https://brandonwie.dev/ko/posts/ecr-token-refresh-cron

## 문제

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

## 해결 방법

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

```bash
# 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 설정

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

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

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

## 구현 위치

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

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

## 트러블슈팅

```bash
# 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`                 |
