샘플 API 프록시 사용

<ph type="x-smartling-placeholder"></ph> 현재 Apigee Edge 문서를 보고 있습니다.
Apigee X 문서.
정보

기본 요건

http://enterprise.apigee.com에 계정이 필요합니다. 가입 가능 무료 체험 계정: http://accounts.apigee.com/accounts/sign_up.

샘플을 사용하려면 다음 항목도 필요합니다.

도구 설명
Git 샘플은 GitHub에 있습니다. Git이 설치되어 있지 않으면 다음을 참조하세요. GitHub의 Git 설정 안내 Git을 설치하지 않으려면 https://github.com/apigee/api-platform-samples에서 파일을 탐색하고 ZIP을 다운로드하세요.
Python

Apigee 배포 도구를 실행하려면 Python이 필요합니다. Python은 대부분의 Linux에 있습니다. XCode가 설치된 Mac, Cygwin이 설치된 Windows 컴퓨터, 기타 여러 장소에 있는 환경

Python을 얻으려면 Python 다운로드 페이지

curl 샘플 설정 스크립트에서는 curl도 사용합니다. curl가 설치되어 있고 사용할 수 있는지 확인합니다 (which curl 명령어를 실행하여 합니다.
dos2unix Windows에서 Cygwin을 실행하는 경우 dos2unix 유틸리티입니다 Cygwin 설치 프로그램을 사용하면 유틸리티를 설치할 수 있습니다.

샘플 다운로드

샘플 파일을 가져오려면 다음 예시와 같이 git clone를 사용합니다.

git clone https://github.com/apigee/api-platform-samples.git

샘플 API 가져오기 및 배포 프록시

명령줄에서 샘플을 가져오고 배포합니다.

  1. 샘플을 다운로드한 후 다음 예시와 같이 /setup 디렉터리로 이동합니다.
    cd setup
  2. /setup 디렉터리에서 setenv.sh 파일을 찾습니다.
  3. 이 파일을 수정하여 조직, 사용자 이름과 연결된 이메일 주소, 및 API 프록시를 배포할 환경 (프로덕션 또는 테스트)을 결정합니다.
  4. setenv.sh를 수정한 후 다음을 실행합니다.
    sh deploy_all.sh

    이 스크립트는 모든 API 프록시 샘플을 조직에 배포합니다. (3~4시간 정도 minutes.) 표시되는 메시지에 따라 API 제품, 개발자, 앱을 배포합니다. OAuth).

  5. 배포 스크립트가 완료되면 sample-proxies 디렉터리로 이동합니다. sample-proxies 디렉터리를 사용하면 샘플 프록시당 하나의 디렉터리가 표시됩니다. 각 이 디렉터리에는 샘플 실행에 대한 정보가 있는 README.md 파일과 샘플을 약간 변경하고 배포한 다음 호출하여 변경 시 미치는 영향: <ph type="x-smartling-placeholder">
      </ph>
    • invoke.sh: 이 스크립트를 실행하여 API의 배포된 버전을 호출합니다. 사용할 수 있습니다
    • deploy.sh: 원하는 구성을 만든 후 이 스크립트를 실행하여 API 프록시를 배포합니다. 있습니다.

샘플 API 프록시 호출

각 샘플 프록시에는 API 프록시를 호출하는 데 사용할 수 있는 연결된 셸 스크립트가 있습니다. 확인할 수 있습니다

/sample-proxies/proxy_name 디렉터리에서 있습니다.

sh invoke.sh

그러면 조직의 테스트 환경에서 실행 중인 프록시가 호출됩니다.

문제 해결

문제 해결 정보는 다음을 참조하세요.

샘플 API 프록시 수정 및 재사용

샘플 프록시는 일반적으로 수정, 배포, 호출하는 데 사용됩니다. 이렇게 하면 이들이 응답 메시지에 어떤 영향을 미치는지 확인할 수 있습니다.

다른 백엔드 서비스를 가리키도록 샘플 API 프록시를 수정하려면 다음 위치에 있는 XML 구성 파일을 찾을 수 있습니다.

/apiproxy/targets/target_name.xml

예를 들어 자체 백엔드 서비스의 API 키 샘플을 가리키도록 하려면 다음 파일을 찾습니다.

/apikey/apiproxy/targets/default.xml

기본 구성이 http://mocktarget.apigee.net을 가리키는 경우, 예를 들면 다음과 같습니다.

<TargetEndpoint name="default">
  <HTTPTargetConnection>
    <!-- This is where we define the target. For this sample we just use a simple URL. -->
    <URL>http://mocktarget.apigee.net</URL>
  </HTTPTargetConnection>
</TargetEndpoint>

http://api.myproject.com/에서 백엔드 서비스를 사용할 수 있는 경우 다음과 같이 구성을 수정합니다.

<TargetEndpoint name="default">
  <HTTPTargetConnection>
    <!-- This is where we define the target. For this sample we just use a simple URL. -->
    <URL>http://api.myproject.com/</URL>
  </HTTPTargetConnection>
</TargetEndpoint>

변경사항을 저장한 후 다음 예시와 같이 API 프록시를 배포합니다.

sh deploy.sh

다른 API 프록시는 API 프록시 기능을 사용하기 위해 동일한 방식으로 수정할 수 있습니다. 기존 대상 서비스와 비교하여 비용을 절감할 수 있습니다 하지만 경우에 따라 API 프록시 동작은 특정 메시지 형식을 사용하므로 프록시에 추가 구성 변경이 필요할 수 있습니다.