현재 Apigee Edge 문서가 표시되고 있습니다.
Apigee X 문서로 이동 정보
환경 변수 한도
호스팅된 대상은 호스팅된 대상 런타임 환경에서 설정할 수 있는 환경 변수의 크기와 수를 제한합니다.
- 1,000: 단일 환경 변수의 최대 길이
- 100개: 설정할 수 있는 최대 환경 변수 수
환경 변수 설정에 관한 자세한 내용은 매니페스트 파일을 참조하세요.
애플리케이션 런타임에 설정된 환경 변수
Hosted Targets 애플리케이션을 배포하면 다음 환경 변수가 설정되고 런타임 시 애플리케이션에서 사용할 수 있습니다.
APIGEE_ENVIRONMENT
- 호스팅된 대상 프록시가 배포되는 환경입니다.APIGEE_ORGANIZATION
- 호스팅된 대상 프록시가 배포된 조직입니다.PORT
- 호스팅된 대상 애플리케이션이 리슨해야 하는 포트입니다.
시스템 리소스 할당
각 Hosted Targets 인스턴스는 다음 리소스를 받습니다.
- 메모리 256MB
- 1.2 GHz CPU
확장
이 섹션에서는 보유한 에지 계정 유형에 따라 Hosted Targets 애플리케이션이 어떻게 확장되는지 설명합니다.- Apigee Edge 무료 체험판 버전은 프록시당 Hosted Targets 인스턴스로 제한됩니다.
- 유료 Apigee Edge 계정은 프록시당 요청 비율, 응답 지연 시간, 기타 애플리케이션 측정항목을 기준으로 자동 확장을 수신합니다.
- Apigee Edge의 유료 및 무료 체험판 버전에 배포된 호스팅된 Targets 앱은 비활성 상태일 때 0으로 조정됩니다. 이 경우 잠시 응답 시간이 느려질 수 있습니다. 알려진 문제도 참고하세요.
매니페스트 파일
호스팅된 애플리케이션을 빌드하고 배포하기 위한 런타임 정보를 수집하기 위해 Edge는 resources/host 디렉터리에서 app.yaml이라는 매니페스트 파일을 찾습니다. 이 파일에는 Hosted Targets 애플리케이션을 빌드하고 배포하는 데 필요한 정보가 포함되어 있습니다.
Manfiest 파일 구문
runtime: node runtimeVersion: version_number command: command_name args: argument_array env: - name: variable_name value: literal_value - name: variable_name valueRef: name: kvm_name key: kvm_value
매니페스트 파일 요소
app.yaml 매니페스트 파일에는 다음 요소가 포함되어 있습니다.
- runtime - (필수) 배포 중인 애플리케이션의 유형을 지정합니다.
node
을 지정해야 합니다. - runtimeVersion - (선택사항) 애플리케이션에서 사용하는 런타임의 버전입니다. 기본값: Node.js LTS (v10.x) 다른 옵션은 Node용 Docker 공식 저장소를 참조하세요.
- command - (선택사항) 애플리케이션을 시작하는 데 사용되는 기본 명령어 외에 실행할 명령어를 지정할 수 있습니다. 기본값:
Node.js=npm
- args - (선택사항) 애플리케이션에 전달할 명령줄 인수의 배열입니다 (표준 YAML 배열 구문으로 지정됨). 일반적으로 기본 명령어에 추가됩니다.
기본값은 start입니다. 예를 들어 기본적으로 Node.js 앱에는
npm start
명령어가 전달됩니다. - env - (선택사항) Hosted Targets 런타임 환경에서 설정할 환경 변수 (이름/값 쌍)의 배열입니다. 이러한 변수는 배포된 Hosted Targets 앱에서 사용할 수 있습니다.
- 이름 - 변수 이름입니다.
- value | valueRef - 두 가지 옵션이 있습니다. 리터럴 값을 설정하거나 키-값 맵에 저장된 값을 참조할 수 있습니다. 키-값 맵은 Edge 환경에 이미 있어야 합니다. 키-값 맵 다루기를 참고하세요.
- 값을 사용하는 경우 변수
name
와 리터럴value
를 지정해야 합니다. 예:runtime: node env: - name: NODE_ENV value: production
- valueRef를 사용하는 경우 이전에 Edge에서 만든 키-값 맵 (KVM)의 이름과 키를 제공해야 합니다.
예:
runtime: node env: - name: DB_ENV value: production - name: DB_PASSWORD valueRef: name: hosted-kvm key: db-password
- 값을 사용하는 경우 변수
매니페스트 파일의 예
이 섹션에는 Node.js 애플리케이션의 매니페스트 파일 예가 포함되어 있습니다. 매니페스트 파일은 Hosted Targets 앱을 배포하는 데 필요하며 apiproxy/resources/hosted
디렉터리에 있어야 하며 파일 이름은 app.yaml
여야 합니다.
다음은 Node.js 앱의 app.yaml
(매니페스트) 파일의 예입니다.
리터럴 환경 변수를 지정하는 예시는 다음과 같습니다.
runtime: node env: - name: NODE_ENV value: production
시작 명령어, 명령줄 인수, 환경 변수를 사용한 예
runtime: node command: ./node_modules/pm2/bin/pm2 env: - name: NODE_ENV value: production args: - app.js
키-값 맵 (KVM) 참조를 지정하는 예시:
KVM 액세스에 관한 자세한 내용은 매니페스트 파일을 참고하세요.
runtime: node env: - name: DB_ENV value: production - name: DB_PASSWORD valueRef: name: hosted-kvm key: db-password
GitHub의 Hosted Targets 애플리케이션 샘플
Apigee는 Node.js로 작성된 Hosted Targets 애플리케이션을 사용하여 GitHub에서 샘플 프록시를 제공합니다. 이 저장소를 클론하고 README의 안내에 따라 프록시를 배포할 수 있습니다.
기본 요건
샘플을 배포하려면 시스템에 두 가지 도구가 설치되어 있어야 합니다.
- apigeetool -- Edge 프록시를 배포하기 위한 명령줄 도구입니다.
- get_token: apigeetool에 필요한 승인 토큰을 가져오는 명령줄 도구입니다.
샘플을 로컬에서 테스트하려면 Node.js도 설치되어 있어야 합니다.
샘플 저장소 가져오기
- 브라우저에서 https://github.com/apigee/api-platform-samples로 이동합니다.
- Clone or download를 클릭하고 원하는 방법으로 저장소를 로컬 시스템으로 가져옵니다.
- cd - <your install dir>/api-platform-samples/doc-samples/host-targets
- 저장소가 다운로드되면 원하는 샘플 디렉터리로 cd 이동하고 README 안내에 따라 샘플 프록시를 Edge에 배포할 수 있습니다. 배포 명령어는 다음과 같습니다. 표시된 매개변수를 Apigee 계정용 매개변수로 바꾸면 됩니다.
get_token && apigeetool deployproxy \ -o YOUR_ORGANIZATION \ -e YOUR_ENVIRONMENT \ --json \ --token "$(< ~/.sso-cli/valid_token.dat)"\ --api NAME_OF_THE_PROXY \ --directory .
예: 샘플 앱 실행
샘플 저장소 클론
cd ~/myhome
git clone https://github.com/apigee/api-platform-samples.git
cd ~/myhome/api-platform-samples/doc-samples/hosted-targets
cd node-hosted-hello
로컬에서 애플리케이션 테스트
이 로컬 테스트를 실행하려면 Node.js가 설치되어 있어야 합니다.
PORT=8081 node apiproxy/resources/hosted/index.js
curl http://localhost:8081
출력 예시:
{"date":"2018-03-12T21:45:22.161Z","msg":"Hello, World!"}
프록시 배포
get_token && apigeetool deployproxy \ -o myorg \ -e test \ --json \ --token "$(< ~/.sso-cli/valid_token.dat)"\ --api node-hosted-hello \ --directory .
배포 테스트
배포를 완료하는 데 몇 분 정도 걸릴 수 있습니다. 배포 오류가 발생하면 배포 명령어를 다시 실행하세요.
curl http://myorg-test.apigee.net/node-hosted-hello
출력 예시:
{"date":"2018-03-23T18:59:18.668Z","msg":"Hello, World!"
알려진 문제
- 네트워크 지연 시간 - 이제 Node.js 애플리케이션이 더 이상 MP의 JVM에서 실행되지 않으므로 MP와 배포 사이에 네트워크 홉이 있습니다. 물론 비용이 발생하겠지만 초기 벤치마크에서는 합리적인 수준 내에 있는 것으로 나타났습니다.
- 느린 API 응답 - 애플리케이션을 실행하는 인프라가 필요에 따라 자동으로 확장됩니다. 즉, 애플리케이션을 실제로 인스턴스 0개로 축소할 수 있습니다. 이 경우 인프라가 요청을 처리하기 위해 인스턴스를 가동하므로 다음 API 요청이 일반적인 API 요청보다 조금 더 오래 걸립니다.
- 배포 오류 - Hosted Targets 프록시를 배포할 때 배포 오류가 발생하면 프록시를 다시 배포해 보세요. 경우에 따라 배포가 타임아웃될 수 있으며 다시 배포하면 문제가 저절로 해결됩니다.