개발 일상 | 백엔드 김승원의 실무 노트

들어가며"주문 API가 간헐적으로 5초 이상 걸린다는데, 어디서 병목인지 모르겠어요." 마이크로서비스 환경에서 이런 문제를 겪으면, 로그만으로는 원인을 찾기가 매우 어렵습니다. 주문 서비스 → 결제 서비스 → 재고 서비스 → 알림 서비스까지, 하나의 요청이 여러 서비스를 거치면서 어느 구간에서 지연이 발생하는지 파악하려면 분산 추적(Distributed Tracing)이 필수입니다.3~7년차 백엔드 개발자라면 Prometheus와 Grafana는 사용해봤겠지만, 분산 추적까지 도입한 경험은 많지 않을 것입니다. OpenTelemetry는 Traces, Metrics, Logs를 하나의 표준으로 통합한 관측 가능성(Observability)의 사실상 표준입니다. CNCF Graduated 프로젝트로, 벤더..

들어가며"Spring Boot 앱을 직접 80 포트로 열면 안 되나요?" 개발 환경에서는 가능하지만, 운영 환경에서는 절대 권장하지 않습니다. SSL 처리, 정적 파일 서빙, 로드 밸런싱, rate limiting, 그리고 보안. 이 모든 것을 애플리케이션 서버 앞에서 처리해주는 것이 바로 Nginx입니다.3~7년차 백엔드 개발자라면 Nginx 설정 파일을 한두 번은 만져봤겠지만, 복사해서 붙여넣기만 하다 보니 정확한 동작 원리를 모르는 경우가 많습니다. location 블록의 매칭 우선순위, upstream의 로드 밸런싱 알고리즘, SSL 설정의 보안 모범 사례 등을 제대로 이해하면 서비스의 안정성과 성능을 한 단계 높일 수 있습니다.이 글에서는 Nginx의 이벤트 기반 아키텍처부터 리버스 프록시, 로..

들어가며"아... force push 했는데 팀원 커밋이 날아갔어요." Git을 사용하면서 한 번쯤 심장이 쿵 내려앉는 순간을 겪어보셨을 겁니다. 혹은 merge 충돌이 200줄 넘게 발생해서 해결하는 데 반나절을 쓴 경험, release 브랜치에 잘못된 커밋이 포함되어 긴급 패치를 해야 했던 경험이 있을 것입니다.Git은 단순한 버전 관리 도구를 넘어서, 팀의 협업 방식과 배포 전략을 결정하는 핵심 인프라입니다. 3~7년차 백엔드 개발자라면 기본적인 add/commit/push는 능숙하지만, 브랜치 전략 선택, rebase와 merge의 올바른 사용, 위기 상황 대응에서는 여전히 불안감을 느끼는 경우가 많습니다.이 글에서는 Git Flow vs Trunk-Based Development 비교, reba..

들어가며"제 로컬에서는 잘 되는데요." 개발자라면 한 번은 들어봤거나 직접 했을 말입니다. PostgreSQL 버전이 다르고, Redis가 설치되어 있지 않고, Kafka 설정이 미묘하게 다릅니다. 새로운 팀원이 합류하면 개발 환경 구축에만 하루 이상을 소비합니다. 이 모든 문제의 해답은 Docker Compose입니다.docker compose up 한 줄이면 Spring Boot 앱이 필요로 하는 모든 인프라가 동일한 환경으로 구동됩니다. 이 글에서는 PostgreSQL, Redis, Kafka, Prometheus, Grafana까지 포함한 풀스택 개발 환경을 docker-compose.yml 하나로 구성하는 방법과, Spring Boot 3.1+의 Docker Compose 자동 인식 기능, 그리..

들어가며"서버가 느린 것 같은데 원인을 모르겠어요", "장애가 발생했는데 언제부터인지 파악이 안 돼요 API Gateway 패턴의 Circuit Breaker와 장애 대응" - 모니터링이 없는 서비스에서 자주 듣는 말입니다. Prometheus와 Grafana는 오픈소스 모니터링의 사실상 표준(de facto standard)으로, CNCF 졸업 프로젝트이기도 합니다. 2026 백엔드 기술 스택에서의 모니터링 선택 이번 글에서는 Prometheus의 아키텍처와 PromQL, Grafana 대시보드 구축, Spring Boot Micrometer 연동, 커스텀 메트릭 작성, AlertManager 알림 설정까지 실전 수준으로 다루겠습니다.1. Prometheus 아키텍처Pull 모델Prometheus는 모..

