콘텐츠 자동화(content-automation)에서 지원 중단된 Groq 모델에 대한 자동 이메일 알림 추가

요약 (TL;DR): Groq 모델이 지원 중단(deprecated)되었을 때 이를 감지하는 와치독(watchdog)을 추가했습니다. 이 와치독은 대체 모델 목록과 필요한 GitHub Secrets 링크가 포함된 간결한 이메일을 작성하여 기존의 SMTP 헬퍼(helper)를 통해 전송합니다. 이 변경 사항을 통해 콘텐츠 생성 파이프라인(pipeline)의 무음 실패(silent failures)를 방지하고 팀에게 명확한 마이그레이션 경로를 제공합니다.

문제 상황

requests.exceptions.HTTPError: 404 Client Error: Not Found for url https://api.groq.com/v1/models/gpt-oss-20b

처음 시도했던 방법

처음에는 요청을 일반적인 try/except 문으로 감싸고 에러를 CloudWatch에 로그로 남기는 방식을 생각했습니다. 다음과 같이 추가했습니다:

try:
    response = requests.get(model_url)
    response.raise_for_status()
...

이 방식은 스택 트레이스(stack trace)를 제공해주긴 했지만, 운영상의 고충을 해결해주지는 못했습니다. 여전히 로그를 수동으로 확인하고, 어떤 모델이 사라졌는지 파악한 다음, 설정 파일(config file)을 직접 수정해야 했기 때문입니다. 또한 src/content_generator.py 내부에서 "목록의 다음 모델로 폴백(fallback)"하는 임시방편적인 방법도 시도해 보았습니다. 하지만 폴백 로직은 취약했습니다. 서로 다른 프롬프트(prompt)에는 서로 다른 모델의 역량이 필요하며, 무분별한 전환은 출력 품질을 저하시킬 수 있기 때문입니다.

결과: 파이프라인은 여전히 팀에게 무음 실패(silent failure)를 일으켰고, 폴백 방식은 다운스트림(downstream) 콘텐츠 생성 과정에서 미묘한 버그를 유발했습니다.

구현 내용

1. 모델 메타데이터 중앙화

기존에 존재하던 새로운 프라이빗 메서드(private method) _list_available_models를 도입하여, 이제 이 메서드는 **타입이 지정된 문자열 리스트(typed list of strings)**를 반환하고 예상치 못한 모든 에러를 포착합니다:

def _list_available_models(self) -> list[str]:
    try:
        # Groq의 공개 엔드포인트(public endpoint)에서 모델 카탈로그를 가져옴
...

2. 지원 중단(deprecation) 감지

핵심 변경 사항은 src/content_generator.py에 있습니다. 설정된 모델을 실제 카탈로그와 비교하는 새로운 헬퍼(helper) _detect_deprecated_model을 추가했습니다:

def _detect_deprecated_model(self, current_model: str) -> bool:
    """`current_model`이 더 이상 Groq에 목록에 없는 경우 True를 반환합니다."""
    available = self._list_available_models()
...

3. 경고 이메일 작성 (Building the alert email)

지원 중단(deprecation)이 감지되면, 이제 다음 내용을 포함하는 이메일을 작성합니다:

• 지원 중단된 모델의 이름.
• 현재 사용 가능한 모든 모델의 불렛 리스트 (bullet list).
• 새로운 모델 키를 저장해야 하는 저장소의 GitHub Secrets 페이지로 연결되는 직접 링크.

def _compose_deprecation_email(self, deprecated: str, available: list[str]) -> str:
    models_md = "\n".join(f"- {m}" for m in available)
    return f"""\
...

4. 이메일 전송 (Sending the email)

메시지를 실제로 전송하기 위해 기존의 SMTPHelper 클래스(src/email_utils.py에 정의됨)를 재사용했습니다:

def _notify_deprecation(self, deprecated: str) -> None:
    available = self._list_available_models()
    body = self._compose_deprecation_email(deprecated, available)
...

5. 생성 흐름에 연결 (Hooking into the generation flow)

이제 생성 진입점(generate_content)에서 설정을 로드한 직후에 지원 중단 여부를 확인합니다:

def generate_content(self):
    model = self.config["groq_model"]
    if self._detect_deprecated_model(model):
...

6. CI/CD 업데이트 (Updating CI/CD)

이메일 본문에 예상되는 GitHub Secrets URL이 포함되어 있는지 확인(assert)하기 위해 tests/test_model_deprecation.py에 작은 단위 테스트(unit test)를 추가했습니다. 이제 이메일 작성 로직이 퇴보(regress)할 경우 CI 파이프라인이 실패합니다.

def test_compose_deprecation_email():
    gen = ContentGenerator()
    body = gen._compose_deprecation_email(
...

모든 변경 사항은 60fe07fc 커밋에 그룹화되어 있으며, 메시지는 다음과 같습니다:

feat(alert): email alert when Groq model deprecated — lists available models + GitHub Secrets link

차이점(diff)을 살펴보면 새로운 감지 및 알림 헬퍼(helper)를 중심으로 114행이 추가되고 24행이 삭제되었습니다.

핵심 요약 (Key Takeaway)

외부 서비스가 영원히 안정적으로 유지될 것이라고 절대 가정하지 마세요. 모델 엔드포인트의 404 오류와 같은 수동적(passive) 실패를 실행 가능한 복구 단계가 포함된 능동적(active) 알림으로 전환함으로써, "어딘가에서 고장 났다"는 식의 디버깅 사이클을 제거하고 파이프라인의 자가 치유(self-healing) 기능을 유지할 수 있습니다. 이 패턴—탐지(detect) → 구성(compose) → 알림(notify) → 중단(abort)—은 서비스가 중단되거나 버전이 고정될 수 있는 모든 제3자 의존성(third-party dependency)에 재사용될 수 있습니다.

다음 단계 (What's Next)

• 자동 폴백 (Automatic fallback) – 호환 가능한 모델의 신뢰할 수 있는 목록이 확보되면, 모델이 지원 중단(deprecated)되었을 때 수동 개입 없이 파이프라인이 계속 작동할 수 있도록 구성 가능한 폴백 맵(예: gpt-oss-20b → gpt-oss-120b)을 추가하겠습니다.
• 대시보드 통합 (Dashboard integration) – 지원 중단 이벤트를 웹훅(webhook)을 통해 내부 상태 보드(status board)로 전송하여, 조직 전체가 실시간으로 확인할 수 있도록 하겠습니다.
• 비밀 값 순환 자동화 (Secret rotation automation) – 성공적인 마이그레이션 후에 GROQ_MODEL 비밀 값(secret)을 자동으로 업데이트하는 GitHub Action을 작성하여 루프를 완성하겠습니다.

태그: #vibecoding #buildinpublic #python #ai #automation #email #devops

제 Build in Public 시리즈의 일부입니다 — 멕시코 플라야 델 카르멘(Playa del Carmen)에서 SaaS 프로젝트를 구축하는 실제 과정을 공유합니다.

리포지토리: zaerohell/content-automation · 2026-08-04

#playadev #buildinpublic