Skip to content
@2026-Softbank-Hackathon-Charlie

2026-Softbank-Hackathon-Charlie

Team Charlie · HopCharlie — SoftBank Hackathon 2026 in Korea 본선 프로젝트

HopCharlie

운영 중인 앱의 이전을 계획하고, 전환 결과를 검증합니다.

AWS·GCP·온프레미스 사이에서 DB와 파일을 동기화하고,
사람이 승인한 계획에 따라 트래픽을 전환하는 관리 플랫폼입니다.

한국어 · English · 日本語

로컬 데모 · 본선 검증 기록 · 기획 의도 · HopCharlie의 제안 · 아키텍처 · 팀 구성원

SoftBank Hackathon 2026 in Korea · 본선 · Team Charlie
Beyond Lock-in을 주제로 운영 중인 앱과 데이터를 다른 환경으로 옮기는 과정을 구현했습니다.

기획 의도

“원본이 요청을 받는 동안 데이터를 옮길 수 있을까요?” “어느 시점에 트래픽을 바꾸고, 실패하면 어디로 돌아가야 할까요?”

운영 중인 앱을 옮기려면 데이터 복사와 요청 전환이 맞물려야 합니다. HopCharlie는 운영자가 이전 계획, 전환 조건, 검증 결과를 한 실행 기록에서 확인하도록 구성했습니다.

기존 이전 과정의 어려움 HopCharlie의 접근
환경이 바뀔 때마다 연결·버전·정책 조건을 확인해야 함 환경 사전 검사와 AI 샌드박스 리허설로 계획의 근거를 모음
복제 중에도 원본 앱에 쓰기가 들어옴 원본이 요청을 처리하는 동안 동기화하고 마지막 쓰기 확인 후 트래픽 전환
실패했을 때 복구 경로와 데이터 손실 여부를 판단하기 어려움 실행 단계별 복구 조건과 데이터 비교·요청 결과를 기록

서비스 기능 · HopCharlie의 제안

AI가 계획을 제안하고, 운영자가 리허설 결과를 확인해 실행을 승인합니다.

기능 사용자가 하는 일 HopCharlie가 제공하는 것
이전 환경 선택 앱과 출발지·목적지 선택 환경, 버전, 용량, 정책 사전 검사
계획과 리허설 AI가 제안한 계획과 근거 확인 임시 CNPG와 합성 데이터를 사용한 격리 리허설
승인과 동기화 계획 검토 및 승인 PostgreSQL WAL 복제와 rclone 파일 복사·비교
트래픽 전환 보류·승격·전환 상태 확인 진행 중인 쓰기를 마무리하고 대상 검증 뒤 단일 쓰기 대상으로 라우팅
결과와 복구 확인 누락·요청 결과·지연과 복구 상태 확인 실행별 리포트, 안전한 시점의 원본 복구 또는 운영자 확인 대기

기본 사용 흐름

  1. 콘솔에서 앱과 이전 방향을 고릅니다.
  2. AI 계획과 리허설 증거를 검토합니다.
  3. 운영자가 계획을 승인하고 실행을 요청합니다.
  4. 동기화 → 쓰기 보류 → 전환의 진행을 확인합니다.
  5. 결과 화면에서 검사 범위와 요청 결과를 확인합니다.

콘솔 화면 보기 · AI 리허설 구현

전체 시스템 아키텍처

AWS에는 관리 EKS와 워크로드 EKS가 따로 있습니다. 관리 EKS는 플랫폼과 배포를 제어하고, 워크로드 EKS는 AWS에 배포된 앱을 실행합니다.

HopCharlie 전체 시스템. 콘솔의 이전 요청은 관리 EKS의 플랫폼 API와 엔진으로, 앱 요청은 트래픽 게이트웨이를 거쳐 별도 AWS 워크로드 EKS·GKE·온프레미스로 전달됩니다.

구성 요소 책임
운영 콘솔 · CLI 환경과 앱 선택, 계획 승인, 이전 진행과 결과 확인
Platform API 정책·환경 검사, 계획·승인·실행 상태 관리, 이벤트 전달
AI Runner · 샌드박스 환경 조사, 계획 생성, 격리 리허설과 근거 제공
Migration Engine · Gateway DB·파일 동기화, 쓰기 보류·배수, 전환과 복구 판단
관측 파이프라인 ClickStack으로 로그·트레이스, Prometheus 계열로 메트릭·알림 수집

게이트웨이는 한 환경만 쓰기 대상으로 선택합니다. WAL은 그 시점의 primary에서 replica로 흐르고, 전환 후 복구는 새 primary의 쓰기를 반영하는 역방향 이전으로 수행합니다.

Archify 탐색용 HTML · 이전 엔진 설계

인프라 아키텍처

HopCharlie 인프라. 공개 ALB와 관리 EKS의 게이트웨이에서 AWS 워크로드 EKS와 Tailscale을 경유한 GKE·온프레미스 k3s로 앱 요청이 전달됩니다.

관리 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 구축 · 온프레미스 요청 검증

기술 스택

HopCharlie 기술 스택. 클라우드·런타임, 개발, 데이터·이전, 배포·프로비저닝, AI·관측 도구를 아이콘으로 정리했습니다.

기술 스택 텍스트로 보기
영역 주요 기술
클라우드·런타임 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 프로필 사진 김동윤 GitHub 프로필 사진 강종욱 GitHub 프로필 사진 박준석 GitHub 프로필 사진 이태훈 GitHub 프로필 사진
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/>보류 유지 · 운영자 확인"]
Loading
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["플랫폼 세션·이벤트 → 콘솔"]
Loading

현재 범위와 다음 목표

구분 내용
본선 시연과 검증 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 기록

종합 E2E 기록 · 엔진 테스트 기록 · 본선 평가 기준

Popular repositories Loading

  1. .github .github Public

    HTML

  2. migration-engine migration-engine Public

    migration-engine

    Go

  3. frontend frontend Public

    frontend

    TypeScript

  4. platform platform Public

    platform API + Traffic gateway

    Go

  5. cli cli Public

    charlie: HopCharlie platform CLI

    Go

  6. infra infra Public

    charlie 플랫폼의 인프라 관련 파일을 저장하고 상태를 설정합니다.

    Python

Repositories

Showing 9 of 9 repositories

Top languages

Loading…

Most used topics

Loading…