[FEAT] Dockerfile + ECR 이미지·배포 워크플로

[dlxodus02]

📊 우선순위

• P0 : 서비스 핵심 동작
• P1 : 운영 및 확장 기능

계층 코드가 돌아가도 배포 경로가 없으면 AI EC2 에 올라가지 못한다. 다만 데모는 수동 배포로도 가능하므로 P1.

🎯 완료 조건

• uv 기반 Dockerfile (pip/requirements.txt 아님)
• PR 에서 docker build 검증 (자격증명 없이)
• develop → ECR z-ai 커밋 SHA 태그 푸시
• main → 빌드·푸시 + SSM 배포 (tag:Role=ai)
• OIDC 만 사용 — 액세스 키·Docker Hub 토큰 미저장
• Immutable 재푸시 실패 대응

💻 작업 내용

• Dockerfile — 2단계 빌드, 비루트(uid 1001), HEALTHCHECK
• .dockerignore — .env 제외가 핵심
• .github/workflows/ai-image.yml — PR 빌드 검증 · develop 푸시
• .github/workflows/ai-cd.yml — main 배포 (SSM)
• README.md — 이미지·배포 절 추가

🔗 전제 (인프라 완료분)

Private ECR z-ai (ap-northeast-2) · Immutable · Lifecycle 최신 20개
OIDC 배포 역할에 ECR Push · AI EC2 역할에 ECR Pull
리포 변수 AWS_DEPLOY_ROLE_ARN · AWS_REGION · ECR_REPOSITORY

⚠️ 아직 확인 안 된 것

• AI EC2 에 Role=ai 태그가 붙어 있는지 — 없으면 배포 스텝이 "대상 없음"으로 실패한다
• /opt/z-ai-worker/deploy.sh 의 인자 규약 — $1=SHA $2=이미지 URI 로 넘긴다
• docker build 자체는 로컬 Docker 데몬이 없어 검증하지 못했다 (PR 의 build 잡이 검증)