<div id="readability-page-1" class="page"><div>
                <p><a href="/m/category/JAVA/spring"><span>JAVA/spring</span></a></p><h3>Spring Cloud Netflix Zuul을 바라보며</h3>
              </div><p><cite>Berno</cite>
                <span> 2023. 10. 28. 18:41</span>
              </p><div>
                                <h3 data-ke-size="size23"><b>0. 이 글을 작성하는 이유</b></h3>
<p data-ke-size="size16">회사에서 API Gateway에 Spring Cloud Netflix Zuul이 적용되어 있는데 이게 뭐 하는 놈인지 간단하게 알고 가기 위함(추후 더 자세히 작성되는 글이 올라올 수도..)</p>

<h3 data-ke-size="size23"><b>1. Spring Cloud와 Spring Cloud Zuul</b></h3>
<p data-ke-size="size16">우선 Spring Cloud는 MSA를 구축할 때 도움이 되는 여러 기능들을 제공한다.</p>
<p data-ke-size="size16">Spring Cloud의 프로젝트 안에 다양한 프로젝트들이 존재하는데 그중 Spring Cloud Netflix가 존재한다.</p>
<figure data-ke-mobilestyle="widthOrigin" data-origin-width="1652" data-origin-height="1146">
    <span data-url="https://blog.kakaocdn.net/dn/rZ7DR/btszj42xUpv/qHAB4KKBB58PGusCeZUQ50/img.png" data-lightbox="lightbox" data-alt="https://spring.io/projects/spring-cloud">
        <img src="https://blog.kakaocdn.net/dn/rZ7DR/btszj42xUpv/qHAB4KKBB58PGusCeZUQ50/img.png" onerror="this.onerror=null; this.src='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png'; this.srcset='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png';" width="641" height="445" data-origin-width="1652" data-origin-height="1146">
    </span>
    <figcaption>https://spring.io/projects/spring-cloud</figcaption>
</figure>
<p data-ke-size="size16">Spring Cloud Netflix에는 Zuul이 포함되어 있다.&nbsp;</p>
<figure data-ke-mobilestyle="widthOrigin" data-origin-width="1652" data-origin-height="1146">
    <span data-url="https://blog.kakaocdn.net/dn/b3JBqZ/btszkx4j50d/RDTy3ietoLI7mjLS2d3dVK/img.png" data-lightbox="lightbox" data-alt="https://github.com/Netflix/zuul/wiki">
        <img src="https://blog.kakaocdn.net/dn/b3JBqZ/btszkx4j50d/RDTy3ietoLI7mjLS2d3dVK/img.png" onerror="this.onerror=null; this.src='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png'; this.srcset='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png';" width="557" height="386" data-origin-width="1652" data-origin-height="1146">
    </span>
    <figcaption>https://github.com/Netflix/zuul/wiki</figcaption>
</figure>
<p data-ke-size="size16">정확히는 Spring Cloud Zuul이 아닌 Netflix Zuul이고 이를 Spring Cloud에서 활용한 기술이 활용한 기술이 Spring Cloud Netflix이고 그 안에서 Zuul을 사용하고 있어 Spring Cloud Netflix Zuul이다.</p>

<p data-ke-size="size16">그렇다면 Zuul의 역할은 무엇이고 어떻게 동작하는가?</p>

<h3 data-ke-size="size23"><b>2. Zuul</b></h3>
<p data-ke-size="size16">최초 API의 진입점이 되어 LB, routing, monitoring, security등을 해준다.</p>
<figure data-ke-mobilestyle="widthOrigin" data-origin-width="1174" data-origin-height="765">
    <span data-url="https://blog.kakaocdn.net/dn/bhn2Lx/btszkAfHMzL/Rq3ssjjZW1Yv0YFXL64yK1/img.png" data-lightbox="lightbox" data-alt="https://netflixtechblog.com/announcing-zuul-edge-service-in-the-cloud-ab3af5be08ee">
        <img src="https://blog.kakaocdn.net/dn/bhn2Lx/btszkAfHMzL/Rq3ssjjZW1Yv0YFXL64yK1/img.png" onerror="this.onerror=null; this.src='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png'; this.srcset='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png';" width="685" height="446" data-origin-width="1174" data-origin-height="765">
    </span>
    <figcaption>https://netflixtechblog.com/announcing-zuul-edge-service-in-the-cloud-ab3af5be08ee</figcaption>