들어가며인프라를 수동으로 관리하면 환경 간 불일치, 변경 이력 추적 불가, 재현 불가능한 설정 등 수많은 문제에 부딪힙니다. Infrastructure as Code(IaC)는 인프라를 코드로 정의하여 버전 관리, 리뷰, 자동화를 가능하게 합니다.Terraform은 HashiCorp에서 개발한 IaC 도구로, 선언적 문법으로 클라우드 인프라를 정의하고 프로비저닝합니다. AWS, GCP, Azure 등 다양한 프로바이더를 지원하며, 현재 IaC 도구의 사실상 표준입니다.이 글에서는 Terraform의 핵심 개념부터 AWS 실전 인프라 구축 예제까지, 백엔드 개발자가 알아야 할 Terraform 활용법을 정리합니다.Terraform 핵심 개념주요 용어개념설명Provider인프라 플랫폼과의 인터페이스 (AWS..

들어가며이전 글에서 Kubernetes의 핵심 개념인 Pod, Service, Deployment를 살펴봤습니다. 하지만 실제 프로덕션 환경에서 K8s를 운영하려면 더 많은 도구와 개념이 필요합니다.이 글에서는 패키지 매니저 Helm, HTTP 라우팅을 담당하는 Ingress, 트래픽에 따라 자동으로 스케일링하는 HPA, 그리고 안정적인 운영을 위한 Probe, Resource 관리, PDB 등을 Spring Boot 애플리케이션 배포 예제와 함께 다룹니다.Helm - Kubernetes 패키지 매니저Helm은 Kubernetes 애플리케이션의 패키징, 배포, 버전 관리를 위한 도구입니다. 여러 YAML 매니페스트를 하나의 Chart로 묶어 재사용 가능하게 만듭니다.Helm Chart 디렉토리 구조my-..

들어가며컨테이너 기술이 보편화되면서 수십, 수백 개의 컨테이너를 효율적으로 관리하는 오케스트레이션 도구의 필요성이 커졌습니다. Google이 내부에서 15년 이상 사용하던 Borg 시스템의 경험을 바탕으로 만든 Kubernetes(K8s)는 사실상 컨테이너 오케스트레이션의 표준이 되었습니다.이 글에서는 Kubernetes의 아키텍처부터 Pod, Service, Deployment 등 핵심 리소스 개념을 실전 YAML 매니페스트 예제와 함께 정리합니다. 백엔드 개발자가 K8s 환경에서 애플리케이션을 배포하고 운영하기 위해 반드시 알아야 할 내용을 담았습니다.Kubernetes 아키텍처Kubernetes 클러스터는 크게 Control Plane(Master Node)과 Worker Node로 구성됩니다.Co..

들어가며인프라를 코드로 관리하는 IaC(Infrastructure as Code)는 이제 선택이 아닌 필수다. AWS에서 Terraform을 사용하는 사례는 많지만, NCP(Naver Cloud Platform)에서 Terraform을 활용하는 가이드는 상대적으로 부족하다.NCP는 공식적으로 terraform-provider-ncloud를 제공하며, VPC, Server, Load Balancer, NKS(Kubernetes) 등 대부분의 리소스를 Terraform으로 관리할 수 있다. 이 글에서는 NCP에서 Terraform을 활용해 VPC 환경 위에 서버를 배포하는 전체 과정을 실전 코드와 함께 정리한다.1. 사전 준비1-1. NCP API 인증키 발급Terraform이 NCP 리소스를 생성하려면 A..

들어가며현대 소프트웨어 개발에서 CI/CD(Continuous Integration / Continuous Deployment)는 선택이 아닌 필수입니다. 코드를 푸시할 때마다 자동으로 빌드, 테스트, 배포가 이루어지면 개발 생산성이 비약적으로 향상됩니다. 이번 글에서는 GitHub Actions를 활용하여 Spring Boot 프로젝트의 CI/CD 파이프라인을 처음부터 끝까지 구축하는 방법을 다룹니다.1. GitHub Actions 기본 개념GitHub Actions는 GitHub에서 제공하는 CI/CD 플랫폼으로, 리포지토리 내의 .github/workflows/ 디렉토리에 YAML 파일을 작성하여 워크플로우를 정의합니다. 핵심 구성 요소는 다음과 같습니다.Workflow: 자동화된 전체 프로세스. ..