크라우니클라우드 관리 사이드카 통합 (:9662)
개요
crowny-cloud 관리대시보드용 사이드카
클라우드관리.한선을 본체로 조립, 기존 모듈 7종(노드/서비스/게이트/가드/백업/체인/배포)을 위임 라우팅으로 결선. 게이트웨이
/cloudapi 프록시 + LaunchAgent 상시화까지 완료.
한 것
- 기존 모듈 7종(
클라우드_노드.한선 등) 확인 — 전부 이미 작성돼 있었음, 개별 컴파일은 가드/백업이 타모듈 함수(서비스적용/게이트적용/체인기록) 참조로 단독컴파일 실패하나 이는 정상(본체에서 함께 가져오기하면 해소).
- 본체
/Users/ef/crowny-services/클라우드관리.한선 작성: 가져오기 7종 → 데이터디렉 mkdir → TCP대기(PORT env, 기본9662, bind실패시 즉시 종료 안내) → 요청파싱(/cloudapi 접두제거, X-Crowny-Owner 화이트리스트 검증) → 노드→가드→서비스→게이트→백업→체인→배포 순서 위임 → 미매칭 404 JSON → 200요청마다 문자열GC().
- STRICT 컴파일 0경고:
/Users/ef/crowny-services/클라우드관리.toau.
- 기동 검증: 전 GET 라우트(health/node/services/routes/guard/tier/chain/deploy check·snapshot) curl 200+JSON 확인. POST 종단 2건: guard enqueue→approve(가드통계 ok 0→1 증가 실측), backup POST→tar.gz 실제 생성+체인 백업보상(+0.4 CRW) 실측.
- 게이트웨이:
/Users/ef/crowny-gateway/gateway.yaml cloud.crowny.org pathRoutes에 /cloudapi → 127.0.0.1:9662 추가(기존 /takeurban 형식 모방) + 백업본 gateway.yaml.bak.<ts> 보관. gw restart(launchctl kickstart)로 반영 — 최초 kickstart -k만으로는 재기동 안 돼 gw restart 재실행 필요했음. https://cloud.crowny.org/cloudapi/api/health 200 실측.
- LaunchAgent
org.crowny.cloudapi.plist(cloudpick 패턴 모방, KeepAlive+CROWNY_TCP_LOOPBACK=1) 작성·bootstrap, PORT=9662 상시 구동 확인.
관련 파일
- 본체:
/Users/ef/crowny-services/클라우드관리.한선 / .toau
- 모듈:
/Users/ef/crowny-services/클라우드_{노드,서비스,게이트,가드,백업,체인,배포}.한선
- 게이트웨이:
/Users/ef/crowny-gateway/gateway.yaml (cloud.crowny.org 블록)
- LaunchAgent:
/Users/ef/Library/LaunchAgents/org.crowny.cloudapi.plist
- 로그:
/tmp/crowny-cloudapi.log / .err
- API 스펙 SSOT:
/Users/ef/crowny-services/docs/클라우드관리-API스펙.md
잔여 이슈
백업 모듈 sha256 출력이 65자(정상 64자보다 1자 김) — 기존 클라우드_백업.한선 로직 버그로 추정, 이번 작업 범위 밖(응답은 정상 동작, 값 정밀도만 의심).- 프론트(
public/cloud/index.html) API 배선(S2)·디자인대조(S5)·크라우니AI검증 헤드리스(S6)는 이번 통합 범위 밖(스펙 문서 S10 게이트 1~4만 수행, 5~6 미실시).
- registry.psv 서비스 mem=0 고정(리스너 PID rss 미실측 — 클라우드_서비스.한선 기존 구현 그대로).
최종 마감 (본세션 직접 재검증 — 13:38)
- 디자인이식 diff: 티 (100점, 신규색 0·유실 0) — 초기 "타 43색"은 추출기가 dc.html
:root/ccLive 블록을 못 긁은 오탐. 토큰정본.psv에 원본 dc.html 변수 45색 보강(출처 명기)으로 정직 판정 전환. 도구 개선 필요: unpack 시 스탠드얼론 번들 :root+keyframes 색 추출 보강(별도 작업).
- 라이브 실측: :9662 직결 health/node/guard 200 · 게이트웨이 경유 https://cloud.crowny.org/cloudapi/api/health 200 · 프론트 82.5KB 200 · LaunchAgent org.crowny.cloudapi 상주.
- 백업 sha256 "65자" 이슈 → 오보. 장부값=shasum 실측 완전 일치(64자).
- 학습: 본체 클라우드관리.한선 brain learn 완료(래칫). 가드 모듈은 크로스모듈 참조로 단독컴파일 불가(설계상 정상) — 학습 제외.
- 프론트 잔여(스펙에 API 없어 미배선): 서비스 설정 저장·오늘요청/오류율 통계·실시간 로그 tail. 필요 시 후속 스펙 추가.