From e82fbb58e9ce1ab2c88522c10bd97e1b54e7c9e5 Mon Sep 17 00:00:00 2001 From: Yun Chan Date: Fri, 11 Sep 2026 15:22:28 +0900 Subject: [PATCH] =?UTF-8?q?docs:=203=EC=B0=A8=20=EC=A0=95=EC=8B=9D=20?= =?UTF-8?q?=EB=B0=B0=ED=8F=AC=20=EA=B8=B0=EB=A1=9D=20=EC=B6=94=EA=B0=80=20?= =?UTF-8?q?(4b45d331,=20engine=20=EC=84=A0=ED=96=89=20=EA=B5=90=EC=B2=B4?= =?UTF-8?q?=20=EC=A0=81=EC=9A=A9)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/ops/deployment-pipeline.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/docs/ops/deployment-pipeline.md b/docs/ops/deployment-pipeline.md index 65a11a0..44fa849 100644 --- a/docs/ops/deployment-pipeline.md +++ b/docs/ops/deployment-pipeline.md @@ -124,6 +124,15 @@ docker compose -f docker-compose.nas.yml --env-file private/env.nas up -d --no-d - 이후 같은 버전에서 컨테이너 healthy, 공개 `200`, 학습자 회기 조회 정상과 DB 전체 집계 동일을 확인했다. 이 회복 관찰은 무중단 배포 증거가 아니다. - 다음 배포는 §5의 변경 범위 판정을 먼저 적용한다. engine 변경이 있으면 engine healthy·readiness 뒤 API를 교체하고, engine 변경이 없으면 API와 같은 이미지 참조만으로 engine을 재생성하지 않는다. +## 5.3 3차 정식 배포 완료 (2026-09-11, SHA `4b45d331`) + +- 관리자 AI 제공자 연결 기능(토큰 붙여넣기 연결, `app.admin_provider_credential`) 배포. +- §5 절차 준수: DB dump(`pre-deploy-4b45d331-.dump`, 11.8MB) + `env.nas.before-deploy-4b45d331` 백업 뒤 클론·빌드. +- 변경 범위 판정: engine 코드 변경 존재 → **engine 먼저 재생성, healthy 확인 뒤 api·web 교체**(§5.2 교훈 적용, 동시 재생성 회피). +- 이미지: `vignette-nas-api:4b45d331`(sha256 c6b9201ec8ef), `vignette-nas-web:4b45d331`(sha256 d999ea74a8e4). env.nas 이미지 참조 갱신. +- 기동 확인: api·engine `healthy`, `http://127.0.0.1:18080/health` 및 공개 `https://api-vignette.chanpaca.net/health` → `status: ok, db: true, engine: true`(engine_mode openai, ready OK). +- 배포 후 관리자가 `/admin/ai` 제공자 연결 패널에서 claude·codex·agy·openrouter 토큰을 연결하면 실행 중인 engine 컨테이너에 즉시 push 적용된다(재배포 불필요). + ## 6. 남은 구성 작업 (TODO) - [ ] Forgejo master 기준 NAS 자동배포 후크(수동 절차는 §5, §5.1로 실증 완료)