운영 번들 자동 로그인 자격증명 유출, 온보딩 COPY 잡이 Gemini 429 로 죽던 것, 크롤링 실패가 로그에만 남던 것을 한 번에 정리한다. 실측(2026-09-15 밤, 킹서버): 사진분석 배치가 Gemini 분당 쿼터를 다 써서 같은 키를 쓰는 온보딩 COPY 잡도 같이 429 를 맞고 DEAD 로 갔다 — 확인된 fact 만으로도 편집·발행이 되는데 잡을 죽일 이유가 없었다. - solution/frontend: `VITE_AUTO_LOGIN_ID`·`PW` 를 운영 진입점에 안 넘긴다(자동 로그인은 dev 서버 전용) + `Step5Generating` 겉모습을 이전 카드 스타일로, 데이터는 실제 잡 진행(useGenerationJob) 그대로 - solution/backend: copy_service — Gemini 호출 실패해도 잡을 안 죽이고 fact 만으로 계속. db_session_manager — 유니크 제약 충돌(정상 경로) 로그를 ERROR → WARN. worker/runner + alert_service + teams_webhook — 잡 dead-letter·발행 실패·큐 정체를 Teams 로 알림(영구 저장 + 재시도 + dedupe). `/readyz` 추가. collect_diagnostics(신규) — 크롤링 채널별 실패를 jobs.result 에 구조화해서 싣는다. - postgres-init: 0015(users token_version) · 0016(alert_outbox) 마이그레이션 검증: 백엔드 pytest 759 passed. tsc(solution/frontend) 통과. Teams 알림 실채널 수신 확인.
70 lines
2.9 KiB
Python
70 lines
2.9 KiB
Python
"""Microsoft Teams Workflows(수신 webhook) 로 어댑티브 카드 한 장을 보낸다.
|
|
|
|
★ 이 파일은 "HTTP 로 카드 하나 보내기" 딱 그것만 안다 — 언제 보낼지·무엇을 보낼지는
|
|
services/alert_service.py 가 정한다(관심사 분리, 재사용). search_console_alerts.py 가
|
|
쓰는 별도의 좁은 어댑터와는 다른 자리다 — 그건 색인 감시 전용이고 이건 잡 큐·발행 전반의
|
|
장애 알림 전용이다. 카드 포맷이 같은 이유로 합치자는 제안이 오면, 두 기능의 배포 주기가
|
|
다르다는 것과(색인 감시는 스케줄러 전용, 이건 워커 코드 곳곳에서 부른다) 지금 결합 이득이
|
|
적다는 것을 근거로 우선 보류한다.
|
|
|
|
★ webhook 이 설정 안 됐으면 보내지 않는다(is_configured). 값이 없어도 서버는 그대로 뜬다 —
|
|
운영 연결(실제 채널 지정)은 사용자 승인 후 별도로 한다.
|
|
"""
|
|
import os
|
|
|
|
import httpx
|
|
|
|
from common.logger import LOG
|
|
|
|
WEBHOOK_URL_ENV = "TEAMS_WEBHOOK_URL"
|
|
TIMEOUT_SEC = 10.0
|
|
|
|
|
|
def is_configured() -> bool:
|
|
return bool(os.environ.get(WEBHOOK_URL_ENV, "").strip())
|
|
|
|
|
|
def _webhook_url() -> str:
|
|
return os.environ.get(WEBHOOK_URL_ENV, "").strip()
|
|
|
|
|
|
def _card(title: str, detail: str) -> dict:
|
|
"""Adaptive Card 1.2 — Teams Workflows 가 받는 최소 모양(search_console_alerts.py 와 같은 스키마)."""
|
|
return {
|
|
"type": "message",
|
|
"attachments": [{
|
|
"contentType": "application/vnd.microsoft.card.adaptive",
|
|
"contentUrl": None,
|
|
"content": {
|
|
"$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
|
|
"type": "AdaptiveCard",
|
|
"version": "1.2",
|
|
"body": [
|
|
{"type": "TextBlock", "text": title, "weight": "Bolder", "wrap": True},
|
|
{"type": "TextBlock", "text": detail, "wrap": True},
|
|
],
|
|
},
|
|
}],
|
|
}
|
|
|
|
|
|
async def send(title: str, detail: str) -> bool:
|
|
"""설정된 경우에만 보낸다. 실패는 로그로 남기고 삼킨다 — 호출측(alert_service)이 재시도를 관리한다.
|
|
|
|
★ webhook 주소 자체가 인증 수단이다(URL 에 서명이 박혀 있다) — 예외 문자열에 그 URL 이
|
|
실릴 수 있어 로그에는 안 남긴다(search_console_alerts.py 와 같은 규칙)."""
|
|
url = _webhook_url()
|
|
if not url:
|
|
return False
|
|
if not url.startswith("https://"):
|
|
LOG.w("[alert] TEAMS_WEBHOOK_URL_INVALID — https 가 아니다")
|
|
return False
|
|
try:
|
|
async with httpx.AsyncClient(timeout=TIMEOUT_SEC, follow_redirects=False) as client:
|
|
response = await client.post(url, json=_card(title, detail))
|
|
response.raise_for_status()
|
|
return True
|
|
except httpx.HTTPError:
|
|
LOG.w("[alert] TEAMS_DELIVERY_FAILED")
|
|
return False
|