📄 Dev Notes

Vite + React + TailwindCSS 프로젝트 구성 가이드

lemon • 2025-08-12 • Frontend, Vite, DevOps

2025년 2월, React 팀은 Create React App(CRA)의 공식 지원 종료를 발표하며, 개발자들에게 Vite, Parcel, RSBuild와 같은 최신 빌드 도구로의 마이그레이션을 권장하고 있습니다. CRA는 오랜 기간 React 입문자들에게 널리 사용되어 왔지만, 설정의 복잡성과 느린 빌드 속도 등의 한계로 인해 점차 대체되고 있습니다. 그중에서도 Vite는 빠른 번들링 속도와 즉각적인 모듈 핫 리로딩(HMR), 그리고 Tailwind CSS와의 뛰어난 통합성으로 많은 개발자들의 선택을 받고 있습니다.

로컬 DNS 서버 구축 및 설정 가이드

lemon • 2025-08-09 • Infrastructure, Networking

이번 글에서는 Ubuntu 22.04 기반 VM 환경에서 로컬 DNS 서버를 구축하고, 다양한 환경(Docker, macOS, 그리고 Ubuntu)에서 이를 설정하는 방법을 정리합니다.

OAuth2 Proxy 설치 및 API 인증 구성 가이드

lemon • 2025-08-07 • Authentication, Security, Kubernetes

OAuth2 Proxy는 Keycloak, Google, GitHub 등 외부 OAuth2 또는 OpenID Connect 제공자를 통해 사용자 인증을 수행하고, 인증된 사용자만 웹 애플리케이션이나 API에 접근할 수 있도록 보호해주는 인증 프록시입니다.

주로 NGINX, Istio, Envoy, Kong과 같은 리버스 프록시나 Ingress Controller와 함께 사용되며, 애플리케이션이 별도의 인증 로직을 구현하지 않아도 외부에서 손쉽게 인증 기능을 구성할 수 있게 해줍니다.

Kubernetes 환경에서 Flyway 사용하기

lemon • 2025-08-06 • DB

Flyway는 데이터베이스 마이그레이션을 자동화하고 관리하기 위한 도구로, SQL 기반 마이그레이션 스크립트를 버전 관리할 수 있으며 애플리케이션 배포 파이프라인과 자연스럽게 통합됩니다. 애플리케이션에 Flyway를 포함하여 Kubernetes에 배포할 경우, 여러 Pod가 동시에 실행되면 DB 테이블 락(table lock) 문제로 인해 마이그레이션 충돌이 발생할 수 있습니다. 이를 방지하기 위해 분산 락(distributed lock)을 사용하여 먼저 시작된 Pod가 다른 Pod의 마이그레이션 완료를 기다리도록 구현할 수 있습니다.

또 다른 접근 방법으로, Flyway 마이그레이션을 애플리케이션에서 완전히 분리하고, Kubernetes 환경에서 Job 리소스로 관리하는 방법이 있습니다. 이 방식은 마이그레이션을 배포와 별도로 한 번만 실행되도록 보장하여, 여러 개의 애플케이션 Pod가 동시에 기동될 때 발생하는 충돌 문제를 근본적으로 해결합니다. 이렇게 Job으로 분리하여 DB 마이그레이션을 실행하면 네트문제로 잠시 실패를 해도 재시도가 가능하며, 애플리케이션과 완전히 분리함으로써 문제 발생 시 대처가 더 용이해집니다.

Kong Gateway 설치 및 API 인증 설정 가이드

lemon • 2025-08-04 • API Gateway, Security

Kong Gateway는 마이크로서비스 아키텍처에서 API 트래픽을 관리하고 보호하기 위한 오픈소스 API Gateway입니다.
로드 밸런싱, 인증, 라우팅, 속도 제한, 로깅, 플러그인 기반 확장성 등을 제공하며, 클라우드 네이티브 환경에 적합한 유연하고 확장 가능한 구조를 갖추고 있습니다.

이번 글에서는 Kubernetes 환경에서 GitOps 방식으로 Kong Gateway를 배포하고, 서비스 등록과 라우팅 구성, 그리고 OIDC 플러그인을 활용한 API 접근 제어까지 단계별로 살펴보겠습니다.