운영 중인 앱의 이전을 계획하고, 전환 결과를 검증합니다.
AWS·GCP·온프레미스 사이에서 DB와 파일을 동기화하고,
사람이 승인한 계획에 따라 트래픽을 전환하는 관리 플랫폼입니다.
로컬 데모 · 본선 검증 기록 · 기획 의도 · HopCharlie의 제안 · 아키텍처 · 팀 구성원
SoftBank Hackathon 2026 in Korea · 본선 · Team Charlie
Beyond Lock-in을 주제로 운영 중인 앱과 데이터를 다른 환경으로 옮기는 과정을 구현했습니다.
“원본이 요청을 받는 동안 데이터를 옮길 수 있을까요?” “어느 시점에 트래픽을 바꾸고, 실패하면 어디로 돌아가야 할까요?”
운영 중인 앱을 옮기려면 데이터 복사와 요청 전환이 맞물려야 합니다. HopCharlie는 운영자가 이전 계획, 전환 조건, 검증 결과를 한 실행 기록에서 확인하도록 구성했습니다.
| 기존 이전 과정의 어려움 | HopCharlie의 접근 |
|---|---|
| 환경이 바뀔 때마다 연결·버전·정책 조건을 확인해야 함 | 환경 사전 검사와 AI 샌드박스 리허설로 계획의 근거를 모음 |
| 복제 중에도 원본 앱에 쓰기가 들어옴 | 원본이 요청을 처리하는 동안 동기화하고 마지막 쓰기 확인 후 트래픽 전환 |
| 실패했을 때 복구 경로와 데이터 손실 여부를 판단하기 어려움 | 실행 단계별 복구 조건과 데이터 비교·요청 결과를 기록 |
AI가 계획을 제안하고, 운영자가 리허설 결과를 확인해 실행을 승인합니다.
| 기능 | 사용자가 하는 일 | HopCharlie가 제공하는 것 |
|---|---|---|
| 이전 환경 선택 | 앱과 출발지·목적지 선택 | 환경, 버전, 용량, 정책 사전 검사 |
| 계획과 리허설 | AI가 제안한 계획과 근거 확인 | 임시 CNPG와 합성 데이터를 사용한 격리 리허설 |
| 승인과 동기화 | 계획 검토 및 승인 | PostgreSQL WAL 복제와 rclone 파일 복사·비교 |
| 트래픽 전환 | 보류·승격·전환 상태 확인 | 진행 중인 쓰기를 마무리하고 대상 검증 뒤 단일 쓰기 대상으로 라우팅 |
| 결과와 복구 확인 | 누락·요청 결과·지연과 복구 상태 확인 | 실행별 리포트, 안전한 시점의 원본 복구 또는 운영자 확인 대기 |
기본 사용 흐름
- 콘솔에서 앱과 이전 방향을 고릅니다.
- AI 계획과 리허설 증거를 검토합니다.
- 운영자가 계획을 승인하고 실행을 요청합니다.
- 동기화 → 쓰기 보류 → 전환의 진행을 확인합니다.
- 결과 화면에서 검사 범위와 요청 결과를 확인합니다.
AWS에는 관리 EKS와 워크로드 EKS가 따로 있습니다. 관리 EKS는 플랫폼과 배포를 제어하고, 워크로드 EKS는 AWS에 배포된 앱을 실행합니다.
| 구성 요소 | 책임 |
|---|---|
| 운영 콘솔 · CLI | 환경과 앱 선택, 계획 승인, 이전 진행과 결과 확인 |
| Platform API | 정책·환경 검사, 계획·승인·실행 상태 관리, 이벤트 전달 |
| AI Runner · 샌드박스 | 환경 조사, 계획 생성, 격리 리허설과 근거 제공 |
| Migration Engine · Gateway | DB·파일 동기화, 쓰기 보류·배수, 전환과 복구 판단 |
| 관측 파이프라인 | ClickStack으로 로그·트레이스, Prometheus 계열로 메트릭·알림 수집 |
게이트웨이는 한 환경만 쓰기 대상으로 선택합니다. WAL은 그 시점의 primary에서 replica로 흐르고, 전환 후 복구는 새 primary의 쓰기를 반영하는 역방향 이전으로 수행합니다.
관리 EKS에 플랫폼과 Argo CD를 두고, 앱과 업무 데이터는 실행 환경별로 분리합니다.
- 관리 EKS에 플랫폼 API, 상태 DB, 트래픽 게이트웨이, Argo CD를 배치했습니다.
- AWS 워크로드 EKS에서 앱을 실행하며 CNPG와 S3를 사용했습니다.
- GCP GKE는 독립 실행 환경으로 CNPG와 Cloud Storage를 사용하고, 앱 요청은 Tailscale 경로를 사용했습니다.
- 온프레미스 k3s는 CNPG와 MinIO를 사용했으며, Tailscale을 경유하는 앱 요청과 예약 앱 순방향 이전을 확인했습니다.
- 배포는 빌드 이미지의 digest를 GitOps 선언에 기록하고 Argo CD가 등록된 대상에 동기화하는 흐름입니다.
인프라 README · AWS 환경 Terraform · GKE 구축 · 온프레미스 요청 검증
기술 스택 텍스트로 보기
| 영역 | 주요 기술 |
|---|---|
| 클라우드·런타임 | Amazon EKS·EC2·S3, Google Kubernetes Engine (GKE)·Cloud Storage, K3s, Tailscale |
| 개발 | Go, React, TypeScript, Vite, SSE |
| 데이터·이전 | PostgreSQL WAL, CloudNativePG, rclone, MinIO |
| 배포·프로비저닝 | GitHub Actions, Docker, Terraform, Helm, Argo CD, AWS CodeBuild, Amazon ECR, Artifact Registry |
| AI·샌드박스 | Claude, hopai, Kubernetes 격리 샌드박스 |
| 관측·테스트 | OpenTelemetry, Grafana Alloy, ClickStack, HyperDX, Prometheus, Alertmanager, Langfuse, Go 테스트, Vitest |
Team Charlie · 5명
RnR은 각 팀원이 맡은 주요 역할입니다.
| 구분 | 조서현 | 김동윤 | 강종욱 | 박준석 | 이태훈 |
|---|---|---|---|---|---|
| RnR | Platform · CLI Console · CI/CD Sample App |
Infrastructure · GPU Security · CI/CD |
CNPG · Observability | Migration · DB Map · AI Recommendations |
AI Sandbox Console |
| 프로필 | |||||
| GitHub | @csh1668 | @BusanGukbap | @timbergrizz | @YBSeok | @totorosi |
팀원별 역할 자세히 보기
| 팀원 | Main | Assist |
|---|---|---|
| 조서현 | 플랫폼 API·트래픽 게이트웨이, 앱 배포·Compose 온보딩·CLI, 운영 콘솔 실제 API 연동, 샘플 앱 개발, 플랫폼·콘솔 이미지 게시 자동화 | AI Sandbox, 이전 엔진 연동, 인프라 구성 |
| 김동윤 | GKE·온프레 인프라, GPU 추론 전환, 보안 설계·구축(접근 권한, 네트워크 격리, 취약점 점검), 보안 API·콘솔, 앱 이미지 빌드·게시와 CI 러너 운영 | AWS EKS 구성, 이주 지도·복구 화면, 이전 엔진 안전성 검증, AI Sandbox 검증 |
| 강종욱 | AWS 워크로드 DB 기반(CNPG), ClickStack·AWS/GKE 메트릭·Langfuse 관측 구축 | 이전 환경의 CNPG 호환성, Terraform 배포 자동화 |
| 박준석 | 마이그레이션 엔진·롤백·데이터 검증, 3개 환경 DB·파일 이전, 프런트엔드 이주 지도, 근거 기반 AI 이전 추천 | AI Sandbox, 온프레 배포 검증, GPU 추론 품질 검증, 관측 연동 |
| 이태훈 | AI 이전 계획·실제 엔진 샌드박스 리허설, 운영 콘솔의 이전·AI 실행 흐름 | 이전 DB 접근 권한·환경 설정, 앱 관측 API 연동 |
| 저장소 | 포함하는 내용 |
|---|---|
| platform | 플랫폼 API, 상태·승인·감사, 배포 실행기와 트래픽 게이트웨이 |
| migration-engine | CNPG·rclone 어댑터, 이전·복구 상태 머신과 검증 |
| frontend | 운영 콘솔과 로컬 데모 |
| ai-sandbox | AI 도구, Plan 검사, 격리 리허설과 진단 |
| infra | Terraform·Helm, 환경별 인프라·권한·관측 기반 |
| cli | 플랫폼 API를 사용하는 운영 CLI |
시연 앱은 예약 서비스 moimroom-mig입니다. 앱별 배포 선언은 GitOps 저장소에서 관리했습니다.
| 문서 | 확인할 내용 |
|---|---|
| 인프라 구성 · 앱 라우팅 런북 | 관리·워크로드 환경, 연결과 배포 |
| 콘솔 화면과 로컬 데모 | 콘솔 화면, 실제 API 모드와 로컬 시뮬레이션 |
| 이전 엔진 설계 · 쓰기 증거 계약 | 전환·복구 조건, 데이터 대조와 쓰기 측정 범위 |
| AI·샌드박스 · 정책과 동등성 검사 | 격리 리허설, 사람 승인, 정책 검사와 감사 모드 |
| 관측 아키텍처 · 온프레미스 관측 | 신호별 수집 경로와 환경별 준비 상태 |
가동 중 이전과 복구 흐름
flowchart LR
P["승인된 Plan"] --> PRE["precheck · prepare<br/>환경·버전·대상 준비"]
PRE --> SYNC["presync · delta<br/>DB 따라잡기 · 파일 복사<br/>원본 서비스 계속 처리"]
SYNC --> HOLD["fence<br/>쓰기 보류 · 기존 쓰기 drain<br/>최종 LSN · 마지막 파일 동기화"]
HOLD --> GATE["switchover<br/>fence LSN replay · 데이터 비교"]
GATE --> DEMOTE["원본 강등<br/>demotion token 확인"]
DEMOTE --> PROMOTE["대상 승격 요청<br/>쓰기 가능·안정 상태 확인"]
PROMOTE --> APP["필요 시 대상 앱 시작·준비 검사"]
APP --> CUT["cutover<br/>route → release"]
CUT --> CHECK["verify · finalize<br/>행·기록된 쓰기·파일 검증"]
CHECK --> REPORT["실행별 리포트<br/>지연 · 누락 · 검증 범위"]
HOLD -. "승격 요청 전 실패" .-> REVERT["원본 복구 · 쓰기 해제"]
PROMOTE -. "승격 결과 불명확·전환 실패" .-> HALT["halted<br/>보류 유지 · 운영자 확인"]
AI 리허설과 사람 승인 흐름
flowchart LR
REQUEST["콘솔에서 앱·이전 방향 선택"] --> JOB["AI Runner Job"]
JOB --> TOOLS["허용된 도구로 환경 조사<br/>원본 primary·버전·자원 확인"]
TOOLS --> PLAN["Plan · 대상 매니페스트 제안"]
PLAN --> VALID["출력·정책·실행 대상 검사"]
VALID --> SB["격리 namespace<br/>제한된 권한 · 네트워크·자원 경계"]
SB --> RUN["임시 CNPG 원본 + 합성 데이터<br/>실제 엔진 리허설"]
RUN --> RESULT{"리허설 결과"}
RESULT -->|"실패"| DIAG["근거 수집 · AI 진단·수정안"]
DIAG -->|"maxRuns 상한 내 재리허설"| PLAN
RESULT -->|"통과"| REVIEW["Plan revision · 첨부 · 증거<br/>사람 검토·승인"]
REVIEW --> EXEC["승인된 Plan으로 실행 요청"]
JOB -. "도구·판단·리허설 기록" .-> EVENTS["플랫폼 세션·이벤트 → 콘솔"]
| 구분 | 내용 |
|---|---|
| 본선 시연과 검증 | AWS↔GCP DB 리허설, AWS→GCP 운영 앱 수동 전환, GKE→온프레미스 순방향 이전을 기록했습니다. |
| 별도 검증 범위 | 온프레미스 역방향 복구, 전체 쓰기 증거와 세션 정합성, 환경별 관측 연동은 각 실행의 측정 범위를 따릅니다. |
| 재현 안내 | 본선 AWS·GCP 시연 환경은 행사 후 정리했습니다. 콘솔은 로컬 데모에서 열 수 있습니다. |
본선 검증 결과와 측정 범위
| 시나리오 | 확인한 결과 | 근거 |
|---|---|---|
| AWS EKS ↔ GCP GKE DB 리허설 | 테스트 앱에 HTTP 부하를 보내며 DB 이전 양방향 2건이 성공했습니다. 앱 프로세스는 EKS에서 실행했습니다. | 엔진 실행 기록 |
| 운영 예약 앱 · AWS → GCP | 엔진이 전환 중 멈춰 운영자가 수동으로 전환했습니다. 확인한 예약 1,487건과 사진 70장의 누락은 0건이었고, 쓰기 요청 9건이 실패했습니다. | 운영 이전 기록 |
| 운영 예약 앱 · GKE → 온프레미스 | 예약 앱의 순방향 이전 리허설이 성공했습니다. 수집된 커밋 쓰기 기준의 누락 여부는 미측정입니다. | 이전 결과 · 측정 범위 |
| 종합 E2E 검증 | 운영 콘솔 브라우저 검사 10개, 격리 CNPG 이전·복구 4개, MinIO·rclone 파일 검사 10개를 통과했습니다. DB와 파일은 각각 시험했습니다. | 종합 E2E 기록 |
