🔄 작업 브랜치 → latest 동기화 (이미지 자체 호스팅 + 테스트 CI) by Kevinlee7250 · Pull Request #28 · Kevinlee7250/cli

Kevinlee7250 · 2026-08-25T06:55:34Z

왜 지금 필요한가

workflow_dispatch는 기본 브랜치(latest)에 있는 워크플로만 찾습니다. image-backfill.yml이 작업 브랜치에만 있어 수동 실행이 404로 거부됩니다. 소급 복제를 한 번이라도 돌리려면 이 동기화가 선행돼야 합니다.

같은 이유로 스케줄 실행도 latest의 워크플로 정의를 읽습니다 — 이 저장소에서 이미 두 번 문제가 됐던 지점입니다.

내용

작업 브랜치의 33개 커밋. 주요 변경:

🖼️ 본문 이미지 자체 호스팅 (image_mirror.py, PR 🖼️ 본문 이미지 자체 호스팅 (docs/images + GitHub Pages) #26)
🖼️ 발행 글 이미지 소급 복제 (mirror_existing_images.py + image-backfill.yml, PR 🖼️ 발행 글 이미지 소급 자체 호스팅 (2단계 방식) #27)
✅ 테스트를 PR에 물림 (blog-tests.yml — pull_request 트리거, paths 확대, 고정 ref 제거)
이미지 파일·매니페스트를 함께 커밋하도록 워크플로 7개 수정
deploy-dashboard에 docs/images/** 배포 경로 연결

검증

로컬에서 병합을 먼저 시뮬레이션했습니다: 충돌 0건, 삭제되는 파일 0건
테스트 741개 통과 (PR 🖼️ 본문 이미지 자체 호스팅 (docs/images + GitHub Pages) #26·#27에서 러너 확인)

latest에는 스케줄 실행이 만든 데이터 커밋 101개가 앞서 있지만 코드 영역과 겹치지 않습니다.

🤖 Generated with Claude Code

https://claude.ai/code/session_01RgLYqM9puPW1aqHTccbX69

Generated by Claude Code

지금까지 본문 이미지는 전부 남의 서버를 가리키는 핫링크였습니다. 원본이 지워지거나 URL 규칙이 바뀌면 이미 발행한 글이 조용히 깨지고, 우리 쪽에는 무엇이 있었는지조차 남지 않습니다 (최근 1,000장 중 Pixabay 해시 URL 467장). docs/ 는 이미 GitHub Pages로 배포되므로 docs/images/ 에 커밋하면 그대로 공개 URL이 됩니다. 내용 해시를 파일 이름으로 써서 같은 사진은 한 번만 저장하고, 어느 원본에서 왔는지는 docs/data/image_mirror.json 에 남깁니다. 설계에서 지킨 것 · 복제는 저작권 화이트리스트 관문 **뒤**에서만. 앞에서 하면 복제본이 우리 도메인이라 무조건 통과해, 권리 없는 이미지를 저장소에 복사한 뒤 안전하다고 판정하게 됩니다. 순서를 소스에서 검사합니다. · 복제 실패 시 원본 유지. 자체 호스팅 때문에 글 생성이 멈추면 안 됩니다. · <img>에 원본을 onerror 폴백으로 심음 — 발행과 Pages 배포 사이 몇 분, 그리고 복제본 유실에 대비. 이 한 줄이 "핫링크보다 나쁜 경우"를 없앱니다. · image_audit은 저장소에 파일이 있는 복제본을 살아있는 것으로 봅니다. 배포 전 404를 broken으로 잡으면 멀쩡한 글을 도로 핫링크로 되돌립니다. · 중복 방지 기록은 원본 URL 기준. 복제 경로로 적으면 같은 사진이 매번 새 이미지로 보여 중복 차단이 무력해집니다. · 2MB 초과·이미지가 아닌 응답은 복제하지 않습니다 (Pillow 미설치라 리사이즈 불가 — 저장소가 부푸는 쪽이 더 큰 손해). feature_flags의 image_self_host로 끄면 즉시 옛 핫링크 방식으로 돌아갑니다. 대시보드 스위치 패널에도 올렸습니다. 이미지 파일과 매니페스트를 따로 커밋하면 발행된 글이 404를 보므로, 둘을 함께 커밋하는지 test_workflow_pending_files가 검사합니다. 그 검사가 `for f in ...` 목록 줄을 못 보고 있던 것도 함께 고쳤습니다. 테스트 717개 통과 (신규 21개). Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01RgLYqM9puPW1aqHTccbX69

blog-tests.yml은 이미 있었지만 PR에는 한 번도 붙지 않았습니다. 이유가 셋이었고, 셋 다 "초록불인데 아무것도 검사하지 않는" 유형입니다. 1) pull_request 트리거 없음 — PR에는 아예 안 돌았습니다. 2) paths가 '**.py'만 걸려 있었습니다. 테스트가 지키는 것은 파이썬 코드만이 아닙니다 — 워크플로의 커밋 목록, 대시보드와 데이터 파일의 계약, 스위치 이름과 화면 라벨까지 검사하는데, 정작 그 파일들이 바뀔 때는 돌지 않았습니다. PR #26이 워크플로 7개와 index.html을 고쳤는데도 조용했던 이유입니다. 3) checkout에 ref: claude/blog-automation-system-KAbtE 가 박혀 있었습니다. PR에서 돌더라도 PR의 코드가 아니라 그 브랜치를 받아 검사합니다. 검사한 적 없는데 통과로 보이는 쪽이 검사가 아예 없는 것보다 나쁩니다. 수집 개수 확인 단계도 붙였습니다. pytest는 "0개 수집"으로도 성공으로 끝날 수 있어서, import 하나가 깨져 전부 수집되지 않아도 초록불이 됩니다. 세 가지가 되돌아가지 않도록 test_ci_wiring.py가 워크플로를 직접 읽어 검사합니다. 테스트 723개 통과 (신규 6개). Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01RgLYqM9puPW1aqHTccbX69

🖼️ 본문 이미지 자체 호스팅 (docs/images + GitHub Pages)

image_mirror는 앞으로 쓰는 글만 자체 호스팅합니다. 이미 발행된 글은 여전히 남의 서버 핫링크라, 원본이 사라지면 그 글들이 조용히 깨집니다. 두 단계로 나눴습니다 1단계 --mirror-only 이미지를 내려받아 docs/images에 저장 (발행 글은 손 안 댐) → 커밋·푸시 → Pages 배포 2단계 --rewrite 공개 URL이 실제로 200을 주는지 확인한 뒤에만 본문 교체 나눈 이유: 복제본은 커밋되고 배포돼야 열립니다. 내려받자마자 발행 글의 src를 돌리면 배포 전까지 수백 편이 404 이미지를 가리킵니다. 사람 눈에는 onerror 폴백이 가려 주지만 크롤러는 404를 그대로 봅니다. 2단계는 URL 하나하나를 실제로 받아 보고, 안 열린 것은 건너뜁니다. 확인에 실패해도 교체하지 않습니다 — 낙관적으로 넘기면 살아 있는 글이 깨집니다. 그래서 순서를 잘못 돌려도 글을 깨뜨릴 수 없고, 몇 번을 다시 돌려도 안전합니다. 복제 대상은 화이트리스트를 통과한 이미지뿐입니다. 무단 이미지를 우리 저장소로 옮기면 핫링크보다 나쁜 상태(직접 배포)가 되므로 세기만 하고 건드리지 않습니다 — 그쪽은 fix_unlicensed_images가 할 일입니다. 함께 고친 것: deploy-dashboard가 이 워크플로 완료에 반응하도록 했습니다. Actions가 기본 GITHUB_TOKEN으로 만든 커밋은 push 트리거를 발동시키지 않으므로, 이게 없으면 1단계가 복제해서 커밋해도 영원히 배포되지 않아 2단계가 아무것도 못 바꿉니다. push 경로에도 docs/images/**를 넣었습니다. 테스트 741개 통과 (신규 18개). Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01RgLYqM9puPW1aqHTccbX69

🖼️ 발행 글 이미지 소급 자체 호스팅 (2단계 방식)

github-actions Bot and others added 30 commits August 24, 2026 05:28

chore: 트렌드 키워드 자동 수집 (2026-08-24 14:28 KST)

d3baecb

🚨 운영 알림 점검 (#18)

f215ca7

🔥 트렌드 선점 후보 갱신 (npm#247)

107d0c2

chore: 트렌드 키워드 자동 수집 (2026-08-24 17:39 KST)

1e4cfcd

🔥 트렌드 선점 후보 갱신 (npm#248)

762bad6

chore: 트렌드 키워드 자동 수집 (2026-08-24 20:25 KST)

449501e

🚨 운영 알림 점검 (#19)

9f8ad43

🔥 트렌드 선점 후보 갱신 (npm#249)

420bc73

chore: 트렌드 키워드 자동 수집 (2026-08-24 23:44 KST)

b6935f8

🔥 트렌드 선점 후보 갱신 (npm#250)

2f642b4

🔧 자동 수리 완료 (npm#224)

60d6062

chore: 트렌드 키워드 자동 수집 (2026-08-25 02:34 KST)

185eb6b

chore: 스케줄 실행 이력 업데이트 (2026-08-25 03:28 KST)

bfe010c

🚨 운영 알림 점검 (#20)

99d810c

🔥 트렌드 선점 후보 갱신 (npm#251)

b4446d5

chore: 트렌드 키워드 자동 수집 (2026-08-25 05:36 KST)

7f1753b

🔥 트렌드 선점 후보 갱신 (npm#252)

07fcd85

📊 blog3 게시 완료 (npm#312)

37eb6fc

chore: 게시 후 성과 추적 (2026-08-25)

59f2436

🔗 역방향 내부 링크 (#3)

332e30b

📅 시리즈 발행 예약 처리 (#37)

3d9da65

chore: 트렌드 키워드 자동 수집 (2026-08-25 08:27 KST)

7971f5c

🔍 구글 색인 상태 리포트 (#47)

a43c100

🚨 운영 알림 점검 (#21)

696166d

🔥 트렌드 선점 후보 갱신 (npm#253)

b03771d

chore: 트렌드 키워드 자동 수집 (2026-08-25 12:02 KST)

547811a

🔥 트렌드 선점 후보 갱신 (npm#254)

d68b432

🤖 봇 응답 (npm#287)

c917196

🔧 자동 수리 완료 (npm#225)

cc65e5d

github-actions Bot and others added 5 commits August 25, 2026 05:22

chore: 트렌드 키워드 자동 수집 (2026-08-25 14:22 KST)

6d8be2b

🖼️ 본문 이미지 자체 호스팅 + 테스트 CI 연결 (#26)

bd6daf9

🖼️ 본문 이미지 자체 호스팅 (docs/images + GitHub Pages)

🖼️ 발행 글 이미지 소급 자체 호스팅 (#27)

8241f95

🖼️ 발행 글 이미지 소급 자체 호스팅 (2단계 방식)

Kevinlee7250 merged commit 2f8e417 into latest Aug 25, 2026
3 checks passed

github-actions Bot added a commit that referenced this pull request Aug 26, 2026

🖼️ 이미지 검증 (#28)

f21dd3d

github-actions Bot added a commit that referenced this pull request Aug 26, 2026

🚨 운영 알림 점검 (#28)

f3cda0d

github-actions Bot added a commit that referenced this pull request Sep 19, 2026

🔗 역방향 내부 링크 (#28)

d513a1f

github-actions Bot added a commit that referenced this pull request Sep 19, 2026

✍️ 조작 체험담 정정 리포트 — audit (#28)

4f6a6cc

Navigation Menu

Repository navigation

🔄 작업 브랜치 → latest 동기화 (이미지 자체 호스팅 + 테스트 CI) - #28

🔄 작업 브랜치 → latest 동기화 (이미지 자체 호스팅 + 테스트 CI)#28
Kevinlee7250 merged 35 commits into
latestfrom
claude/blog-automation-system-KAbtE

Kevinlee7250 commented Aug 25, 2026

Uh oh!

Uh oh!

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

Kevinlee7250 commented Aug 25, 2026

왜 지금 필요한가

내용

검증

Uh oh!

Uh oh!

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants