마이크로서비스 디자인 패턴 완벽 가이드

안녕하세요. Spring 개발자를 위한 실전 LLM 서비스 개발 (Part 1) 강의에 새 보충 강의를 추가했습니다. 최근 공개된 TypeSafe AI의 결정 모델 Jev를 Spring Boot 애플리케이션에 연동하는 내용으로, 약 1시간 분량입니다.

왜 추가했나
Section 4에서 entity()로 LLM 응답을 Java 객체로 받는 방법과, 모델이 JSON을 코드펜스로 감싸 파싱이 깨지는 실무 함정을 다뤘습니다. 프롬프트로 부탁하든 entity()로 자동화하든, 결국 LLM에게 형식을 "부탁"하는 방식이라는 한계는 남습니다.
Jev는 접근이 다릅니다. 글을 쓰지 않고, 정해진 보기 중에서 답을 골라 확률과 함께 돌려줍니다. 형식이 구조적으로 보장되는 셈입니다. 같은 입력을 두 방식으로 처리해 보면 "구조화된 출력"을 설계할 때 무엇을 고려해야 하는지가 훨씬 선명해집니다. 그래서 Section 4의 연장선으로 이 내용을 정리했습니다.

무엇을 배우나요

1. Jev와 System One 모델의 개념: 텍스트 대신 "타입이 정해진 결정"을 돌려준다는 것의 의미

2. LLM과 Jev의 차이: 서술형 답안 vs 객관식 답안, 각자 잘하는 일과 못하는 일

3. 세 가지 질문 타입(choice · score · noul)과 /v1/systemone 요청 구조

4. Spring에서 호출하기: RestClient로 Jev API를 호출하고, Java enum으로 보기를 만들어 응답을 타입 안전하게 변환

5. 비교 시연: 같은 영화 리뷰를 entity()와 Jev로 각각 분석해 속도, 형식 오류, 확신도, 일관성 비교

함께 업데이트된 자료

• Section 4 예제 코드(ch4): 리뷰 분석 API 2종(/api/movies/review/llm, /api/movies/review/jev)과 JevClient 추가

• 보충 강의 슬라이드와 교안

• 비교 테스트 스크립트: macOS용 review-compare.sh, Windows용 review-compare.ps1

미리 알아두실 점

• Jev는 Spring AI의 기능이 아니라 TypeSafe AI가 제공하는 별도 외부 서비스입니다. 강의에서도 Spring AI의 ChatClient가 아니라 RestClient로 직접 호출합니다.

• Jev는 현재 얼리 액세스 단계라서 API 키 발급에 대기가 있을 수 있습니다. 예제 코드는 기본적으로 Jev 기능이 꺼져 있어(jev.enabled=false), 키가 없어도 기존 실습은 그대로 진행할 수 있습니다. 키가 없는 분은 영상의 시연을 보시며 개념과 코드 위주로 따라오시면 됩니다.

• 출시 초기 서비스라 이후 가격이나 API가 바뀔 수 있습니다. 변경이 생기면 새 소식으로 다시 안내드리겠습니다.

📌 강의 바로가기: https://inf.run/VVpnV

추가된 강의를 들으시면서 궁금한 점이나 실습 중 막히는 부분이 있으면 댓글로 편하게 남겨주세요. 앞으로도 실무에 바로 쓸 수 있는 내용을 꾸준히 보강하겠습니다.

안녕하세요, 이도원입니다.

"Jenkins 파이프라인은 만들어봤는데, ArgoCD나 GitOps는 개념만 들어봤다."

"dev·staging·production 환경별 배포를 어떻게 설계해야 할지 막막하다."

이런 고민을 하시는 분들을 위해 「Jenkins와 ArgoCD로 배우는 실전 GitOps CI/CD」 강의를 인프런에 오픈했습니다.

이 강의는 이런 점이 다릅니다

• Jenkins 기반의 전통적인 CI/CD를 넘어 ArgoCD 기반 GitOps까지 함께 다룹니다.

• Push 방식(Jenkins)과 Pull 방식(ArgoCD)을 같은 클러스터 위에서 직접 비교합니다. 누군가 kubectl로 수동 변경했을 때 한쪽은 그대로 남고 한쪽은 자동 복구되는 걸 눈으로 확인하고, 롤백과 배포 이력 확인 방식의 차이도 직접 체감합니다.

• 두 방식을 결합해 dev·staging은 Jenkins Push, production은 ArgoCD Pull(수동 Sync 승인)로 나누는 하이브리드 배포 파이프라인을 처음부터 끝까지 만들어봅니다.

• Canary, Blue-Green, RBAC, 승인 절차, 장애 대응, 자동 롤백까지 운영에 필요한 핵심 배포 기술을 실습합니다.

