Skip to content

confluence-mdx: Confluence 동기화 기반을 복구합니다 - #1053

Merged
jk-kim0 merged 4 commits into
mainfrom
jk/mdx-confluence-space-update-20260728
Jul 28, 2026
Merged

confluence-mdx: Confluence 동기화 기반을 복구합니다#1053
jk-kim0 merged 4 commits into
mainfrom
jk/mdx-confluence-space-update-20260728

Conversation

@jk-kim0

@jk-kim0 jk-kim0 commented Jul 28, 2026

Copy link
Copy Markdown
Contributor

Summary

Confluence Space recent sync를 실행해 최신 문서 상태를 확인하고, 자동 동기화를 막던 catalog와 manifest 문제를 해결합니다.

  • pages.qcp.yaml을 유효한 YAML list로 초기화해 cross-profile preflight 오류를 제거합니다.
  • atomic conversion manifest를 0644로 저장해 container 다음의 Git 단계가 읽을 수 있도록 합니다.
  • main의 pages.*.yaml이 변경되면 Docker image build가 --remote --attachments를 선택해 hierarchy cache를 전체 갱신합니다.
  • catalog 변경이 없는 push와 PR build는 기존 --recent --attachments를 유지합니다.

최근 수정 후보 3개는 모두 main과 동일했으며, 최신 QM catalog 316개 중 root를 제외한 315개 문서를 변환한 결과 실제 ko/en/ja 문서 변경은 없었습니다.

Test plan

  • confluence-mdx/venv/bin/python bin/fetch_cli.py --recent --attachments
  • confluence-mdx/venv/bin/python bin/convert_all.py --sync-code qm — 315개 문서 변환 성공
  • confluence-mdx/venv/bin/python bin/convert_all.py --verify-translations
  • confluence-mdx/venv/bin/python -m pytest tests/test_convert_all_folders.py -q — 16 passed
  • workflow YAML parse 및 catalog 변경/미변경 fetch mode 조건 확인
  • git diff --check

Additional notes

  • 첫 workflow 실행은 빈 QCP catalog가 YAML null로 해석되어 실패했습니다.
  • 두 번째 workflow 실행은 297개 문서 변환까지 성공했지만 root 소유 0600 manifest를 git add가 읽지 못해 실패했습니다.
  • 기존 Docker image hierarchy가 최신 main보다 뒤처져 생성한 stale 문서 삭제는 반영하지 않았습니다. 이 PR이 main에 병합되면 catalog 변경을 감지한 image build가 full remote fetch를 실행합니다.
  • 운영 로그 가이드의 2>&1은 PR confluence-mdx: Space 계층과 canonical 경로를 동기화합니다 #1052 리뷰로 추가된 수동 보정이며 Confluence 원문에는 아직 반영되지 않았습니다. 재변환으로 발생한 redirection 회귀는 이번 PR에서 제외했습니다.

Related tickets & links

🤖 Generated with Codex

Co-Authored-By: Atlas atlas@jk.agent

jk-kim0 and others added 3 commits July 28, 2026 15:57
## Summary
QM 변환의 cross-profile preflight가 빈 QCP catalog를 YAML null로 해석하지 않도록 유효한 빈 목록으로 명시합니다.

- `pages.qcp.yaml`을 빈 YAML list로 초기화합니다.
- QM Confluence 동기화 workflow가 sibling catalog를 안전하게 검사하도록 합니다.

## Test plan
- [x] `confluence-mdx/venv/bin/python -m pytest tests/test_convert_all_folders.py -q`
- [x] `git diff --check`

🤖 Generated with Codex

Co-Authored-By: Atlas <atlas@jk.agent>
## Summary
Container가 atomic replace로 생성한 conversion manifest를 후속 Git 단계가 읽을 수 있도록 파일 권한을 명시합니다.

- 임시 manifest를 교체하기 전에 권한을 `0644`로 설정합니다.
- 생성된 manifest 권한을 회귀 테스트로 검증합니다.

## Test plan
- [x] `confluence-mdx/venv/bin/python -m pytest tests/test_convert_all_folders.py -q`
- [x] `git diff --check`

🤖 Generated with Codex

Co-Authored-By: Atlas <atlas@jk.agent>
## Summary
main의 Space catalog가 변경되면 Docker image hierarchy cache도 전체 갱신하도록 fetch mode를 선택합니다.

- main push에서 `pages.*.yaml` 변경을 감지하면 `--remote --attachments`를 사용합니다.
- 일반 PR build와 catalog 변경이 없는 push는 `--recent --attachments`를 유지합니다.
- workflow_dispatch에서는 사용자가 선택한 fetch arguments를 그대로 사용합니다.

## Test plan
- [x] catalog 변경 commit이 remote mode로 선택되는지 확인합니다.
- [x] converter-only commit이 recent mode로 선택되는지 확인합니다.
- [x] `git diff --check`

🤖 Generated with Codex

Co-Authored-By: Atlas <atlas@jk.agent>
@vercel

vercel Bot commented Jul 28, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
querypie-docs Ready Ready Preview, Comment Jul 28, 2026 7:34am

Request Review

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 5105c1ed01

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread .github/workflows/build-and-push-docker-image.yml Outdated
## Summary
catalog 변경이 있는 main push에서 해당 Space의 hierarchy를 정확히 갱신합니다.

- 변경된 catalog 파일명에서 sync code를 도출하고 복수 Space를 순차 fetch합니다.
- fetch하지 않는 Space의 tracked catalog를 Docker builder에 보존합니다.
- 이전 commit을 조회할 수 없으면 모든 catalog를 full fetch 대상으로 사용합니다.

## Test plan
- [x] QCP-only, catalog 미변경, missing-before, 복수 catalog fetch plan을 검증합니다.
- [x] `docker buildx build --check confluence-mdx`를 통과합니다.
- [x] `confluence-mdx/venv/bin/python -m pytest confluence-mdx/tests/test_convert_all_folders.py -q`를 통과합니다.

🤖 Generated with Codex
@jk-kim0
jk-kim0 merged commit 5eb8740 into main Jul 28, 2026
7 checks passed
@jk-kim0
jk-kim0 deleted the jk/mdx-confluence-space-update-20260728 branch July 28, 2026 07:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant