imprun engineering

작성일: 2025년 10월 27일카테고리: Kubernetes, Gateway API, Kong난이도: 중급TL;DR문제: Ingress는 각 컨트롤러마다 다른 annotation 문법을 사용하여 vendor lock-in 발생해결: Kubernetes 표준 Gateway API로 전환하여 포터블하고 명시적인 설정 달성결과: Kong 전용 KongPlugin → 표준 HTTPRoute로 전환 완료핵심: Gateway API는 단순한 리소스 교체가 아닌, Kubernetes 네트워킹의 패러다임 전환배경: Ingress의 파편화 문제Ingress의 현실Kubernetes에서 HTTP 라우팅을 설정하는 가장 일반적인 방법은 Ingress 리소스입니다. 하지만 실무에서는 큰 문제가 있습니다.같은 기능, 세 가지..

imprun.dev Console 개발 가이드새로운 세션에서도 일관된 개발을 위한 프론트엔드 아키텍처 및 코딩 규칙목차기술 스택아키텍처 패턴프로젝트 구조페이지 작성 규칙컴포넌트 작성 규칙Hooks 패턴타입 시스템스타일링 & 디자인 시스템 ⭐API 서비스 패턴새 기능 추가 가이드코드 리뷰 체크리스트기술 스택CoreReact 19: UI 라이브러리react-router-dom v6: 클라이언트 사이드 라우팅TypeScript: strictNullChecks: false, noImplicitAny: falseVite: 빌드 도구상태 관리Zustand: 전역 상태 (auth, ui)TanStack Query v5: 서버 상태 관리UITailwind CSS v4: 유틸리티 기반 스타일링shadcn/ui: UI 컴..

작성일: 2025년 10월 27일프로젝트: imprun.dev (Kubernetes 기반 서버리스 Cloud Function 플랫폼)키워드: Claude AI, 프론트엔드 아키텍처, 개발 가이드, Container/Presentational Pattern, Layered Architecture들어가며imprun.dev는 Kubernetes 기반 서버리스 Cloud Function 플랫폼입니다. 프론트엔드를 개발하면서 Claude AI와 협업하는 과정에서, 새 세션마다 코딩 스타일이 달라지는 문제에 직면했습니다.우리가 겪은 문제:❌ 새 세션마다 다른 패턴: useQuery → useState, Service Layer 생략 등❌ 프레임워크 변경 시 (Next.js → React Router) 일관성 상실❌..

Next.js를 버리고 순수 React로 돌아온 이유: 실무 관점의 프레임워크 선택 여정작성일: 2025년 10월 27일키워드: Next.js, React Router, 프론트엔드 아키텍처, Docker 배포, 환경 변수 관리, K8s들어가며imprun.dev는 Kubernetes 기반 서버리스 Cloud Function 플랫폼입니다. ARM64 클러스터(노드당 4 cores, 24GB)에서 운영하면서, Next.js App Router의 리소스 사용량이 심각한 병목이 되었습니다.우리가 겪은 문제:❌ Next.js 런타임 메모리: 768MB (nginx + React는 30MB)❌ 빌드 시간: 5분 (Vite는 1분)❌ 환경 변수: 빌드 타임에 고정되어 환경별 이미지 필요✅ React Router DOM..

작성일: 2025-10-26태그: MCP, Claude Desktop, AI Reasoning, Sequential Thinking, Problem Solving난이도: 초급~중급들어가며imprun.dev는 Kubernetes 기반 서버리스 Cloud Function 플랫폼입니다. 복잡한 아키텍처 설계, 버그 디버깅, 성능 최적화 등 다단계 사고가 필요한 문제를 자주 마주합니다.우리가 마주한 문제:// Claude에게 질문: "Application 모듈 성능을 개선하려면 어떻게 해야 하나요?"// 답변: "다음과 같이 개선할 수 있습니다..."// → 한 번에 여러 방법 제시// → 각 방법의 트레이드오프 설명 부족// → 단계별 검증 과정 없음전통적인 AI 답변의 한계:❌ 일직선 답변: 한 번에 최종 ..

