[MSA] 스프링 부트 시작하기: 마이크로서비스 구축 기초

msa 스프링부트

스프링 부트(Spring Boot)는 마이크로서비스 아키텍처(MSA)를 빠르게 구현할 수 있도록 설계된 강력한 프레임워크입니다. 이 가이드에서는 스프링 부트로 MSA 환경을 구축하는 방법을 단계별로 설명합니다.

 

---

 

1. 프로젝트 생성: 스프링 이니셜라이저 활용

1.1 Spring Initializr 사용

1. Spring Initializr 접속
2. 프로젝트 설정
   • Project: Maven
   • Language: Java
   • Spring Boot: 최신 안정화 버전 선택
3. 의존성 추가
   • Spring Web: REST API 개발
   • Spring Cloud Config: 중앙 설정 관리
   • Eureka Discovery Client: 서비스 등록/검색

1.2 Maven pom.xml 예시

    org.springframework.boot
    spring-boot-starter-parent
    3.1.0




        org.springframework.boot
        spring-boot-starter-web


        org.springframework.cloud
        spring-cloud-starter-netflix-eureka-client

 

---

 

2. 애플리케이션 진입점: @SpringBootApplication

2.1 메인 클래스 작성

@SpringBootApplication
@EnableDiscoveryClient  // Eureka 클라이언트 활성화
public class UserServiceApplication {
    public static void main(String[] args) {
        SpringApplication.run(UserServiceApplication.class, args);
    }
}

2.2 주요 어노테이션 설명

• @SpringBootApplication: 자동 구성, 컴포넌트 스캔, 설정 클래스 통합
• @EnableDiscoveryClient: 유레카 서버에 서비스 등록

 

---

 

3. 설정 파일 관리: application.yml

3.1 기본 설정 예시

server:
  port: 8081
spring:
  application:
    name: user-service
eureka:
  client:
    service-url:
      defaultZone: http://localhost:8761/eureka  # 유레카 서버 주소

3.2 외부 설정 활용

• @Value 어노테이션:

  @Value("${server.port}")
  private String port;

• @ConfigurationProperties:

  @ConfigurationProperties(prefix = "custom")
  public class CustomConfig {
      private String apiKey;
      // getter/setter
  }

 

---

 

4. MSA 핵심 컴포넌트 구성

4.1 유레카 서버 (서비스 디스커버리)

1. 의존성 추가:
2. org.springframework.cloud spring-cloud-starter-netflix-eureka-server
3. 메인 클래스:
4. @SpringBootApplication @EnableEurekaServer public class EurekaServerApplication { ... }

4.2 API 게이트웨이 (Spring Cloud Gateway)

spring:
  cloud:
    gateway:
      routes:
        - id: user-service
          uri: lb://USER-SERVICE  # 서비스 이름으로 라우팅
          predicates:
            - Path=/api/users/**

4.3 Config Server (중앙 설정 관리)

@SpringBootApplication
@EnableConfigServer
public class ConfigServerApplication { ... }

 

---

 

5. 실행 및 테스트

5.1 실행 가능한 JAR 생성

mvn clean package  # JAR 파일 빌드
java -jar target/user-service-0.0.1-SNAPSHOT.jar  # 실행

5.2 주요 엔드포인트 확인

• 유레카 대시보드: http://localhost:8761
• 서비스 상태 확인: http://localhost:8081/actuator/health

 

---

 

6. 고급 기능 확장

6.1 스프링 부트 액추에이터

    org.springframework.boot
    spring-boot-starter-actuator

• 모니터링 활성화:

  management:
    endpoints:
      web:
        exposure:
          include: health, metrics, info

6.2 OpenFeign을 통한 서비스 통신

@FeignClient(name = "order-service")
public interface OrderServiceClient {
    @GetMapping("/orders/{userId}")
    List getOrders(@PathVariable Long userId);
}

 

---

 

7. 마이크로서비스 아키텍처 구성도

[Client] → [API Gateway] → [User Service]  
                      ↘  → [Order Service]  
                      ↘  → [Payment Service]  
[Eureka Server]  
[Config Server]  

 

---

 

결론

스프링 부트는 의존성 자동 관리, 내장 서버, Actuator 모니터링 등을 통해 MSA 구현을 단순화합니다.
이 가이드를 따라 기본적인 마이크로서비스 환경을 구축한 후, 점진적으로 분산 트레이싱(Zipkin), 회로 차단기(Hystrix) 등의 고급 기능을 추가해보세요.

 

[MSA] 스프링 부트 시작하기

 

스프링 부트와 마이크로서비스 아키텍처(MSA)