호스팅된 대상 참조

현재 Apigee Edge 문서를 보고 있습니다.
Apigee X 문서로 이동하세요. 정보

환경 변수 한도

호스팅된 타겟은 호스팅된 타겟 런타임 환경에서 설정할 수 있는 환경 변수의 크기와 수를 제한합니다.

  • 1000: 단일 환경 변수의 최대 길이입니다.
  • 100: 설정할 수 있는 최대 환경 변수 수입니다.

환경 변수 설정에 관한 자세한 내용은 매니페스트 파일을 참고하세요.

애플리케이션 런타임에 설정된 환경 변수

호스팅된 타겟 애플리케이션을 배포하면 다음 환경 변수가 설정되며 런타임에 애플리케이션에서 사용할 수 있습니다.

  • APIGEE_ENVIRONMENT - 호스팅된 대상 프록시가 배포된 환경입니다.
  • APIGEE_ORGANIZATION - Hosted Target 프록시가 배포된 조직입니다.
  • PORT - Hosted Target 애플리케이션이 리슨해야 하는 포트입니다.

시스템 리소스 할당

각 호스팅된 타겟 인스턴스는 다음 리소스를 수신합니다.

  • 메모리 256MB
  • 1.2GHz CPU

확장

이 섹션에서는 사용 중인 Edge 계정 유형에 따라 호스팅된 타겟 애플리케이션이 확장되는 방식을 설명합니다.
  • Apigee Edge 평가판 버전은 프록시당 호스팅된 대상 인스턴스 1개로 제한됩니다.
  • 유료 Apigee Edge 계정은 요청 비율, 응답 지연 시간, 기타 프록시당 애플리케이션 측정항목에 따라 자동 확장을 수신합니다.
  • Apigee Edge의 유료 버전과 체험판 버전에 모두 배포된 호스팅된 대상 앱은 비활성 상태일 때 0으로 확장됩니다. 이 경우 잠시 동안 응답 속도가 느려질 수 있습니다. 알려진 문제도 참고하세요.

매니페스트 파일

호스팅된 애플리케이션을 빌드하고 배포하기 위한 런타임 정보를 수집하기 위해 Edge는 resources/호스팅 디렉터리에서 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 - (선택사항) 호스팅된 타겟 런타임 환경에 설정할 환경 변수(이름/값 쌍) 배열입니다. 이러한 변수는 배포된 호스팅된 대상 앱에서 사용할 수 있습니다.
    • name - 변수 이름입니다.
    • 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의 샘플 호스팅 타겟 애플리케이션

    Apigee는 Node.js로 작성된 호스팅된 대상 애플리케이션과 함께 GitHub에서 샘플 프록시를 제공합니다. 이 저장소를 클론하고 README 안내에 따라 프록시를 배포할 수 있습니다.

    기본 요건

    샘플을 배포하려면 시스템에 두 가지 도구가 설치되어 있어야 합니다.

    • apigeetool: Edge 프록시를 배포하는 명령줄 도구입니다.
    • get_token: apigeetool에 필요한 승인 토큰을 가져오는 명령줄 도구입니다.

    샘플을 로컬에서 테스트하려면 Node.js도 설치되어 있어야 합니다.

    샘플 저장소 가져오기

    1. 브라우저에서 https://github.com/apigee/api-platform-samples로 이동합니다.
    2. 클론 또는 다운로드를 클릭하고 원하는 방법으로 저장소를 로컬 시스템으로 가져옵니다.
    3. cd <설치 디렉터리>/api-platform-samples/doc-samples/hosted-targets로 이동합니다.
    4. 저장소가 다운로드되면 cd 명령어로 샘플 디렉터리로 이동하고 README 안내에 따라 샘플 프록시를 Edge에 배포할 수 있습니다. 배포 명령어는 아래와 같습니다. 표시된 매개변수를 Apigee 계정의 매개변수로 바꾸면 됩니다.
      5. 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 요청보다 조금 더 오래 걸립니다.
    • 배포 오류 - 호스팅된 대상 프록시를 배포할 때 배포 오류가 발생하면 프록시를 다시 배포해 보세요. 경우에 따라 배포가 타임아웃될 수 있으며 다시 배포하면 문제가 저절로 해결됩니다.