notParsec / 문서전체 문서

설명·설계 문서

새 빌드 자동 게시와 최신 파일만 보관

design/LATEST_BUILD_PUBLICATION.ko.md

출처: 현재 작업 폴더 · 원문 다운로드

이 문서의 목차

2026-10-01 · 사용자 요청 · E02 자체 서버 운영 · F76/F78

새 배포용 앱 빌드는 검증 후 콘솔 다운로드에 반영한다. 정상 교체가 끝나면 관리되는 이전 빌드 파일을 정리한다. Windows, Mac Apple Silicon, Mac Intel은 각각의 최신 파일을 유지한다. 원본 Windows Parsec 150-104a 서버의 배포 방식을 복원했다는 의미는 아니며 기존 parity 판정을 올리지 않는다.

게시·정리 순서

  1. 앱의 실제 형식, 해시, 빌드 식별 정보를 검사한다. 소스 변경이나 빌드 실패가 있으면 게시하지 않는다.
  2. 기존 플랫폼 파일과 새 파일을 합친 새 다운로드 묶음을 검증하고 current를 원자적으로 교체한다.
  3. 현재 묶음을 확인한 뒤 이전 관리 묶음을 삭제한다. 같은 빌드의 동일 파일을 다시 게시해도 중복이 생기지 않으며 기존에 누적된 묶음도 정리한다.
  4. 서버는 새 실행 파일의 readiness가 성공한 뒤 이전 실행 파일을 정리한다. 실패 시에는 기존 복구 파일을 유지한다.

이전 빌드 번호, 같은 번호에 다른 내용, 버전이 있는 앱을 버전 없는 파일로 바꾸는 요청은 거부한다. CI 작업이 늦게 끝나도 최신 앱을 과거 버전으로 되돌리지 않는다. 파일이 없는 플랫폼을 임의의 구버전으로 채우지 않는다.

다운로드 중 교체

서버는 current를 확인하기 전 다운로드 루트 디렉터리에 공유 잠금을 잡고 필요한 파일을 모두 연 다음 해제한다. 설치기는 같은 디렉터리에 배타 잠금을 잡고 교체·정리한다. 이미 열린 Linux 파일은 경로를 삭제해도 읽을 수 있으므로 진행 중인 다운로드는 완료된다. 목록을 읽은 뒤 새 다운로드가 시작된 경우에는 기존 해시 비교로 파일 교체를 감지한다.

정리 범위

2026-10-01 Windows 게시

Windows 0.1.0, 빌드 1790878114, 소스 893f8d9a7b57f66401ba580ad6c1a7018b204ac5를 게시했다. EXE SHA-256은 a4c3eff7782de9c6d31a7fe7a977fdff8cdfcb4aa08dca55857593ff95fc66de다. 게시 파일과 업데이트 manifest의 해시·크기·빌드, Mac 최신 파일 보존과 서버 readiness를 확인했다.

이 EXE에는 앞서 작업한 VDD 준비 상태 및 잠금·모니터 꺼짐 복구 코드가 포함된다. Windows 실기 시험, 서명된 VDD 설치, 서비스 Privacy는 여전히 미검증 또는 미지원이다. Windows 서비스 갱신과 시험 명령을 따른다.

활성화와 검증

운영 게시기는 root 소유의 설치 코드를 고정해서 사용한다. 저장소 파일 수정만으로 운영 정리 정책이 바뀌지는 않는다. 검토·시험을 마친 설치 코드를 관리자 명령으로 한 번 갱신한 뒤 일반 배포에는 기존 고정 명령을 사용한다. CI에는 일반 sudo 권한을 추가하지 않는다.

2026-10-01에는 다운로드 읽기 잠금을 포함한 서버를 먼저 게시하고, 새 서버·최신 Windows 파일·문서를 dist/deploy-ready에 준비했다. 당시 고정 설치 코드와 CI 게시 서비스의 관리자 갱신은 대기 상태였다. 2026-10-02 후속 확인에서는 갱신과 운영 정리가 적용된 상태를 확인했다. 이 호스트에 활성화 명령을 다시 실행할 필요는 없다. 아래는 새 호스트를 설정하거나 고정 설치 코드를 이후 갱신할 때 사용하는 명령이다.

sudo python3 /home/ahn/notparsec/deploy/ubuntu/enable-auto-deploy.py --apply

2026-10-02 운영 후속 확인

이후 빌드 경로

GitLab의 과거 태그·Generic Package Registry는 콘솔의 파일 보관소와 별도이며 이번 자동 삭제 대상에 넣지 않았다. 기존 CI job artifact는 7일 보관 설정을 유지한다. 원본 소스·검증 이력 삭제나 GitLab 영구 릴리스 링크 파손을 콘솔 정리와 함께 수행하지 않는다.

구체적인 활성화 상태·시험·실제 정리 전후 파일 수와 용량은 검증 기록을 따른다. 자동 게시 경로와 설치 명령은 배포 운영 문서에 기록한다.

2026-10-02 클라이언트 UI 빌드 게시

고정 SDK 준비와 Windows Clippy 후 scripts/build-windows-ubuntu.sh의 기본 경로가 빌드 1790965245를 자동 게시했다. 소스 cfacac7, EXE SHA-256 f3502bd410776002b54433b77455133dda4a2869f104ade78e6306010b71c340이다. 이전 Windows 묶음은 정리됐고 Mac 최신 파일은 보존됐다. 다운로드는 1묶음·4파일·69,417,515바이트, 서버 실행 파일은 기존 1개다. 파일·API/HTTP·브라우저 17개 검사와 readiness를 통과했다. 수정·검증·게시 기록을 참고한다. 이 로컬 빌드의 실제 자동 게시와 새 CI 태그 전체 실행 시험은 구별한다.