</figure><figure data-ke-mobilestyle="widthOrigin" data-origin-width="1013" data-origin-height="790">
    <span data-url="https://blog.kakaocdn.net/dn/n3Zl7/btszht9LbBI/kgSlPNAZOpyet4wVJ0RLfk/img.png" data-lightbox="lightbox" data-alt="https://netflixtechblog.com/announcing-zuul-edge-service-in-the-cloud-ab3af5be08ee">
        <img src="https://blog.kakaocdn.net/dn/n3Zl7/btszht9LbBI/kgSlPNAZOpyet4wVJ0RLfk/img.png" onerror="this.onerror=null; this.src='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png'; this.srcset='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png';" width="693" height="540" data-origin-width="1013" data-origin-height="790">
    </span>
    <figcaption>https://netflixtechblog.com/announcing-zuul-edge-service-in-the-cloud-ab3af5be08ee</figcaption>
</figure>
<p data-ke-size="size16">zuul-netflix의 component들에 대해는 아래와 같이 존재한다.</p>
<p data-ke-size="size16">Ribbon : RR방식의 LB기능을 제공한다.</p>
<p data-ke-size="size16">Eureka : 서비스 정보를 Registry에 등록하여 관리할 수 있도록 하는 기능</p>
<p data-ke-size="size16">Archaius : 여러 config 저장소로부터 동적 property를 관리하는 기능</p>
<p data-ke-size="size16">Servo : 모니터링</p>
<p data-ke-size="size16">Hystrix : Circuit Breaker</p>
<p data-ke-size="size16"><s>Astyanax : Deprecated되었습니다</s></p>

<p data-ke-size="size16">zuul에서 제공하는 routes옵션에 대해 간단히 예제를 적어보겠습니다.</p>
<pre id="code_1698485763612" data-ke-language="kotlin" data-ke-type="codeblock"><code>zuul:
	routes:
		address:
			url: "http://host.myaddress.internal:1800"
		delivery:
			url: "http://host.myaddress.internal:1900"</code></pre>
<p data-ke-size="size16">routes 옵션을 통해 특정 path에 대한 url처리를 돕습니다.</p>
<blockquote data-ke-style="style3">format : serviceURI/service_id/~~~~~<br>e.g. http:127.0.0.2/address/123442</blockquote>
<p data-ke-size="size16">위 format에서 service_id를 보고 어디로 던져줄지 결정합니다.</p>
<p data-ke-size="size16">위 예제에서는 address를 service_id로 하여 어디로 던져줄지 결정합니다.</p>
<p data-ke-size="size16">여기서 sensitiveHeaders라는 옵션을 걸 수 있습니다.</p>
<p data-ke-size="size16">쿠키, 세션등의 데이터를 그대로 downstream(routing 당하는 서비스)으로 넘겨줄지 선택할 수 있는 옵션으로</p>
<p data-ke-size="size16">뒤에 값을 비워두면 모든 데이터를 그대로 전달합니다.</p>
<pre id="code_1698485900701" data-ke-language="kotlin" data-ke-type="codeblock"><code>zuul:
	routes:
		address:
			url: "http://host.myaddress.internal:1800"
			sensitiveHeaders:
		delivery:
			url: "http://host.myaddress.internal:1900"
			sensitiveHeaders:</code></pre>

<p data-ke-size="size16">그리고 쿼리 문자열에 대한 옵션이 있습니다.</p>
<blockquote data-ke-style="style3">force-original-query-string-encoding: true</blockquote>
<p data-ke-size="size16">쿼리 문자열 원본 그대로 가져올지 정하는 옵션으로 true로 설정 시 쿼리를 downstream으로 전달하면서 바뀜 없이 그대로 전달합니다.</p>


<h3 data-ke-size="size23"><b>3. 마치며</b></h3>
<p data-ke-size="size16">점점 적응하면서 API Gateway와 spring-cloud 등에 대해 더 자세히 적어보도록 하겠습니다.</p>

<p data-ke-size="size16">ref</p>
<p data-ke-size="size16"><a href="https://techblog.woowahan.com/2523/" target="_blank" rel="noopener&nbsp;noreferrer">https://techblog.woowahan.com/2523/</a></p>
<figure id="og_1698484988548" contenteditable="false" data-ke-type="opengraph" data-ke-align="alignCenter" data-og-type="article" data-og-title="배민 API GATEWAY – spring cloud zuul 적용기 | 우아한형제들 기술블로그" data-og-description="{{item.name}} 서비스를 운영하고 개발하는 팀이라면, LEGACY라는 거대한 괴물이 얼마나 다루기가 힘든 일인지 동감 할 것이다. 이 괴물이 오래되면 될수록, 크면 클수록… 제가 운영하고 개발하고 있" data-og-host="techblog.woowahan.com" data-og-source-url="https://techblog.woowahan.com/2523/" data-og-url="https://techblog.woowahan.com/2523/" data-og-image="https://scrap.kakaocdn.net/dn/bztIez/hyUkiS4GSb/ImrGtPBQQGtNCFM9OZYj8K/img.jpg?width=1640&amp;height=856&amp;face=0_0_1640_856,https://scrap.kakaocdn.net/dn/o4iC5/hyUkaHutj7/GuLwNBOuZaYPAU4byucSNk/img.jpg?width=1640&amp;height=856&amp;face=0_0_1640_856,https://scrap.kakaocdn.net/dn/TNxws/hyUls176Pl/FKK5NkSFzEsXMiFjF5TGR1/img.png?width=1174&amp;height=765&amp;face=0_0_1174_765"><a href="https://techblog.woowahan.com/2523/" target="_blank" rel="noopener" data-source-url="https://techblog.woowahan.com/2523/">

<div>
<p data-ke-size="size16">배민 API GATEWAY – spring cloud zuul 적용기 | 우아한형제들 기술블로그</p>
<p data-ke-size="size16">{{item.name}} 서비스를 운영하고 개발하는 팀이라면, LEGACY라는 거대한 괴물이 얼마나 다루기가 힘든 일인지 동감 할 것이다. 이 괴물이 오래되면 될수록, 크면 클수록… 제가 운영하고 개발하고 있</p>
<p data-ke-size="size16">techblog.woowahan.com</p>
</div>
</a><img src="https://scrap.kakaocdn.net/dn/bztIez/hyUkiS4GSb/ImrGtPBQQGtNCFM9OZYj8K/img.jpg?width=1640&amp;height=856&amp;face=0_0_1640_856,https://scrap.kakaocdn.net/dn/o4iC5/hyUkaHutj7/GuLwNBOuZaYPAU4byucSNk/img.jpg?width=1640&amp;height=856&amp;face=0_0_1640_856,https://scrap.kakaocdn.net/dn/TNxws/hyUls176Pl/FKK5NkSFzEsXMiFjF5TGR1/img.png?width=1174&amp;height=765&amp;face=0_0_1174_765"></figure>
<p data-ke-size="size16"><a href="https://netflixtechblog.com/announcing-zuul-edge-service-in-the-cloud-ab3af5be08ee" target="_blank" rel="noopener&nbsp;noreferrer">https://netflixtechblog.com/announcing-zuul-edge-service-in-the-cloud-ab3af5be08ee</a></p>
<figure id="og_1698485072546" contenteditable="false" data-ke-type="opengraph" data-ke-align="alignCenter" data-og-type="article" data-og-title="Announcing Zuul: Edge Service in the Cloud" data-og-description="the latest addition to Netflix’s Open Source Software suite" data-og-host="netflixtechblog.com" data-og-source-url="https://netflixtechblog.com/announcing-zuul-edge-service-in-the-cloud-ab3af5be08ee" data-og-url="https://netflixtechblog.com/announcing-zuul-edge-service-in-the-cloud-ab3af5be08ee" data-og-image="https://scrap.kakaocdn.net/dn/URoXv/hyUkeJStaj/jd158tudPlmpvkNuk5bwzk/img.png?width=1013&amp;height=790&amp;face=0_0_1013_790,https://scrap.kakaocdn.net/dn/m5Q5K/hyUklWyImE/4YS2KpkjmJpUkKi966snMK/img.png?width=938&amp;height=474&amp;face=0_0_938_474"><a href="https://netflixtechblog.com/announcing-zuul-edge-service-in-the-cloud-ab3af5be08ee" target="_blank" rel="noopener" data-source-url="https://netflixtechblog.com/announcing-zuul-edge-service-in-the-cloud-ab3af5be08ee">

<div>
<p data-ke-size="size16">Announcing Zuul: Edge Service in the Cloud</p>
<p data-ke-size="size16">the latest addition to Netflix’s Open Source Software suite</p>
<p data-ke-size="size16">netflixtechblog.com</p>
</div>
</a><img src="https://scrap.kakaocdn.net/dn/URoXv/hyUkeJStaj/jd158tudPlmpvkNuk5bwzk/img.png?width=1013&amp;height=790&amp;face=0_0_1013_790,https://scrap.kakaocdn.net/dn/m5Q5K/hyUklWyImE/4YS2KpkjmJpUkKi966snMK/img.png?width=938&amp;height=474&amp;face=0_0_938_474"></figure>
<p data-ke-size="size16"><span></span><a href="https://hmj2088.medium.com/zuul-proxy-b32d39f1e738">https://hmj2088.medium.com/zuul-proxy-b32d39f1e738</a></p>
<figure id="og_1698485874639" contenteditable="false" data-ke-type="opengraph" data-ke-align="alignCenter" data-og-type="article" data-og-title="Zuul Proxy" data-og-description="한마디로 정리하면 Api gateway인 동시에 load balancer(ribbon) 역활을 한다고 보면된다." data-og-host="hmj2088.medium.com" data-og-source-url="https://hmj2088.medium.com/zuul-proxy-b32d39f1e738" data-og-url="https://hmj2088.medium.com/zuul-proxy-b32d39f1e738" data-og-image="https://scrap.kakaocdn.net/dn/hilMd/hyUkiZPH0V/34Mf3CI4uRjQh4PkwcKcKk/img.png?width=1174&amp;height=765&amp;face=0_0_1174_765,https://scrap.kakaocdn.net/dn/9JnA5/hyUkjLcSdn/vtIxkbx8OwbkwwAuIT4dTK/img.png?width=989&amp;height=742&amp;face=0_0_989_742,https://scrap.kakaocdn.net/dn/mbd4i/hyUkj5uCkI/K1Skk67MPRRpXDQFBZrpYk/img.png?width=1358&amp;height=359&amp;face=0_0_1358_359"><a href="https://hmj2088.medium.com/zuul-proxy-b32d39f1e738" target="_blank" rel="noopener" data-source-url="https://hmj2088.medium.com/zuul-proxy-b32d39f1e738">

<div>
<p data-ke-size="size16">Zuul Proxy</p>
<p data-ke-size="size16">한마디로 정리하면 Api gateway인 동시에 load balancer(ribbon) 역활을 한다고 보면된다.</p>
<p data-ke-size="size16">hmj2088.medium.com</p>
</div>
</a><img src="https://scrap.kakaocdn.net/dn/hilMd/hyUkiZPH0V/34Mf3CI4uRjQh4PkwcKcKk/img.png?width=1174&amp;height=765&amp;face=0_0_1174_765,https://scrap.kakaocdn.net/dn/9JnA5/hyUkjLcSdn/vtIxkbx8OwbkwwAuIT4dTK/img.png?width=989&amp;height=742&amp;face=0_0_989_742,https://scrap.kakaocdn.net/dn/mbd4i/hyUkj5uCkI/K1Skk67MPRRpXDQFBZrpYk/img.png?width=1358&amp;height=359&amp;face=0_0_1358_359"></figure>

            
            
                </div></div>

흔한 컴공출신 개발자

bernoyoun

0. 이 글을 작성하는 이유
회사에서 API Gateway에 Spring Cloud Netflix Zuul이 적용되어 있는데 이게 뭐 하는 놈인지 간단하게 알고 가기 위함(추후 더 자세히 작성되는 글이 올라올 수도..)
 
1. Spring Cloud와 Spring Cloud Zuul
우선 Spring Cloud는 MSA를 구축할 때 도움이 되는 여러 기능들을 제공한다.
Spring Cloud의 프로젝트 안에 다양한 프로젝트들이 존재하는데 그중 Spring Cloud Netflix가 존재한다.
Spring Cloud Netflix에는 Zuul이 포함되어 있다. 
정확히는 Spring Cloud Zuul이 아닌 Netflix Zuul이고 이를 Spring Cloud에서 활용한 기술이 활용한 기술이 Spring Cloud Netflix이고 그 안에서 Zuul을 사용하고 있어 Spring Cloud Netflix Zuul이다.
 
그렇다면 Zuul의 역할은 무엇이고 어떻게 동작하는가?
 
2. Zuul
최초 API의 진입점이 되어 LB, routing, monitoring, security등을 해준다.
zuul-netflix의 component들에 대해는 아래와 같이 존재한다.
Ribbon : RR방식의 LB기능을 제공한다.
Eureka : 서비스 정보를 Registry에 등록하여 관리할 수 있도록 하는 기능
Archaius : 여러 config 저장소로부터 동적 property를 관리하는 기능
Servo : 모니터링
Hystrix : Circuit Breaker
Astyanax : Deprecated되었습니다
 
zuul에서 제공하는 routes옵션에 대해 간단히 예제를 적어보겠습니다.
zuul:
	routes:
		address:
			url: "http://host.myaddress.internal:1800"
		delivery:
			url: "http://host.myaddress.internal:1900"
routes 옵션을 통해 특정 path에 대한 url처리를 돕습니다.
format : serviceURI/service_id/~~~~~
e.g. http:127.0.0.2/address/123442
위 format에서 service_id를 보고 어디로 던져줄지 결정합니다.
위 예제에서는 address를 service_id로 하여 어디로 던져줄지 결정합니다.
여기서 sensitiveHeaders라는 옵션을 걸 수 있습니다.
쿠키, 세션등의 데이터를 그대로 downstream(routing 당하는 서비스)으로 넘겨줄지 선택할 수 있는 옵션으로
뒤에 값을 비워두면 모든 데이터를 그대로 전달합니다.
zuul:
	routes:
		address:
			url: "http://host.myaddress.internal:1800"
			sensitiveHeaders:
		delivery:
			url: "http://host.myaddress.internal:1900"
			sensitiveHeaders:
 
그리고 쿼리 문자열에 대한 옵션이 있습니다.
force-original-query-string-encoding: true
쿼리 문자열 원본 그대로 가져올지 정하는 옵션으로 true로 설정 시 쿼리를 downstream으로 전달하면서 바뀜 없이 그대로 전달합니다.
 
 
3. 마치며
점점 적응하면서 API Gateway와 spring-cloud 등에 대해 더 자세히 적어보도록 하겠습니다.
 
ref
https://techblog.woowahan.com/2523/
https://netflixtechblog.com/announcing-zuul-edge-service-in-the-cloud-ab3af5be08ee
https://hmj2088.medium.com/zuul-proxy-b32d39f1e738

Spring Cloud Netflix Zuul을 바라보며

댓글