<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 가져오기 및 배포 프록시
명령줄에서 샘플을 가져오고 배포합니다.
- 샘플을 다운로드한 후 다음 예시와 같이
/setup
디렉터리로 이동합니다.cd setup
/setup
디렉터리에서setenv.sh
파일을 찾습니다.- 이 파일을 수정하여 조직, 사용자 이름과 연결된 이메일 주소, 및 API 프록시를 배포할 환경 (프로덕션 또는 테스트)을 결정합니다.
setenv.sh
를 수정한 후 다음을 실행합니다.sh deploy_all.sh
이 스크립트는 모든 API 프록시 샘플을 조직에 배포합니다. (3~4시간 정도 minutes.) 표시되는 메시지에 따라 API 제품, 개발자, 앱을 배포합니다. OAuth).
- 배포 스크립트가 완료되면 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 프록시 동작은 특정 메시지 형식을 사용하므로 프록시에 추가 구성 변경이 필요할 수 있습니다.