작성일: 2025-10-26태그: MCP, Claude Desktop, AI Coding, Semantic Analysis, Developer Tools난이도: 중급들어가며imprun.dev는 Kubernetes 기반 서버리스 Cloud Function 플랫폼입니다. pnpm monorepo 구조로 server(NestJS), frontend(Next.js 15), packages, services, runtimes 등 수백 개의 파일이 복잡하게 얽힌 코드베이스를 관리하고 있습니다.우리가 마주한 문제:// Claude에게 질문: "Application 모델은 어디에 정의되어 있나요?"// 답변: "먼저 코드베이스를 검색해보겠습니다..."// → 수십 개의 파일을 읽고, 검색하고, 분석하는 과정 반복// ..

Cilium devices 파라미터 완벽 가이드: Tailscale 환경에서의 핵심작성일: 2025-10-24환경: Kubernetes 1.34, Cilium 1.18.2, Tailscale/Headscale, Oracle Cloud난이도: 고급핵심: devices 파라미터 하나가 모든 네트워크 통신을 좌우한다들어가며imprun.dev는 Kubernetes 기반 서버리스 Cloud Function 플랫폼입니다. Tailscale 메시 네트워크 위에 Cilium CNI를 구축하면서, Pod 간 통신은 되는데 외부 통신이 안 되는 기이한 문제에 직면했습니다.우리가 겪은 문제:✅ Pod 간 통신 정상 (10.244.x.x)❌ 외부 인터넷 통신 불가 (DNS 조회 실패, apt update 실패)❌ device..

Kubernetes Pod Security Standards: nginx-unprivileged로 보안 강화하기작성일: 2025-10-26태그: Kubernetes, Security, nginx, Pod Security Standards, Best Practices난이도: 중급들어가며imprun.dev는 Kubernetes 기반 서버리스 Cloud Function 플랫폼입니다. Web Console을 React 19 SPA로 마이그레이션하면서, Kubernetes Pod Security Standards: Restricted 수준을 달성하기 위해 nginx 컨테이너를 완전한 non-root로 전환했습니다.우리가 마주한 질문:❓ 일반 nginx 이미지: Worker는 non-root인데, Master가 r..

5단계: 실전 경험과 아키텍처 결정 배경시리즈: Oracle Cloud + Tailscale + Kubernetes 완벽 가이드← 이전: 4단계: 네트워킹 심화 이해 | 처음으로: README며칠간의 삽질에서 얻은 교훈 - "다음에는 이렇게 하지 말자"📋 이 문서의 목적이 가이드의 최종 아키텍처는 처음부터 완벽하게 설계된 것이 아닙니다.여러 번의 시도와 실패를 거쳐 현재의 구성에 도달했습니다.왜 이 문서가 필요한가?실패한 방법을 기록하여 같은 함정에 빠지지 않도록아키텍처 결정의 배경과 근거 공유"왜 이렇게 했나?"에 대한 솔직한 답변전체 여정 타임라인graph TD Start[목표: Tailscale + Kubernetes 클러스터] --> Attempt1{시도 1: Tailscale in K8s..

4단계: 네트워킹 심화 이해시리즈: Oracle Cloud + Tailscale + Kubernetes 완벽 가이드← 이전: 3단계: Kubernetes + Cilium 구축 | 다음: 5단계: 실전 경험과 교훈 →Tailscale + Cilium 네트워킹 스택의 동작 원리 완벽 분석📋 이 문서의 목적Kubernetes 클러스터가 정상 동작한다면, 이제 왜 이렇게 구성했는지 이해할 차례입니다.패킷이 어떻게 흐르는지, 각 구성요소가 어떤 역할을 하는지 깊이 있게 살펴봅니다.🏗️ 전체 네트워킹 스택┌──────────────────────────────────────────────┐│ Application Layer ││ (..