이 페이지는 Cloud Translation API를 통해 번역되었습니다.

호스팅된 대상 참조

현재 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
```
  KVM 조회의 범위는 환경으로 지정됩니다. KVM 조직 및 애플리케이션/프록시 범위는 지원되지 않습니다. KVM 값은 Node.js 앱이 시작될 때 KVM에 한 번 삽입됩니다. 나중에 KVM을 수정해도 효과가 없습니다. KVM 옵션을 사용하면 민감한 정보를 프록시 번들 자체에 배치하지 않고 Edge로 암호화된 KVM에 저장할 수 있습니다. 키-값 맵 다루기를 참고하세요.

매니페스트 파일의 예

이 섹션에는 Node.js 애플리케이션의 매니페스트 파일 예가 포함되어 있습니다. 매니페스트 파일은 Hosted Targets 앱을 배포하는 데 필요하며 apiproxy/resources/hosted 디렉터리에 있어야 하며 파일 이름은 app.yaml여야 합니다.

Hosted Targets Node.js 앱에는 node_modules 디렉터리를 포함할 필요가 없습니다. 배포 시 Hosted Targets는 npm install를 실행하여 package.json 파일에 지정된 종속 항목을 가져옵니다.

다음은 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 프록시를 배포할 때 배포 오류가 발생하면 프록시를 다시 배포해 보세요. 경우에 따라 배포가 타임아웃될 수 있으며 다시 배포하면 문제가 저절로 해결됩니다.