현재 Apigee Edge 문서가 표시되고 있습니다.
Apigee X 문서로 이동 정보
이 주제에서는 관리 UI를 사용하여 API 프록시에서 Node.js 애플리케이션을 래핑하는 가장 간단한 방법을 설명합니다.
소개
처음 만든 Node.js 앱은 'Hello World!'로 요청에 응답하는 HTTP 서버였을 것입니다. Apigee Edge에서 Node.js를 사용해 보는 가장 간단한 방법은 매우 유사한 것입니다. 마우스 클릭 몇 번이면 정상적으로 작동하는 프록시 Node.js HTTP 서버가 Edge에서 실행됩니다. 그런 다음 UI의 코드 편집기를 사용하여 Node.js 앱을 수정하고, Node.js 파일을 추가하고, 정책을 추가하는 등의 작업을 할 수 있습니다.
샘플 Hello World! API 프록시
이 섹션에서는 Node.js HTTP 서버와 상호작용하는 Edge API 프록시를 만드는 방법을 설명합니다. Node.js HTTP 서버 코드는 이미 작성되어 있으며 다음의 간단한 단계를 수행하면 자동으로 Edge에 배포됩니다.- 프록시 빌드 마법사에서 Node.js 앱을 선택합니다.
- 다음을 클릭합니다.
- 프록시 빌드 마법사에 따라 다음과 같이 선택합니다.
필드 선택 세부정보 프록시 이름 Nodejs-Hello를 입력합니다. API에 대해 표시되는 이름입니다.프록시 기본 경로 nodejs-hello 입력 소스 'Hello World' 샘플을 선택합니다. 다른 옵션에 관해서는 이 주제의 뒷부분에서 설명합니다. 설명 API에 대한 설명을 입력합니다. 보안 통과 (없음) 통과 (없음)을 선택합니다. 프록시를 통해 간단한 패스를 만듭니다. 가상 호스트 기본값, 보안 기본값을 변경하지 마세요. 가상 호스트에 대해 알아보려면 가상 호스트 (베타) 정보를 참고하세요. 빌드 환경 배포하기 테스트를 선택합니다. - 빌드 및 배포를 클릭합니다.
응답에 새 API 프록시가 성공적으로 생성되어 '테스트' 환경에 배포되었다는 확인이 표시됩니다. - 편집기에서 <proxy name> 프록시 보기를 클릭하여 API 프록시의 세부정보 페이지를 표시합니다.
Hello 프록시 호출
hello 프록시를 호출하면 Node.js 애플리케이션이 자동으로 실행되어 'Hello, World!'로 응답합니다. 별도로 지정하지 않는 한 Node.js 애플리케이션은 test라는 환경에 배포됩니다. 다음은 Curl을 사용한 기본 호출입니다 (myorg를 조직 이름으로 대체).
$ curl http://myorg-test.apigee.net/nodejs-hello
Hello, World!
Node.js 코드 보기 및 수정
API 프록시에 추가된 Node.js 코드를 살펴보겠습니다. Hello World 프록시의 요약 페이지로 이동하여 개발을 클릭합니다.
그러면 코드 편집기가 포함된 Develop(개발) 뷰가 열립니다. 이 페이지에서 직접 코드를 수정할 수 있습니다.
예를 들어 응답을 Hello, World!에서 Hello, Node!와 같은 다른 값으로 변경한 다음 저장을 클릭합니다. 프록시가 저장되고 다시 배포됩니다.
마지막으로 프록시를 다시 호출하여 변경사항을 확인합니다.
$ curl http://myorg-test.apigee.net/nodejs-hello
Hello, Node!
Apigee Edge에서 Node.js 애플리케이션을 실행하는 방법에 대해 자세히 알아보기
모든 Node.js 애플리케이션과 마찬가지로 Apigee Edge에서 실행되는 Node.js 애플리케이션은 단일 제어 스레드에서 실행됩니다. 다른 스레드를 시작하거나 스레드 간에 변수를 동기화할 필요도 없으며 실제로도 가능성도 없습니다. Node.js는 비블로킹 프로그래밍을 시행하므로 스크립트가 무언가를 기다려야 할 때마다 CPU를 포기하고 나중에 알림을 받기 때문에 단일 스크립트는 수천 개의 동시 요청을 지원할 수 있습니다.
Apigee Edge에서 Node.js를 사용하려면 기본 Node.js 스크립트 파일을 지정해야 합니다. 이 스크립트는 수신 요청을 처리하도록 구성되어야 합니다. 일반적으로 http 또는 https 모듈을 사용하거나 클라이언트를 만드는 등의 작업을 통해 요청을 처리합니다. 기본 스크립트가 이 방법으로 구성되지 않으면 배포된 후 기본 스크립트가 실행 및 종료됩니다. Apigee Edge 내에서 각 Node.js 애플리케이션 스크립트는 프록시가 배포될 때 시작되고, 프록시가 배포 취소될 때 중지됩니다. 중간에 새 요청을 기다렸다가 처리합니다. 자세한 내용은 독립형 Node.js 앱 배포의 '가져온 Node.js 파일 호출'을 참조하세요.
다음 단계
파일 시스템에서 직접 독립형 Node.js 애플리케이션을 만들고 배포할 수도 있습니다.
다음 주제인 독립형 Node.js 앱 배포에서는 apigeetool 명령어를 사용하여 명령줄에서 Node.js 앱을 배포하는 방법을 설명합니다.