DEV Community

Cover image for 번역 파이프라인 스모크 테스트
Rihpig
Rihpig

Posted on • Originally published at apidog.com

번역 파이프라인 스모크 테스트

이 글은 n8n 번역 워크플로의 세 가지 동작을 빠르게 검증하기 위한 작은 테스트 게시물입니다. 검증 대상은 원본 게시물의 카테고리 복사, 로케일별 발췌문 번역, 번역본 내부 링크가 EN 원본이 아니라 동일한 언어 버전으로 재작성되는지 여부입니다. 라이브 블로그에 노출되면 테스트 완료 후 삭제해야 합니다.

오늘 Apidog을 사용해 보세요

이 게시물이 존재하는 이유

기존 n8n 번역 워크플로에는 다음 문제가 있었습니다.

  • 번역된 게시물에서 카테고리 배지가 누락됨
  • 번역된 게시물의 custom_excerpt가 비어 있음
  • 번역본 내부 링크가 여전히 EN URL을 가리킴

예를 들어 일부 LLM 튜토리얼의 포르투갈어 버전에는 카테고리와 발췌문이 모두 없었습니다. 또한 내부 링크가 EN URL로 남아 있어 hreflang 클러스터가 약해지고, 인도네시아어 독자가 영어 설명으로 이동하는 문제가 있었습니다.

이번 워크플로 개정에서는 위 문제를 수정했으며, 이 게시물은 실제 Ghost 환경에서 수정 사항이 엔드투엔드로 동작하는지 확인하는 스모크 테스트입니다.

테스트 범위

이 게시물을 게시하면 n8n 번역기가 한 번 실행되고, Ghost에 11개의 번역된 초안 또는 게시물이 생성되어야 합니다.

각 번역본에서 아래 항목을 확인합니다.

  1. custom_excerpt 필드가 EN 발췌문의 번역으로 채워져 있어야 합니다.
    • 비어 있으면 실패입니다.
  2. category 필드가 원본 게시물의 Tutorials 값을 그대로 가져와야 합니다.
  3. 본문 내부 링크가 동일한 로케일 URL로 재작성되어야 합니다.
    • 예: 일본어 번역본은 EN URL이 아니라 https://apidog.com/jp/blog/free-cursor-ai/를 포함해야 합니다.

링크 재작성 확인 대상

아래 링크는 클릭용이 아니라 재작성 검증용입니다. 링크 재작성 정규식이 절대 URL과 루트 상대 URL 패턴을 모두 처리해야 하므로 두 형식을 의도적으로 포함합니다.

번역 파이프라인이 정상이라면 일본어 버전에서는 위 네 URL이 모두 다음 형식으로 재작성되어야 합니다.

/jp/blog/{slug}/
Enter fullscreen mode Exit fullscreen mode

특히 인도네시아어 번역본은 다음 형식이어야 합니다.

/id/blog/{slug}/
Enter fullscreen mode Exit fullscreen mode

다음처럼 잘못 생성되면 안 됩니다.

/ig/blog/{slug}/
Enter fullscreen mode Exit fullscreen mode

또한 인도네시아어 게시물 자체는 Ghost에서 다음 조건을 가져야 합니다.

slug: …-id
tag: 1Locale ID
Enter fullscreen mode Exit fullscreen mode

이 이름 변경은 요구사항 6의 후속 조치입니다.

게시 후 확인 방법

렌더링된 페이지가 정상인지 확인하려면 게시 후 다음처럼 응답 상태를 먼저 확인합니다.

# 번역된 일본어 게시물이 정상 응답하는지 확인
curl -I https://apidog.com/jp/blog/translation-pipeline-smoke-test/
Enter fullscreen mode Exit fullscreen mode

기대 결과는 200 응답입니다.

HTTP/2 200
Enter fullscreen mode Exit fullscreen mode

그다음 렌더링된 페이지에서 아래 항목을 수동으로 확인합니다.

  • Tutorials 카테고리 배지가 표시되는가
  • 제목 아래에 일본어 발췌문이 표시되는가
  • 내부 링크가 모두 /jp/blog/... 형식으로 재작성되었는가
  • EN URL이 본문에 남아 있지 않은가

간단히 HTML에서 로케일 경로를 확인하려면 다음처럼 검사할 수 있습니다.

curl -s https://apidog.com/jp/blog/translation-pipeline-smoke-test/ \
  | grep -E '/jp/blog/|apidog.com/blog/'
Enter fullscreen mode Exit fullscreen mode

확인 기준은 다음과 같습니다.

PASS: /jp/blog/... 링크가 존재함
FAIL: /blog/... 또는 EN 원본 링크가 남아 있음
Enter fullscreen mode Exit fullscreen mode

확인 후 정리

11개의 번역본에서 다음 항목이 모두 정상이라면 이 테스트 게시물과 Ghost에 생성된 11개 번역본을 삭제합니다.

  • 카테고리 복사 정상
  • 발췌문 번역 정상
  • 내부 링크 재작성 정상
  • 인도네시아어 로케일 경로가 /id/blog/...로 생성됨

이 게시물은 검증용이므로 생산 가치가 없습니다.

반대로 다음 문제가 하나라도 보이면 삭제하지 말고 진단을 위해 보관합니다.

  • 카테고리 누락
  • 빈 custom_excerpt
  • 잘못된 링크 재작성
  • /id/ 대신 /ig/ 경로 생성
  • 잘못된 슬러그 또는 로케일 태그

문제가 확인되면 워크플로 소유자에게 전달하고, 해당 번역 실행 결과를 기준으로 n8n 워크플로를 디버깅합니다.

Top comments (0)