실습 환경

Docker Desktop 하나로 진행합니다. Windows와 macOS 모두 가능하고, AWS 같은 클라우드 계정이나 별도 비용은 필요 없습니다.

이런 분께 추천드립니다

• Jenkins는 써봤지만 ArgoCD/GitOps는 처음인 백엔드·인프라 엔지니어

• Kubernetes 배포를 수동 kubectl apply에서 자동화로 넘어가고 싶은 분

• 배포 승인, 롤백, 감사 추적 같은 운영 요건을 고민하는 DevOps·SRE 담당자

총 러닝타임은 약 10~11시간이며, 실습 자료와 트러블슈팅 가이드도 함께 제공됩니다.

👉 강의 보기: https://inf.run/dEjZE

궁금한 점은 댓글이나 강의 Q&A로 편하게 남겨주세요!

이번에 새롭게 Spring 개발자를 위한 실전 LLM 서비스 개발 (Part 1) 강의를 오픈했습니다. 조금 늦은 감이 없지는 않으나, 자바 개발자들에게 친숙한 Spring framework를 이용하여 LLM 애플리케이션을 개발하는데 필요한 내용을 학습하는 강의로 구성했습니다. 많은 관심 부탁드립니다.

왜 이 강의를 만들었나

요즘 RAG, 벡터 검색, AI 에이전트 같은 키워드는 어디서나 접할 수 있지만, 막상 "Spring Boot 백엔드에 어떻게 붙이는가"를 실무 수준으로 다루는 자료는 많지 않았습니다.

이 강의는 제가 실제 RAG 추천 엔드포인트를 디버깅하며 겪었던 문제 — 문서를 토큰 단위로 청킹했을 때 의미 단위가 깨져 검색 품질이 떨어졌던 경험, 그리고 문단 단위 청킹으로 전략을 바꿔 문제를 해결했던 과정 — 을 그대로 커리큘럼에 녹였습니다. 튜토리얼처럼 정답 코드만 보여주는 게 아니라, "왜 안 되는지 → 어떻게 진단하는지 → 어떻게 고치는지"를 함께 따라가는 방식입니다.

이런 분들께 추천합니다

• Spring Boot 경험은 있지만 LLM/AI 서비스 개발은 처음인 백엔드 개발자

• RAG, 벡터 검색을 튜토리얼이 아니라 실무 프로젝트 수준으로 적용하고 싶은 개발자

• 사내 AI 기능(챗봇, 문서 검색, 추천 등)을 Spring 기반으로 직접 구현해야 하는 실무자

Spring Boot로 REST API를 만들어 본 경험만 있으면 충분합니다. AI/LLM 사전 지식은 필요 없습니다.

무엇을 배우나요

1. Spring AI 핵심 기초 ChatClient 기본 사용법, 구조화된 출력(Structured Output), 스트리밍 응답 구현

2. RAG 파이프라인 구축 벡터 스토어 연동, 문서 청킹 전략 비교와 실전 트러블슈팅, 검색 품질 개선, 프롬프트 설계

3. 도구·멀티모달 확장 MCP(Model Context Protocol)를 활용한 외부 도구 연동, 이미지 등 멀티모달 입력 처리, Dify 연동

4. 서비스 안정화와 실전 프로젝트 가드레일 적용, 신뢰성 있는 서비스 설계, 지금까지 배운 내용을 통합하는 미니 프로젝트

부록으로 AI 코딩 도구와 Ollama 활용법도 함께 다룹니다.

시리즈 안내

이번에 출시한 것은 전체 시리즈의 Part 1입니다. Part 2, 3에서는 더 심화된 아키텍처와 실전 케이스를 다룰 예정이며, 시리즈가 모두 출시되면 전체 패키지 할인도 준비할 계획입니다.

📌 강의 바로가기: https://inf.run/VVpnV

궁금한 점이나 커리큘럼 관련 질문은 댓글로 편하게 남겨주세요. Part 1을 통해 여러분의 Spring 서비스에 LLM을 붙이는 첫걸음을 함께하고 싶습니다.

안녕하세요, 이도원입니다.

이번에 새롭게 Microservice Architecture를 위한 Design Pattern 강의를 오픈하였습니다.

정말이지 너무나도 힘들고 바뻤던 2024년을 뒤로 하고, 새롭게 2025년도 벌써 5월이 지나가고 있네요.

프로젝트에 집필에 강의에 개인사에 여러가지 일들이 많았지만, 그래도 오랬동안 미뤄왔던 강의를 하나 오픈하게 되었습니다.

• Spring Cloud로 개발하는 마이크로서비스 애플리케이션(MSA)

