8초짜리 승인 요청을 비동기 intent로 바꾼 이유
MCP confirm이 Tomcat 요청 스레드를 붙잡던 구조를 접수·상태 조회로 분리하고, 서로 다른 승인 action이 지워지던 범위 오류까지 함께 고친 기록입니다.
개인 프로젝트
문제 정의부터 구현과 운영까지 직접 책임진 프로젝트의 기록입니다.
↗
단일 노드 운영 cluster를 건드리지 않고 Cilium FQDN egress를 검증한 방법
폐기 가능한 kind lab에서 Pod identity별 toFQDNs와 Hubble drop을 증명하고, production CNI 교체는 명시적으로 보류한 보안 실험입니다.
CloudFront가 앞에 있어도 public ALB를 닫아야 했던 이유
BFF를 먼저 HTTPS entry로 전환한 뒤 AWS 관리형 origin-facing prefix list로 ALB 직접 HTTP 우회 경로를 무중단 차단한 기록입니다.
새 readiness probe와 옛 이미지가 만난 GitOps 교착
GitHub repository redirect는 동작했지만 GHCR owner는 바뀌지 않아, 새 /ready probe와 옛 image의 404가 replacement Pod를 NotReady로 만들고 rollout을 정체시킨 Argo CD 배포 장애입니다.
모든 Pod가 받아야 하는 SSE 이벤트를 Kafka consumer group으로 설계하기
Redis·PostgreSQL 기반 전달에서 Kafka KRaft로 전환하며 broadcast semantics, bean cutover 장애와 broker 중단 복구까지 검증한 기록입니다.
LangGraph SSE에서 node 이름 대신 runnable tag를 신뢰한 이유
mock과 달랐던 실제 event metadata, tool 전 narration 누출과 과거 턴 라우팅 오염을 streaming·message 경계에서 해결한 기록입니다.
LLM이 다운로드 URL을 다시 말하게 하지 않은 이유
LMS ZIP capability link가 최종 응답 전에 사라진 장애를 결정적 terminal formatter, URL allowlist와 안전한 anchor로 해결한 기록입니다.
공간 검색 p95 2.68초에서 인덱스 대신 CPU를 늘린 근거
작은 production read-only 부하와 EXPLAIN을 분리해 공간 query의 CPU 병목과 별도 사용자 조회의 index 누락만 정확히 고친 기록입니다.
좌표는 geometry로 저장하고 미터 검색은 geography로 계산한 이유
Hibernate·bounds 검색 호환성과 정확한 반경·kNN을 함께 얻기 위해 동일 표현식의 GiST 함수 인덱스를 설계한 기록입니다.
API 한 번이 upstream 여섯 번이면 rate limit의 단위는 무엇이어야 하나
정상 좌석 탐색도 429로 막던 제한을 논리 요청이 아닌 실제 upstream fan-out과 사용자 공정성 기준으로 다시 설계한 기록입니다.
JNA와 ZIP 임시 파일이 있는 JVM을 read-only root filesystem으로 운영하기
쓰기 경로를 증거로 분류해 /tmp와 export PVC만 남기고, native library를 사용하는 Spring Pod의 이미지 루트를 읽기 전용으로 만든 기록입니다.
월 1회 수집에 분산락 서비스를 만들지 않은 이유
EventBridge Scheduler Universal Target으로 ECS task를 실행하고, 같은 physical connection의 PostgreSQL advisory lock으로 수동·자동 수집을 직렬화한 기록입니다.
테스트는 통과했는데 운영에서만 Bearer 요청이 401이 된 이유
Auth0용 Spring Security filter chain이 모든 경로를 선점해 다른 JWT를 거부한 운영 장애를 matcher 범위와 production-like 테스트로 해결한 기록입니다.
Set-Cookie 파싱 장애를 일회용 SSO code exchange로 없앤 과정
다중 Set-Cookie와 프록시 경계에서 깨진 로그인 전달을 256-bit 일회용 코드, Redis 원자 소비와 same-origin 교환으로 재설계한 기록입니다.
동일 좌석 100건을 외부 쓰기 1건으로 줄인 예약 큐
비멱등 학교 시스템 쓰기를 Postgres intent, 짧은 claim lease, outbox와 좌석 단위 조정으로 보호한 동시성 설계입니다.
실패한 ECS 배포가 5시간 뒤까지 다음 배포를 막은 이유
shell pipeline의 가려진 exit code, ECS launch backoff, 너무 짧은 health grace를 분리해 자동 rollback을 신뢰할 수 있게 만든 기록입니다.
X-Forwarded-For의 첫 IP를 믿자 rate limit이 무력화됐다
ALB·BFF를 지나는 client IP 신뢰 경계를 재설계하고, 공격자가 만든 key로 rate limiter map이 무한히 커지던 문제까지 막은 기록입니다.
5만 건 공간 데이터 적재를 재실행 가능하게 만든 경계
좌표가 없는 공공 CSV를 geocoding해 PostGIS에 적재하면서 자연키, 증분 저장, API 계약 테스트로 운영 재실행을 안전하게 만든 기록입니다.
승인 카드는 떴는데 예약은 실행되지 않은 이유
MCP content block, LangGraph checkpoint fork와 stale action을 차례로 분리해 승인 이후까지 검증 가능한 HITL 상태머신으로 만든 기록입니다.
PDF 70개를 살리기 위해 전체 성공과 실패의 경계를 다시 그린 방법
일반 첨부 4개의 실패가 정상 PDF 70개까지 폐기하던 LMS 내보내기에서 URL 신뢰 경계와 부분 성공 정책을 함께 설계한 기록입니다.
대시보드는 정상인데 알림과 trace가 비어 있던 이유
Prometheus label 계약과 Spring Boot tracing autoconfiguration을 live data에서 역으로 검증해 관측성의 조용한 실패를 고친 기록입니다.
Redis 없이 3개 인스턴스에 실시간 급증을 전달한 방법
PostgreSQL NOTIFY는 무효화 신호로만 쓰고 DB 재조회와 SSE snapshot 복구를 결합해 작은 ECS 서비스의 멀티 인스턴스 실시간 경계를 설계했습니다.
3/3 연결인데 개인 도구가 열리지 않은 이유
웹 로그인, provider credential, MCP session grant를 분리하고 실제 복사 성공만 연결 상태로 인정한 3서비스 인증 장애 기록입니다.
429를 해결하자 비로소 보인 성공 경로의 버그
RAG 임베딩 실패를 RPM이 아닌 TPM 문제로 좁히고, rate limit 뒤에 숨어 있던 Jackson 응답 계약까지 고친 기록입니다.
암호화하지 않은 RDS를 데이터 보존하며 교체한 절차
in-place 변경이 불가능한 RDS storage encryption을 snapshot 복사·복원과 Terraform state 검증으로 수행하고 약 15분의 downtime을 검증한 기록입니다.
GitOps가 Synced인데 StatefulSet은 왜 옛 설정으로 남았나
실패하는 probe와 OOM 설정을 Git에서 고친 뒤에도 non-Ready Pod가 교체되지 않은 Kafka·Tempo 운영 장애 기록입니다.
생존 점수를 SQL과 Java 두 층으로 나눈 이유
PostGIS 집계는 사실을 만들고 순수 함수는 정책을 적용하도록 분리해, 누락 데이터와 가중치 변경을 설명 가능한 점수로 만든 설계입니다.
Testcontainers가 살아 있는데 Spring 테스트가 죽은 이유
클래스 수명 container와 재사용되는 Spring context의 수명 불일치를 해결하고, 예약 worker가 fixture를 훔치던 두 번째 CI flake까지 제거한 기록입니다.
Production Ready인데 본진 주소가 이전 버전을 보여준 이유
Git과 Vercel 배포는 성공했지만 수동 .vercel.app alias가 과거 deployment에 고정돼 있던 문제를 진단하고 rollback 가능한 승격 절차로 바꾼 기록입니다.
CI는 성공했는데 ARM64 k3s가 이전 이미지를 실행한 이유
AMD64 전용 OCI manifest를 시작점으로 build, registry, Git write-back, reconciliation, runtime을 각각 검증하게 된 배포 기록입니다.
기술 블로그를 정적 페이지와 Git 기반 관리자로 나눈 이유
읽는 화면은 정적으로 유지하면서 글·카테고리·초안을 브라우저에서 관리하도록 Astro와 Keystatic의 책임을 나눈 기록입니다.
작업 로그는 GitHub에, 해설은 블로그에 남기는 이유
프로젝트의 모든 변경을 블로그에 복사하지 않고 Issues·작업 로그·ADR·트러블슈팅과 기술 글을 역할에 맞게 연결하는 기록 구조입니다.
PostGIS 공간 검색에서 만료 조건이 인덱스를 무력화할 때
30만 합성 장소와 21만 제보의 실행계획을 비교해, 공간 GiST가 아니라 만료 제보 집계가 병목임을 좁힌 과정입니다.
브라우저에서 MCP 도구까지, 세 서비스의 신원 경계를 맞춘 과정
클라이언트가 주장한 principal을 버리고 서버 검증 subject와 명시 MCP 세션을 분리해 인증된 principal 소유 thread의 IDOR과 조용한 권한 강등을 막은 설계입니다.