spectrabrain/eva-agent-chart의 chartmuseum 브랜치로 변경하고, GitHub Actions의 이미지 게시에 AWS OIDC 인증을 사용합니다. 클러스터의 이미지 pull·S3 다운로드는 별도로 aws-credentials Secret을 사용합니다. (EVA-REQ-567)HF_HOME 자동 주입을 제거했습니다. vLLM의 공유 모델 캐시와 S3 preload는 유지합니다. 기존 Agent PVC/PV의 보존 상태는 업그레이드 전에 확인합니다. (EVA-REQ-567)SNAPSHOT_RESTORE_EXISTING으로 명시적으로 선택합니다.servingEngineSpec.modelSpec[].initContainer.s3Uri로 vLLM preload 원본을 지정합니다. Qdrant sidecar에 SNAPSHOT_RESTORE_EXISTING="false"를 추가했습니다.image.repository·image.tag·ecrRefresh.registry, vLLM S3 source, Qdrant S3_BUCKET과 SNAPSHOT_SPECS를 갱신했습니다. Qdrant의 공개 이미지 다운로드용 values에서 ECR pull Secret 의존성을 제거했습니다.persistence와 sharedPvcStorage 설정 및 관련 모델 캐시 리소스를 제거했습니다. 이전 values의 해당 블록을 제거합니다. vLLM 차트의 sharedPvcStorage는 계속 사용합니다.| 구성 | Chart 버전 | 애플리케이션 / 이미지 | 근거 |
|---|---|---|---|
| eva-agent | 3.3.0 | appVersion 3.3.0; Agent 이미지 3.3.0 | 게시 패키지 |
| eva-agent-vllm | 3.3.0 | Docker 배포 values: router v0.1.10; vLLM v0.21.0 | 게시 패키지 |
| Qdrant upstream | 1.18.2 | qdrant/qdrant:v1.18.2 | upstream release |
| eva-agent-init | 1.0.0 | 설치 기반 리소스; 이번 values 변경 없음 | 게시 패키지 |
표는 게시된 3.3.0 차트 기본값과 release/3.3.0 배포 values를 기준으로 작성했습니다. 기본값과 환경별 override가 다른 경우 함께 표시합니다. Secret의 실제 자격 증명은 표에 포함하지 않습니다.
이미지 및 ECR 인증
| 키 | 차트 기본값 / 배포 values | 환경변수 / 설명 |
|---|---|---|
| image.repository | 211722900905.dkr.ecr.ap-northeast-2.amazonaws.com/spectrabrain/eva-agent | Agent Deployment와 보존 작업의 컨테이너 이미지 저장소 |
| image.tag / image.pullPolicy | 3.3.0 / Always | Agent 이미지 버전과 pull 정책 |
| imagePullSecrets | [eva-agent-dockerconfig] | namespace의 이미지 pull Secret 이름 |
| dockerConfig.enabled / dockerConfig.name / dockerConfig.json | false / eva-agent-dockerconfig / 미설정 | enabled=true일 때 제공한 Docker config JSON으로 Secret 생성 |
| awsCredentialsSecretName | aws-credentials | ECR 갱신 Job이 envFrom으로 읽는 AWS 자격 증명 Secret |
| ecrRefresh.enabled / ecrRefresh.schedule | true / 0 */6 * * * | pre-install·pre-upgrade hook 및 6시간마다 실행하는 pull Secret 갱신 CronJob |
| ecrRefresh.registry / ecrRefresh.region | 211722900905.dkr.ecr.ap-northeast-2.amazonaws.com / ap-northeast-2 | ECR_REGISTRY·AWS_REGION. 이미지 저장소와 같은 registry를 지정 |
| ecrRefresh.secretName | eva-agent-dockerconfig | 갱신할 pull Secret. imagePullSecrets와 일치시킴 |
| ecrRefresh.awsCliImage / ecrRefresh.kubectlImage | amazon/aws-cli:2.33.8 / bitnami/kubectl:latest | ECR 토큰 취득 및 Kubernetes Secret 갱신용 보조 이미지 |
ecrRefresh.enabled=false는 hook과 CronJob을 모두 비활성화합니다. 이 경우 사용할 pull Secret을 별도로 준비합니다. CI OIDC Role과 클러스터 런타임 자격 증명은 각각 관리합니다.
Agent 환경변수와 Secret
아래 환경변수는 env[]의 name·value로 지정합니다. 서비스 연결 주소의 차트 기본값은 다음과 같습니다.