• Jenkins를 이용한 CI/CD Pipeline 구축

• DevOps를 위한 Docker 가상화 기술 (Private Harbor Registry)

• 마이크로서비스 디자인 패턴을 적용한 MSA 애플리케이션 개발

강의에 이어 애플리케이션 구축에 필요한 디자인 패턴에 대한 강의를 준비했습니다. 처음에 "Spring Cloud로 개발하는 마이크로서비스 애플리케이션(MSA) " 강의를 기획할 때, Cloud Native에 대한 기본적인 강의를 완료하고 다음 단계로 디자인 패턴과 실무에 적용해 볼 수 있는 아키텍처들을 통해 웹 서비스를 개발해 보는 강의를 기획했었는데, 생각보다 시간이 오래 걸렸습니다. 그래도 여러가지 패턴을 몇가지 그룹으로 정리해서 강의를 오픈하게 되었으니 많은 관심 바랍니다.

이번 강의에서는 다음과 같은 패턴을 다루고 있습니다.

• API 게이트웨이 (API Gateway): 클라이언트의 모든 요청을 단일 진입점에서 받아 인증, 로깅, 라우팅 등을 처리하는 패턴입니다. 여러 마이크로서비스를 한 곳에서 관리할 수 있습니다.

• 서비스 디스커버리 (Service Discovery): 동적으로 변화하는 서비스 인스턴스들의 위치를 중앙 레지스트리에 등록하고 찾는 패턴입니다. 이를 통해 서비스 간 통신 시 주소를 자동으로 탐색합니다.

• 동기 (Synchronous)& 비동기 (Asynchronous) 통신: 동기 통신은 요청을 보낸 서비스가 응답을 받을 때까지 기다리는 방식으로, 응답이 올 때까지 스레드가 블로킹 됩니다. REST / gRPC / GraphQL API 방식으로 동기 통신을 구현할 수 있습니다. 비동기 통신은 요청을 보낸 서비스가 응답을 기다리지 않고 즉시 다음 작업을 진행하는 방식으로, Kafka와 같은 메시지 브로커를 통해 이벤트를 발행하고, 구독하는 방식으로 통신하게 됩니다.

• 서킷 브레이커 (Circuit Breaker): 한 서비스의 장애가 연쇄적으로 퍼지는 것을 막기 위해 호출을 단락시키는 패턴입니다. 외부 서비스가 불능일 때 일정 시간 호출을 중단하고 빠른 실패(Fail-fast)를 유도합니다.

• 폴백 (Fallback) 처리: 서킷 브레이커 등이 작동했을 때 대비책으로, 대체 응답이나 재시도 로직을 제공하는 패턴입니다. 부분 장애 시 시스템의 탄력성(resilience)을 높여 줍니다.

• 사가 패턴 (Saga): 분산된 서비스들에서 데이터 일관성을 유지하기 위한 분산 트랜잭션 패턴입니다. 각 서비스의 로컬 트랜잭션을 이벤트/메시지로 연결하여 최종 일관성을 보장합니다.

• CQRS & 이벤트 소싱:CQRS(Command Query Responsibility Segregation)는 읽기와 쓰기 모델을 분리하여 확장성을 높이는 패턴이고, 이벤트 소싱(Event Sourcing)은 상태 변경을 이벤트 로그로 저장해 이력 기반으로 상태를 복원하는 패턴입니다. 함께 사용되어 복잡한 비즈니스의 데이터를 관리합니다.

• EDA: Event Driven Architecture는 이벤트의 생성, 감지, 소비 및 사용을 중심으로 시스템을 설계하는 소프트웨어 아키텍처 패턴입니다. 마이크로서비스 애플리케이션들의 구성요소들이 '이벤트'를 통해 서로 통신하고 상호작용하는 방식입니다.

• BFF (Backend for Frontend): 웹, 모바일 등 플랫폼별 특화된 백엔드를 제공하는 패턴입니다. 각 프론트엔드의 요구에 맞는 전용 API 계층을 만들어 효율성과 개발 생산성을 높입니다.

이제 그동안 미뤄왔던, "Spring Cloud로 개발하는 마이크로서비스 애플리케이션(MSA) " 강의를 시작으로, 기존 강의들의 콘텐츠를 업데이트 하려고 합니다. 강의를 오픈한지도 시간이 꽤 흘렀고, 최신 내용으로 다시 만들지 않으면 안되곘다는 생각을 계속 해 왔었는데, 더 늦지 않게 업데이트 하려고 합니다.

강의에 관심을 가져 주신 분들께 다시한번 감사드리며, 질문과 피드백 등 남겨 주시면, 최신을 다해 빠르게 답변드리도록 하겠습니다.

감사합니다.