실제 경험과 인사이트를 AI와 함께 정리한 글
-
Kubernetes에서 특권 포트 피하기: NodePort + iptables 포워딩 패턴실제 경험과 인사이트를 AI와 함께 정리한 글 2025. 10. 27. 14:14
작성일: 2025년 10월 27일카테고리: Kubernetes, Security, Networking난이도: 중급TL;DR문제: Kong Gateway를 80/443 포트에서 실행하려면 root 권한 필요 (보안 위험)해결: NodePort(30080/30443) + iptables 포워딩으로 보안, 고가용성, 무중단 배포 모두 확보핵심: Linux 1024 미만 포트는 root만 바인딩 가능하지만, iptables는 커널 레벨에서 포워딩결과: Pod는 root 없이 실행, 다중 Pod로 HA 구성, Rolling Update 무중단, 외부에서는 80/443으로 접속들어가며imprun.dev는 Kubernetes 기반 서버리스 Cloud Function 플랫폼입니다. API Gateway로 Kong을 운..
-
Kubernetes Gateway API 실전 가이드: Kong Ingress에서 표준 API로 전환하기실제 경험과 인사이트를 AI와 함께 정리한 글 2025. 10. 27. 13:40
작성일: 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 리소스입니다. 하지만 실무에서는 큰 문제가 있습니다.같은 기능, 세 가지..
-
frontend/CLAUDE.md실제 경험과 인사이트를 AI와 함께 정리한 글 2025. 10. 27. 12:02
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 컴..
-
Claude AI와 함께하는 프론트엔드 개발: imprun.dev의 CLAUDE.md 가이드 공개실제 경험과 인사이트를 AI와 함께 정리한 글 2025. 10. 27. 12:00
작성일: 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로 돌아온 이유: 실무 관점의 프레임워크 선택 여정실제 경험과 인사이트를 AI와 함께 정리한 글 2025. 10. 27. 11:59
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..
-
Sequential Thinking MCP: AI의 구조화된 사고 프로세스실제 경험과 인사이트를 AI와 함께 정리한 글 2025. 10. 27. 00:58
작성일: 2025-10-26태그: MCP, Claude Desktop, AI Reasoning, Sequential Thinking, Problem Solving난이도: 초급~중급들어가며imprun.dev는 Kubernetes 기반 서버리스 Cloud Function 플랫폼입니다. 복잡한 아키텍처 설계, 버그 디버깅, 성능 최적화 등 다단계 사고가 필요한 문제를 자주 마주합니다.우리가 마주한 문제:// Claude에게 질문: "Application 모듈 성능을 개선하려면 어떻게 해야 하나요?"// 답변: "다음과 같이 개선할 수 있습니다..."// → 한 번에 여러 방법 제시// → 각 방법의 트레이드오프 설명 부족// → 단계별 검증 과정 없음전통적인 AI 답변의 한계:❌ 일직선 답변: 한 번에 최종 ..
-
Serena MCP: AI 코딩 어시스턴트를 위한 시맨틱 코드 분석 도구실제 경험과 인사이트를 AI와 함께 정리한 글 2025. 10. 26. 23:57
작성일: 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 환경에서의 핵심실제 경험과 인사이트를 AI와 함께 정리한 글 2025. 10. 26. 19:47
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..