Apigee Edge 문서입니다.
Go to the
Apigee X documentation. info
이 주제에서는 관리 UI를 사용하여 API 프록시에서 Node.js 애플리케이션을 래핑하는 가장 간단한 방법을 설명합니다.
소개
처음 만든 Node.js 앱은 요청에 'Hello World!'로 응답하는 HTTP 서버였을 것입니다. Apigee Edge에서 Node.js를 사용해 보는 가장 간단한 방법은 이와 매우 유사한 작업을 하는 것입니다. 몇 번의 마우스 클릭만으로 Edge에서 실행되는 프록시 처리된 Node.js HTTP 서버를 사용할 수 있습니다. 그런 다음 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 프록시가 성공적으로 생성되었으며 '테스트' 환경에 배포되었다는 확인 메시지가 표시됩니다. - 편집기에서 <프록시 이름> 프록시 보기를 클릭하여 API 프록시의 세부정보 페이지를 표시합니다.
hello 프록시 호출
hello
프록시를 호출하면 Node.js 애플리케이션이 자동으로 실행되어 "Hello, World!"로 응답합니다. 달리 지정하지 않는 한 Node.js 애플리케이션은
테스트라는 환경에 배포됩니다. 다음은 Curl을 사용하는 기본 호출입니다 (myorg를 조직 이름으로 대체).
$ curl http://myorg-test.apigee.net/nodejs-hello
Hello, World!
Node.js 코드 보기 및 수정
API 프록시에 추가된 Node.js 코드를 살펴보겠습니다. Hello World 프록시의 요약 페이지로 이동하여 개발을 클릭합니다.
그러면 코드 편집기가 포함된 개발 뷰가 열립니다. 여기에서 코드를 직접 수정할 수 있습니다.
예를 들어 응답을 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 앱을 배포하는 방법을 설명합니다.