운영·업데이트·데이터 보존

목적

이 lesson은 셀프호스팅 운영자가 Open Design에서 다음 판단을 안전하게 하기 위한 절차입니다.

언제 쓰나

운영·업데이트·데이터 보존가 현재 목표일 때 사용합니다. 다른 목표라면 Workflow Map에서 다른 흐름을 먼저 선택하세요.

준비물

• Repo 문서 또는 설치 경로를 볼 수 있어야 합니다.
• 필요한 경우 Docker, Node 24, pnpm 10.33.x, agent CLI 또는 API 키를 준비합니다.
• 이 패키지는 live 실행을 하지 않았으므로 현장 값은 실제 환경에서 다시 읽습니다.

단계별 확인

1. 1 상태와 로그 확인: 컨테이너/daemon 상태와 웹 화면 문제를 분리합니다.
   QUICKSTART.md Common Docker Commands 확인
2. 2 저장 위치 확인: 프로젝트와 SQLite/아티팩트가 어디에 남는지 확인합니다.
   QUICKSTART.md Persistent Storage 및 architecture artifact store 확인
3. 3 업데이트 전 보존 판단: 이미지 업데이트와 데이터 삭제는 다른 작업입니다.
   docs/install-guide.md update/uninstall 확인
4. 4 재접속 확인: 업데이트 후 다시 health와 브라우저 접근을 확인합니다.
   install guide health check 설명 확인

구체 증거

흔한 실수

• 초기화가 목적이 아니라면 `docker compose down -v`나 uninstall 기본 삭제 경로를 피합니다.
• 업데이트와 데이터 삭제를 같은 작업으로 다루지 않습니다. `down -v` 또는 uninstall 기본값은 보존 여부를 먼저 판단합니다.

검증 / readback

다음 질문에 답할 수 있으면 이 lesson의 기본 이해는 통과입니다.

• 이 흐름의 첫 입력은 무엇인가?
• 성공을 어떤 파일, 화면, 명령 결과, 문서 근거로 확인하는가?
• 다음 단계로 가기 전에 멈춰야 하는 조건은 무엇인가?

근거

• QUICKSTART.md Common Docker Commands 확인
• QUICKSTART.md Persistent Storage 및 architecture artifact store 확인
• docs/install-guide.md update/uninstall 확인
• install guide health check 설명 확인

다음 판단

상태·로그·보존 기준이 정리되면 필요에 따라 설치 흐름 또는 확장/기여 흐름으로 이동합니다.

검증 경계

이 lesson은 repo/docs와 포함된 screenshot 근거의 정적 매뉴얼입니다. 실제 서버 실행, 현재 UI label, agent 인증 성공, 생성 품질은 현장 검증이 필요합니다.