현재 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분 정도 걸립니다. 안내에 따라 OAuth에 사용되는 API 제품, 개발자, 앱을 배포합니다.
- 배포 스크립트가 완료되면 sample-proxies 디렉터리로 이동합니다.
sample-proxies
디렉터리에는 샘플 프록시당 하나의 디렉터리가 있습니다. 각 디렉터리에는 샘플 실행에 관한 정보가 포함된 README.md 파일과 샘플을 약간 변경하고 배포한 다음 호출하여 변경한 효과를 확인하는 데 도움이 되는 스크립트 두 개가 있습니다.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 프록시 동작이 특정 메시지 형식에 따라 달라지므로 프록시에서 추가 구성을 변경해야 할 수도 있습니다.