[Docker] MockServer 사용하기: API 모킹의 간단한 솔루션

ㅁ 들어가며

 오늘은 Docker를 이용해 MockServer를 설정하고 사용하는 방법에 대해 알아보았다. MockServer는 API 응답을 모킹하는 데 매우 유용한 도구로, 개발 및 테스트 과정에서 큰 도움이 된다.

 

ㅁ MockServer란?

 MockServer는 HTTP 요청에 대해 사전 정의된 응답을 제공하는 도구이다. 실제 서버 없이도 API 응답을 시뮬레이션할 수 있어, 프론트엔드 개발이나 테스트 환경 구축에 매우 유용하다.

 

ㅁ Docker로 MockServer 실행하기

docker pull mockserver/mockserver
docker run -d -p 1080:1080 mockserver/mockserver

 

ㅁ 응답 설정하기

# req
curl -X PUT "http://localhost:1080/mockserver/expectation" -d '{
    "httpRequest": {
        "path": "/api/hello"
    },
    "httpResponse": {
        "statusCode": 200,
        "body": "Hello, World!"
    }
}'

# res
[ {
  "httpRequest" : {
    "path" : "/api/hello"
  },
  "httpResponse" : {
    "statusCode" : 200,
    "body" : "Hello, World!"
  },
  "id" : "f7a98617-b33f-4c2f-b7eb-a64bc6c85c3b",
  "priority" : 0,
  "timeToLive" : {
    "unlimited" : true
  },
  "times" : {
    "unlimited" : true
  }
}]

ㅇ MockServer에 응답을 설정하는 방법은 여러 가지가 있지만, 가장 간단한 방법은 curl을 사용하는 것이다.

ㅇ 이 설정은 /api/hello 경로로 오는 요청에 대해 "Hello, World!" 응답을 반환하게 한다.

 

ㅁ 응답 테스트하기

curl http://localhost:1080/api/hello

ㅇ 응답 테스트를 위해 curl 명령어를 실행하면 "Hello, World!"라는 응답을 받는다.

 

 

---

ㅁ MockServer Examples

ㅇ 페이지 이동

• java - mocking scenarios
• java - proxying with a range of libraries
  • Apache Client
  • Google Client
  • Java JDK
  • Jersey
  • Jetty
  • Spring Rest Template
  • Spring Web Client
• node - running mock server, proxying & mocking scenarios
• curl - mocking scenarios

 

ㅁ 마무리

  Docker를 이용한 MockServer 설정은 API 개발 및 테스트 과정을 크게 간소화할 수 있다. 실제 서버가 준비되지 않았거나, 특정 시나리오를 테스트해야 할 때 매우 유용하게 사용할 수 있다.

MockServer의 더 많은 기능과 고급 설정에 대해 알고 싶다면 공식 문서에서 확인 할 수 있다.

 

ㅁ 함께 보면 좋은 사이트

ㅇ baeldung - Introduction to MockServer

ㅇ mockit 으로 구축하는 목업 API 서버

ㅇ Dockerhub- mockserver

ㅇ [JVM] MockServer