2026-10-25 운영 점검 결함 수정 반영과 검증 결과를 기록
This commit is contained in:
parent
7facf961c5
commit
7b380f752e
5 changed files with 131 additions and 3 deletions
|
|
@ -1,7 +1,7 @@
|
|||
# 배포 파이프라인 (Deployment Pipeline)
|
||||
|
||||
> 작성: 2026-08-31 · 2026-10-20 현행화 · 문서 소유: docs/ops
|
||||
> 상태: Forgejo `master` SHA `aeddaa6972cafabec8113745037533893db0ac34` push, Cloudflare Pages production(`f2039a2e`), NAS API/web 배포와 migration 25 적용을 완료했다. 인증된 운영 내부 UI는 이번 세션에서 검증하지 않았으므로 전체 운영 검증 완료를 선언하지 않는다.
|
||||
> 작성: 2026-08-31 · 2026-10-25 현행화 · 문서 소유: docs/ops
|
||||
> 상태: 2026-10-25 Forgejo `master` SHA `7facf961c5c48355e1c4a2e05e2688811f49b8db`의 NAS API를 승격했다. web·engine·DB·Pages(`42eef402`)는 2026-10-24 상태 그대로다. 소유자 관리자 계정으로 인증된 운영 내부 화면 46개와 실제 상담 연습 1회를 확인했다(§5.8).
|
||||
|
||||
## 목표 아키텍처 (소유자 지시)
|
||||
|
||||
|
|
@ -178,6 +178,15 @@ docker compose -f docker-compose.nas.yml --env-file private/env.nas up -d --no-d
|
|||
- 함정: NAS 원격 명령에서 `cat > 파일 && ... & echo`처럼 체인 전체를 백그라운드로 보내면 stdin이 끊겨 빈 스크립트가 실행된다. 업로드와 `setsid nohup` 실행을 별도 ssh 호출로 나눈다. NAS에는 `pgrep`이 없다.
|
||||
- API 재생성부터 healthy까지 68초였으므로 무중단은 주장하지 않는다. 구조화 증거: [`release-2026-10-24.json`](./evidence/release-2026-10-24.json).
|
||||
|
||||
## 5.8 운영 점검 결함 수정 반영 (2026-10-25, SHA `7facf961c5c48355e1c4a2e05e2688811f49b8db`)
|
||||
|
||||
- 소유자 지시로 운영 전 기능을 점검했다. 소유자 관리자 계정(Google 로그인)으로 23개 경로 × desktop/mobile 46화면을 쓰기 차단 상태로 순회했고, 실제 상담 연습 1회(회기 시작, 2턴, 음성 합성, 종료, 리뷰)를 확인했다.
|
||||
- 발견·수정: (1) 감독·연구 생성 주기가 2026-09-09 근거 링크 변경 뒤 같은 제출 번호에 다른 내용이 들어가 매시 충돌했다(마지막 성공 2026-08-30). 제출 번호 지문이 저장 내용 전체를 덮게 했다. (2) NAS 볼륨 동기 쓰기가 4KB당 약 0.35초라 로그인 요청마다 `last_seen_at` 확정 쓰기 2회가 `/auth/me`를 1~4초로 늘렸고, 모바일에서 재연결 화면이 떴다. 갱신을 60초 간격으로 묶었다. (3) 운영 공급자 `openai`의 참조 단가가 없어 관리자 AI 비용이 9월부터 $0이었다. `gpt-5.6-terra` 공식 단가를 추가했다. (4) 음성 합성 502의 원인을 서버 기록에 남긴다.
|
||||
- 범위는 `apps/api` 4파일과 테스트라 API만 `--no-deps`로 교체했다. 사전 DB dump 12,062,700 bytes·`pg_restore -l` 1,809줄, uploads 93개 manifest, 120개 표 행 수, `env.nas` 사본을 `receipts/release-20261025-20261025T103250Z`에 남겼다. 교체 뒤 행 수 차이 0, uploads 동일, web·engine·DB 컨테이너와 compose 무변경이다. API 재생성부터 healthy까지 69초였으므로 무중단은 주장하지 않는다.
|
||||
- 반영 뒤 감독·연구 주기가 10:45:31Z에 새 주의 스냅샷과 새 링크 형식 공백 스냅샷을 저장했다. `/auth/me`는 NAS 내부 0.012~0.034초, 공개 0.58~0.89초다. 재순회 46화면에서 재연결 화면·page error·끊긴 요청은 0건이다.
|
||||
- 서버 정리: 재시작만 반복하던 `vignette-prod-cloudflared-1`(설정 권한 거부, 45,869회)과 2026-08 미리보기 `vignette-db-1`(45,664회)을 재시작 정책 `no`로 바꾸고 정지했다. 삭제하지 않았다. 공개 터널은 호스트 상주 cloudflared가 계속 맡는다.
|
||||
- 남은 위험: NAS 공유 호스트 과부하(부하 평균 13~17, 교체 공간 소진, 다른 프로젝트 소유 프로세스)와 재부팅 시 호스트 터널 자동 시작 부재. 구조화 증거: [`release-2026-10-25.json`](./evidence/release-2026-10-25.json).
|
||||
|
||||
## 6. 남은 구성 작업 (TODO)
|
||||
|
||||
- [ ] Forgejo master 기준 NAS 자동배포 후크(수동 절차는 §5, §5.1로 실증 완료)
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue