<div id="readability-page-1" class="page"><div>
 <a href="/m/category/%F0%9F%92%BB%20%ED%94%84%EB%A1%9C%EA%B7%B8%EB%9E%98%EB%B0%8D/node">💻 프로그래밍/node</a><h3>AWS Lambda Nodejs 16.x 지원종료, 18.x 버전업 대응 요약(feat.s3)</h3>
 </div><cite>Fitware Jay</cite>
 2023. 10. 4. 22:16
 <div>
 안녕하세요! 제이입니다! 오늘은 사내에서 사용 중인 AWS Lambda의 Nodejs runtime 버전을 변경하면서 그 과정에 대한 요약과 어떤 점을 수정했는지 일부 요약 해보려고 합니다!

<h2 data-ke-size="size26">1. 버전관리</h2>
<hr contenteditable="false" data-ke-type="horizontalRule" data-ke-style="style5">
기본적으로 우리가 사용하고 있는 언어, 라이브러리, 프레임워크에 대한 지원종료에 대해서 인지하고 있어야 합니다. 저는 백엔드 센터 소속으로서 최근 백엔드에서 사용 중인 기술들에 대한 버전관리 및 업데이트를 진행(중)했습니다.

첫 번째로 저희가 사용 중인 AWS Lambda의 node버전을 체크했습니다. 버전 지원 종료에 대한 내용은 <a href="https://endoflife.date/nodejs" target="_blank" rel="noopener">https://endoflife.date/nodejs</a> 에서 쉽게 확인할 수 있습니다.&nbsp;
(참고: <a href="https://endoflife.date/" target="_blank" rel="noopener">https://endoflife.date/</a> 에는 다양한 언어, 제품에 대한 수명주기를 명시하고 있기 때문에 즐겨찾기 해놓으시면 많은 도움이 되실 거예요!)

<figure data-ke-mobilestyle="widthOrigin" data-origin-width="2236" data-origin-height="1448">
 
 <img src="https://blog.kakaocdn.net/dn/bqUBxl/btswwSKxYvT/AddloQQc7mFdmLNqwqKGEk/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="558" height="361" data-origin-width="2236" data-origin-height="1448">
 
 <figcaption>nodejs 지원에 대한 내용</figcaption>
</figure>
저희는 16.x를 사용 중이었는데 표를 보시다시피 23년도 9월 11일에 보안 지원까지 종료가 되었습니다. 좀 더 일찍 대응을 했으면 좋았을 텐데 그래도 당장 뭐 이슈가 있는 건 아니니 ㅎㅎ (늦었다 생각했을 때가 늦었다)

여하튼 현재 올릴 수 있는 안정된 버전은 18(LTS) 버전입니다. 25년 4월 30일까지 지원기간도 넉넉합니다!

<figure data-ke-mobilestyle="widthOrigin" data-origin-width="2844" data-origin-height="974">
 
 <img src="https://blog.kakaocdn.net/dn/IgX7v/btsw6Z9fFaV/Sc17kJjkyVAP43VkNbIGNk/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';" data-origin-width="2844" data-origin-height="974">
 
 <figcaption>https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html</figcaption>
</figure>
혹시 모르니 Lambda에서 nodejs18.x를 지원하는지도 체크해 줍니다! 확인해 보니 아주 다행히도 지원을 해주고 있었습니다. 다만 변경된 점은 nodejs18.x부터 AWS SDK V3를 사용합니다. (역시 쉬운 게 없습니다)

저희는 AWS SDK의 S3 관련 모듈을 사용하고 있었기 때문에 이 부분에 대한 변경점이 있을 거라 예상하며 적용을 진행했습니다.


<h2 data-ke-size="size26">2. 적용</h2>
<hr contenteditable="false" data-ke-type="horizontalRule" data-ke-style="style5">
저희는 serverless framework라는 툴을 사용하여 lambda 배포를 진행하고 있습니다. 로컬에서는 <a href="https://www.npmjs.com/package/serverless-offline" target="_blank" rel="noopener">serverless offline</a>이라는 라이브러리를 통해서 테스트를 하고 있고요! (진짜 좋습니다!)

기존에 사용하던 AWS SDK V2(<a href="https://www.npmjs.com/package/aws-sdk" target="_blank" rel="noopener">aws-sdk</a>)에서 V3로 변경되면서 패키지 구조와 사용되는 모듈들의 변화가 조금씩 있는 것 같습니다. aws 공식문서에서 V3(js) <a href="https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/javascript_code_examples.html" target="_blank" rel="noopener">code 예제</a>들을 제공하고 있습니다. (참고: <a href="https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/introduction/" target="_blank" rel="noopener">AWSJavascriptSDK V3</a>)

<figure data-ke-mobilestyle="widthOrigin" data-origin-width="3878" data-origin-height="886">
 
 <img src="https://blog.kakaocdn.net/dn/BiV8M/btsw6C0Czx3/Kbl20cHifCysb80onLjRAk/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';" data-origin-width="3878" data-origin-height="886">
 
 <figcaption>https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/introduction/</figcaption>
</figure>
<blockquote data-ke-style="style2">yarn add @aws-sdk/client-s3</blockquote>

SDK v3부터는 각 모듈별로 따로 설치를 하는 것 같습니다. 공식문서에 되게 친절하게 나와있어서 이해하시기 어려운 부분은 없을 거예요! 이런 방식으로 변경된 이유는 패키지 전체 리소스보다 필요한 것만 사용하는게 적기때문이기도 한 것 같습니다. 자세한 내용은 아래 문서를 확인해보시면 좋을 것 같습니다!
<figure id="og_1696425727460" contenteditable="false" data-ke-type="opengraph" data-ke-align="alignCenter" data-og-type="article" data-og-title="Modular packages in AWS SDK for JavaScript | Amazon Web Services" data-og-description="As of December 15th, 2020, the&nbsp;AWS SDK for JavaScript, version 3 (v3) is generally available. On October 19th, 2020, we published the Release Candidate (RC) of the AWS SDK for JavaScript, version 3 (v3). One of the major changes in the JavaScript SDK v3 i" data-og-host="aws.amazon.com" data-og-source-url="https://aws.amazon.com/ko/blogs/developer/modular-packages-in-aws-sdk-for-javascript/" data-og-url="https://aws.amazon.com/blogs/developer/modular-packages-in-aws-sdk-for-javascript/" data-og-image="https://scrap.kakaocdn.net/dn/90j0L/hyT54txOeC/XxtwmFkMVsET68IheboED1/img.jpg?width=1260&amp;height=630&amp;face=0_0_1260_630,https://scrap.kakaocdn.net/dn/d3zmaR/hyT5UEp51B/5T9Zw4QHm6hEWWbWjHq4v0/img.jpg?width=1260&amp;height=630&amp;face=0_0_1260_630,https://scrap.kakaocdn.net/dn/etU3NV/hyT53aiFPe/g14tGreNkjNmCqTXw3XdW1/img.png?width=1024&amp;height=433&amp;face=0_0_1024_433"><a href="https://aws.amazon.com/ko/blogs/developer/modular-packages-in-aws-sdk-for-javascript/" target="_blank" rel="noopener" data-source-url="https://aws.amazon.com/ko/blogs/developer/modular-packages-in-aws-sdk-for-javascript/">

<div>
Modular packages in AWS SDK for JavaScript | Amazon Web Services
As of December 15th, 2020, the&nbsp;AWS SDK for JavaScript, version 3 (v3) is generally available. On October 19th, 2020, we published the Release Candidate (RC) of the AWS SDK for JavaScript, version 3 (v3). One of the major changes in the JavaScript SDK v3 i
aws.amazon.com
</div>
</a><img src="https://scrap.kakaocdn.net/dn/90j0L/hyT54txOeC/XxtwmFkMVsET68IheboED1/img.jpg?width=1260&amp;height=630&amp;face=0_0_1260_630,https://scrap.kakaocdn.net/dn/d3zmaR/hyT5UEp51B/5T9Zw4QHm6hEWWbWjHq4v0/img.jpg?width=1260&amp;height=630&amp;face=0_0_1260_630,https://scrap.kakaocdn.net/dn/etU3NV/hyT53aiFPe/g14tGreNkjNmCqTXw3XdW1/img.png?width=1024&amp;height=433&amp;face=0_0_1024_433"></figure>
v2에서는 getObject, putObject와 같은 형태로 메서드를 제공했었는데 v3부터는 GetObjectCommand,&nbsp; PutObjectCommand와 같은 형태로 메서드를 제공합니다. 단순히 메서드의 형태만 바뀐 게 아니라 데이터를 가져오고 전송하는 형태도 달라졌습니다.
<figure id="og_1696425133186" contenteditable="false" data-ke-type="opengraph" data-ke-align="alignCenter" data-og-type="object" data-og-title="S3.GetObject no longer returns the result as a string · Issue #1877 · aws/aws-sdk-js-v3" data-og-description="Describe the bug I'm using the GetObjectCommand with an S3Client to pull a file down from S3. In v2 of the SDK I can write response.Body.toString('utf-8') to turn the response into a string. In v3 ..." data-og-host="github.com" data-og-source-url="https://github.com/aws/aws-sdk-js-v3/issues/1877#issuecomment-755387549" data-og-url="https://github.com/aws/aws-sdk-js-v3/issues/1877" data-og-image="https://scrap.kakaocdn.net/dn/UQccx/hyT5UEpOOP/g6cN1MU3gVJWva83mj9szk/img.png?width=1200&amp;height=600&amp;face=0_0_1200_600"><a href="https://github.com/aws/aws-sdk-js-v3/issues/1877#issuecomment-755387549" target="_blank" rel="noopener" data-source-url="https://github.com/aws/aws-sdk-js-v3/issues/1877#issuecomment-755387549">

<div>
S3.GetObject no longer returns the result as a string · Issue #1877 · aws/aws-sdk-js-v3
Describe the bug I'm using the GetObjectCommand with an S3Client to pull a file down from S3. In v2 of the SDK I can write response.Body.toString('utf-8') to turn the response into a string. In v3 ...
github.com
</div>
</a><img src="https://scrap.kakaocdn.net/dn/UQccx/hyT5UEpOOP/g6cN1MU3gVJWva83mj9szk/img.png?width=1200&amp;height=600&amp;face=0_0_1200_600"></figure>

v3에서부터는 buffer를 스트리밍 형태로 주고받습니다. 대표로 GetObjectCommand의 사용형태를 확인해 보겠습니다.

<figure data-ke-mobilestyle="widthOrigin" data-origin-width="2252" data-origin-height="1624">
 
 <img src="https://blog.kakaocdn.net/dn/m742o/btsw0hbrpjy/mrxCKt0GyIRKFWlvr5jVk1/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="622" height="449" data-origin-width="2252" data-origin-height="1624">
 
 <figcaption>https://docs.aws.amazon.com/ko_kr/lambda/latest/dg/with-s3-tutorial.html</figcaption>
</figure>
코드를 보시다시피 GetObjectCommand의 결과로 가져온 데이터의 Body의 타입은 StreamingBlobPayloadOutputTypes 입니다. v2에서 getObject로 가져온 값의 body는 buffer였으나 v3부터는&nbsp;buffer가 아니라 stereaming 형태의 타입이며&nbsp; buffer 형태로 가져오기 위해서는 stream을 buffer로 변환해야 합니다.&nbsp;
<h4 data-ke-size="size20">에피소드</h4>
로컬에서 테스를 하면서 약간의 에피소드가 있었는데 nvm으로 node버전을 변경해 가면서 테스트하다 보니 e2e테스트를 위해 띄우는 로컬 서버는 18.x로 띄우고 테스트 실행하는 node 버전은 16.x로 실행하다 보니 자꾸 127.0.0.1:4569 (serverless-offline 주소)를 연결할 수 없다고 뜨는 것이었습니다.ㅎㅎ 
결론적으로는 node버전이 달랐기도 했고 v17.x 부터는 기본적으로 IPv6를 사용하기 때문에 서버가 떠있는데도 연결이 불가능했던 것입니다. 약간 바보 같은 실수이긴 하지만 그래도 나름 얻은 건 있던 것 같습니다 ㅋㅋ
<figure id="og_1696424187421" contenteditable="false" data-ke-type="opengraph" data-ke-align="alignCenter" data-og-type="article" data-og-title="[NodeJs] localhost가 실행되었는데 127.0.0.1 에 접속되지 않는 경우" data-og-description="해결 방법 (결론) 결론부터 말하자면 NodeJs 버전 17 이상부터 서버 실행시 ipv6 프로토콜을 우선적으로 사용하기 때문에 ipv4 프로토콜의 루프백 주소인 127.0.0.1 은 연결이 되지 않는 것이다. 그래서 " data-og-host="stirringdev.tistory.com" data-og-source-url="https://stirringdev.tistory.com/102" data-og-url="https://stirringdev.tistory.com/102" data-og-image="https://scrap.kakaocdn.net/dn/b9cmrN/hyT5W95yvr/7wMm1JLOOlKPyzrqeiiqTK/img.png?width=800&amp;height=471&amp;face=0_0_800_471,https://scrap.kakaocdn.net/dn/1btbt/hyT5T6zK0g/8ReMTCU74Nt5y04vUu7Enk/img.png?width=800&amp;height=471&amp;face=0_0_800_471,https://scrap.kakaocdn.net/dn/rD9Wa/hyT5UdlzQU/kNA0vVXYkXoB9sVB0Gq3rk/img.png?width=1563&amp;height=921&amp;face=0_0_1563_921"><a href="https://stirringdev.tistory.com/102" target="_blank" rel="noopener" data-source-url="https://stirringdev.tistory.com/102">

<div>
[NodeJs] localhost가 실행되었는데 127.0.0.1 에 접속되지 않는 경우
해결 방법 (결론) 결론부터 말하자면 NodeJs 버전 17 이상부터 서버 실행시 ipv6 프로토콜을 우선적으로 사용하기 때문에 ipv4 프로토콜의 루프백 주소인 127.0.0.1 은 연결이 되지 않는 것이다. 그래서
stirringdev.tistory.com
</div>
</a><img src="https://scrap.kakaocdn.net/dn/b9cmrN/hyT5W95yvr/7wMm1JLOOlKPyzrqeiiqTK/img.png?width=800&amp;height=471&amp;face=0_0_800_471,https://scrap.kakaocdn.net/dn/1btbt/hyT5T6zK0g/8ReMTCU74Nt5y04vUu7Enk/img.png?width=800&amp;height=471&amp;face=0_0_800_471,https://scrap.kakaocdn.net/dn/rD9Wa/hyT5UdlzQU/kNA0vVXYkXoB9sVB0Gq3rk/img.png?width=1563&amp;height=921&amp;face=0_0_1563_921"></figure>

<h2 data-ke-size="size26">3. 결론</h2>
<hr data-ke-style="style5" data-ke-type="horizontalRule">
저희는 테스트 케이스를 작성하고 있어서 버전업에 대한 대응이나 리팩토링에 대해 덜 부담스럽게 작업할 수 있었던 것 같습니다. 비즈니스 로직을 작성하는 것도 중요하지만 적절한 시기에 맞추어 유지보수를 위한 버전관리도 정말 중요합니다. 이럴 때 특히 테스트 케이스의 필요성이 더 강조되는 것 같습니다!
아직 버전 관리에 대응해야 하는 프로젝트들이 많지만... 연말인 만큼 이런 것들 후다닥 해치우고 서비스 성장을 위해 달려가야 할 것 같습니다!&nbsp;
 
 
 </div></div>

Jay's Code Factory

안녕하세요! 제이입니다! 오늘은 사내에서 사용 중인 AWS Lambda의 Nodejs runtime 버전을 변경하면서 그 과정에 대한 요약과 어떤 점을 수정했는지 일부 요약 해보려고 합니다!
 
1. 버전관리
기본적으로 우리가 사용하고 있는 언어, 라이브러리, 프레임워크에 대한 지원종료에 대해서 인지하고 있어야 합니다. 저는 백엔드 센터 소속으로서 최근 백엔드에서 사용 중인 기술들에 대한 버전관리 및 업데이트를 진행(중)했습니다.
 
첫 번째로 저희가 사용 중인 AWS Lambda의 node버전을 체크했습니다. 버전 지원 종료에 대한 내용은 https://endoflife.date/nodejs 에서 쉽게 확인할 수 있습니다. 
(참고: https://endoflife.date/ 에는 다양한 언어, 제품에 대한 수명주기를 명시하고 있기 때문에 즐겨찾기 해놓으시면 많은 도움이 되실 거예요!)
 
저희는 16.x를 사용 중이었는데 표를 보시다시피 23년도 9월 11일에 보안 지원까지 종료가 되었습니다. 좀 더 일찍 대응을 했으면 좋았을 텐데 그래도 당장 뭐 이슈가 있는 건 아니니 ㅎㅎ (늦었다 생각했을 때가 늦었다)
 
여하튼 현재 올릴 수 있는 안정된 버전은 18(LTS) 버전입니다. 25년 4월 30일까지 지원기간도 넉넉합니다!
 
혹시 모르니 Lambda에서 nodejs18.x를 지원하는지도 체크해 줍니다! 확인해 보니 아주 다행히도 지원을 해주고 있었습니다. 다만 변경된 점은 nodejs18.x부터 AWS SDK V3를 사용합니다. (역시 쉬운 게 없습니다)
 
저희는 AWS SDK의 S3 관련 모듈을 사용하고 있었기 때문에 이 부분에 대한 변경점이 있을 거라 예상하며 적용을 진행했습니다.
 
 
2. 적용
저희는 serverless framework라는 툴을 사용하여 lambda 배포를 진행하고 있습니다. 로컬에서는 serverless offline이라는 라이브러리를 통해서 테스트를 하고 있고요! (진짜 좋습니다!)
 
기존에 사용하던 AWS SDK V2(aws-sdk)에서 V3로 변경되면서 패키지 구조와 사용되는 모듈들의 변화가 조금씩 있는 것 같습니다. aws 공식문서에서 V3(js) code 예제들을 제공하고 있습니다. (참고: AWSJavascriptSDK V3)
 
yarn add @aws-sdk/client-s3
 
SDK v3부터는 각 모듈별로 따로 설치를 하는 것 같습니다. 공식문서에 되게 친절하게 나와있어서 이해하시기 어려운 부분은 없을 거예요! 이런 방식으로 변경된 이유는 패키지 전체 리소스보다 필요한 것만 사용하는게 적기때문이기도 한 것 같습니다. 자세한 내용은 아래 문서를 확인해보시면 좋을 것 같습니다!
v2에서는 getObject, putObject와 같은 형태로 메서드를 제공했었는데 v3부터는 GetObjectCommand,  PutObjectCommand와 같은 형태로 메서드를 제공합니다. 단순히 메서드의 형태만 바뀐 게 아니라 데이터를 가져오고 전송하는 형태도 달라졌습니다.
 
v3에서부터는 buffer를 스트리밍 형태로 주고받습니다. 대표로 GetObjectCommand의 사용형태를 확인해 보겠습니다.
 
코드를 보시다시피 GetObjectCommand의 결과로 가져온 데이터의 Body의 타입은 StreamingBlobPayloadOutputTypes 입니다. v2에서 getObject로 가져온 값의 body는 buffer였으나 v3부터는 buffer가 아니라 stereaming 형태의 타입이며  buffer 형태로 가져오기 위해서는 stream을 buffer로 변환해야 합니다. 
에피소드
로컬에서 테스를 하면서 약간의 에피소드가 있었는데 nvm으로 node버전을 변경해 가면서 테스트하다 보니 e2e테스트를 위해 띄우는 로컬 서버는 18.x로 띄우고 테스트 실행하는 node 버전은 16.x로 실행하다 보니 자꾸 127.0.0.1:4569 (serverless-offline 주소)를 연결할 수 없다고 뜨는 것이었습니다.ㅎㅎ 
결론적으로는 node버전이 달랐기도 했고 v17.x 부터는 기본적으로 IPv6를 사용하기 때문에 서버가 떠있는데도 연결이 불가능했던 것입니다. 약간 바보 같은 실수이긴 하지만 그래도 나름 얻은 건 있던 것 같습니다 ㅋㅋ
 
3. 결론
저희는 테스트 케이스를 작성하고 있어서 버전업에 대한 대응이나 리팩토링에 대해 덜 부담스럽게 작업할 수 있었던 것 같습니다. 비즈니스 로직을 작성하는 것도 중요하지만 적절한 시기에 맞추어 유지보수를 위한 버전관리도 정말 중요합니다. 이럴 때 특히 테스트 케이스의 필요성이 더 강조되는 것 같습니다!
아직 버전 관리에 대응해야 하는 프로젝트들이 많지만... 연말인 만큼 이런 것들 후다닥 해치우고 서비스 성장을 위해 달려가야 할 것 같습니다!

AWS Lambda Nodejs 16.x 지원종료, 18.x 버전업 대응 요약(feat.s3)

댓글