Skip to content

fix(release): snapshot-docs via PR instead of direct push to protected main#343

Merged
erishforG merged 1 commit into
developfrom
fix/release-snapshot-docs-via-pr
Jun 3, 2026
Merged

fix(release): snapshot-docs via PR instead of direct push to protected main#343
erishforG merged 1 commit into
developfrom
fix/release-snapshot-docs-via-pr

Conversation

@erishforG

Copy link
Copy Markdown
Owner

Problem

v0.5.0 release run에서 `Snapshot Versioned Docs` job이 실패. 원인:

  • main 브랜치 protection: "Changes must be made through a pull request"
  • 이전까지 `git push origin main`이 통하던 시기에 만든 job이라 protection 강화 후 깨졌음
  • 핵심 배포(tag · crates.io · binaries)는 영향 없었지만 versioned docs URL (`/git-parsec/v/0.5.0/`)이 자동 생성 안됨

Fix

  • `.github/workflows/release.yml`: `git push origin main` → `peter-evans/create-pull-request`로 자동 PR 생성
  • `.github/workflows/ci.yml` Branch Policy: `develop` 외에 `docs/snapshot-v*` 브랜치도 main 머지 허용 (자동 생성 PR이 통과하도록)

사용 시나리오 (다음 릴리스부터)

  1. develop → main 머지 → release.yml 트리거
  2. tag · cargo publish · GitHub Release 자동
  3. `snapshot-docs` job이 `docs/snapshot-v` 브랜치 + PR 자동 생성 (label: `release`, `auto-snapshot`)
  4. Eric 1탭 머지

Test plan

  • yaml syntax OK
  • 다음 릴리스 (v0.5.1 또는 v0.6.0)에서 실제 동작 확인 — 자동 PR 생성되어야 함

Related: PR #342 (v0.5.0 수동 스냅샷).

🤖 Generated with Claude Code

v0.5.0 release run의 `Snapshot Versioned Docs` job이 main 브랜치 protection
(`Changes must be made through a pull request`) 때문에 직접 push 실패.

## 변경
- `.github/workflows/release.yml`: `git push origin main` → `peter-evans/create-pull-request`로 `docs/snapshot-v<ver>` 브랜치 자동 생성 + PR 오픈. `pull-requests: write` 권한 추가.
- `.github/workflows/ci.yml`: Branch Policy가 `docs/snapshot-v*` 브랜치도 main에 머지 허용 (data-only 변경이므로 develop 우회 안전).

## 효과
다음 릴리스부터 자동으로 `docs/snapshot-vX.Y.Z` 브랜치 + auto-snapshot 라벨이 붙은 PR이 생성됨. Eric이 머지하면 versioned docs가 main에 반영. push 실패 0.

Co-Authored-By: Pochacco <noreply@anthropic.com>
@erishforG erishforG merged commit 61b40da into develop Jun 3, 2026
12 checks passed
@erishforG erishforG deleted the fix/release-snapshot-docs-via-pr branch June 3, 2026 15:20
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