[Ncloud] Cloud Functions에 의존성 모듈과 함께 사용하는 가이드

안녕하세요

 

이번 시간에는 Ncloud Cloud Functions에 의존성 모듈과 함께 사용하는 실습을 진행하고자 합니다.

 

1. Cloud Functions 설정

1. Package 생성하기

네이버 클라우드 플랫폼의 Cloud Functions은 기본적으로 Package와 Action의 개념이 있습니다.

 

1) Package

패키지는 단일 또는 다수의 액션을 분류, 관리하는 목적의 단위입니다.
패키지에 포함된 액션에서 공통으로 필요한 값은 디폴트 파라미터를 통해 적용할 수 있습니다.

 

2) Action

Cloud Functions에서 제공하는 리소스 중 패키지와 다양한 타입과 용도의 액션을 생성하여 관리할 수 있습니다. 또한 생성한 액션을 실행하고, 실행 결과에 대해 그래프와 표를 통해 모니터링도 가능합니다.

 

쉽게 생각하면 Package는 Action을 관리하기 위한 디렉토리 Action은 실질적으로 코드를 실행하는 파일이라고 생각해 주시면 됩니다.

 

다음과 같이 Package의 이름을 설정한 후 생성합니다.

 

2. Action 생성하기

다음으로 Action을 생성해주어야 합니다. Action의 경우 다양한 트리거를 통해 실행할 수 있으며 트리거 설정 없이 액션을 만들 수도 있습니다.

 

Action 타입은 기본적으로 일반 액션으로 돌지만 API Gateway와 연동하기 위해서는 웹 액션 혹은 시퀀스 웹 액션을 통해 연동하실 수 있습니다.

 

3. 의존성 모듈 사용하기

https://guide.ncloud-docs.com/docs/cloudfunctions-example-python

위의 네이버 클라우드 공식 가이드에서도 잘 나와 있지만 Cloud Functions을 통해 코드를 개발하다 보면 필요한 의존성 모듈이 생기는데 이 경우 파일 업로드를 통해 main 함수와 함께 모듈을 묶어서 올려주어야 합니다.

 

필요한 모듈과 함께 main 파일을 ZIP으로 압축하면 되는데 이때 main 파일의 파일명은 __main__.py이어야 합니다. Cloud Functions 공식 가이드에서 다음과 같이 안내하고 있습니다.

 

압축 파일명은 상관없이 지정해주셔도 됩니다. Cloud Functions에선 업로드 후 자체적으로 압축 파일명을 변경해서 사용하기 때문에 그 부분은 신경 쓰지 않고 업로드 후 Action을 생성해 주시면 됩니다.

 

4. Action 실행하기

다음과 같이 Action을 실행해볼 수 있습니다. 응답 값은 즉시 받을 수 있으며 실행 성공 여부는 [모니터링] 탭에서 확인하실 수 있습니다.

 

모니터링에서 대부분 실행 에러 메세지를 확인할 수 있지만 상세한 로그 확인은 Cloud Log Analytics에서 가능합니다.

 

Cloud Log Analytics에서는 다음과 같이 Cloud Functions에 대한 에러 로그뿐만 아니라 다양한 로그를 수집해서 로그를 확인할 수 있습니다. 다만 모니터링과 로그를 나눠서 확인해야 하기 때문에 이 부분은 개선되지 않을까 생각합니다.

 

이번 시간에는 Ncloud Cloud Functions에서 의존성 모듈과 함께 사용하는 방법에 대해서 알아봤습니다.

다음 포스팅에서는 Cloud Functions와 API Gateway를 사용하여 서버리스를 구성하는 방법을 알아보겠습니다.

 

감사합니다.