현재 Apigee Edge 문서가 표시되고 있습니다.
Apigee X 문서로 이동 정보
이 주제에서는 명령줄에서 프록시를 배포하는 방법을 설명합니다. Apigee Edge는 명령줄에서 배포하는 두 가지 옵션을 제공합니다. 첫 번째 방법은 Python으로 작성된 Apigee Edge 배포 도구를 사용하는 것입니다. 또 다른 방법은 셸 스크립트를 구성하고 실행하는 것입니다.
시스템에서 프록시 소스 파일로 직접 작업할 때는 명령줄 배포 기법을 사용합니다. 오프라인으로 작업하는 데에는 여러 가지 이유가 있습니다. 선호하는 XML 편집기를 사용하거나 자바 코딩이 필요한 정책을 개발하며 주로 IDE에서 작업하고 있을 수 있습니다. 이 섹션에 설명된 기법을 사용하면 선택한 API 서비스 환경에 소스 파일을 업로드하고 배포할 수 있습니다.
주로 관리 UI에서 작업하는 경우 UI에서 프록시 배포를 참고하세요.
Apigee Edge 문서를 보고 있습니다.
Apigee X 문서로 이동하세요. 정보
Apigee Edge Python 배포 도구 실행
Apigee Edge Python 배포 도구는 Edge 관리 API와 함께 작동하여 API 프록시를 가져오고 배포합니다. 이 도구는 GitHub에서 API 플랫폼 샘플 배포의 일부로 사용할 수 있습니다. 샘플 API 프록시 사용을 참조하세요.
Apigee Edge Python 도구를 사용하여 간단한 한 번의 프로세스로 API를 가져오고 (업로드) 배포할 수 있습니다.
배포 도구는 API 플랫폼 샘플 배포의 기본 디렉터리에서 실행되어야 합니다. 여기서 기본 디렉터리는 setup 및 tools 디렉터리의 상위 디렉터리입니다.
다음 명령어에서 프록시 이름, Edge 사용자 이름 및 비밀번호, Edge 조직 및 환경, API 프록시의 "apiproxy" 디렉터리가 포함된 디렉터리의 경로를 대체합니다.
python tools/deploy.py -n proxyname -u name:passW -o org -e env -d proxypath -p /
예를 들면 다음과 같습니다.
python tools/deploy.py -n weatherapi -u me@myCo.com:foo -o myCo -e test -d weatherapi -p /
이 명령어는 파일을 압축하여 Apigee Edge를 통해 조직으로 푸시한 후 지정된 환경에 배포합니다.
배포 도구는 API 프록시의 현재 버전을 자동으로 탐색하고 기존 버전을 배포 취소하고 API 프록시의 상위 버전을 배포합니다.
성공하면 다음과 같은 형식으로 출력이 표시됩니다.
Writing ./<proxybasedir>/apiproxy/weatherapi.xml to apiproxy/weatherapi.xml Writing ./<proxybasedir>/apiproxy/proxies/default.xml to apiproxy/proxies/default.xml Writing ./<proxybasedir>/apiproxy/targets/default.xml to apiproxy/targets/default.xml Imported new proxy version 1 Environment: test Revision: 1 BasePath = / State: deployed
기본적으로 이 도구는 클라우드의 Edge에 해당하는 https://api.enterprise.apigee.com에 API 프록시를 업로드합니다. 이 도구를 사용하면 -h 플래그를 지정하여 API 프록시를 온프레미스 버전의 Edge에 업로드할 수도 있습니다.
python tools/deploy.py -n weatherapi -u me@myCo.com:foo -o myCo -e test -d weatherapi -p / -h https://192.168.11.111:8080
이 예시에서는 에지 관리 서버의 IP 주소를 지정합니다. 관리 서버의 DNS 레코드를 만든 경우 다음 형식으로 URL을 지정할 수 있습니다.
https://ms_URL:8080
명령어의 전체 플래그 목록은 다음과 같습니다.
-n: API 프록시의 이름입니다.-u: Apigee Edge에 있는 조직 계정의 사용자 이름 및 비밀번호입니다.-o: 계정이 있는 조직의 이름입니다.-e: API 프록시를 배포해야 하는 환경(test또는prod)입니다.-d: API 프록시 파일이 포함된 디렉터리의 경로입니다. API 프록시 파일은 'apiproxy'라는 디렉터리에 저장해야 합니다. 이 값은 'apiproxy' 디렉터리 자체의 경로가 아니라 'apiproxy' 디렉터리가 포함된 디렉터리의 경로입니다.-p: 수신 메시지를 이 API 프록시 배포로 라우팅하기 위한 패턴 일치로 사용되는 URI 경로입니다. 고급 배포 및 라우팅 요구사항이 없는 경우 대부분의 경우 이 값을 '/'로 설정할 수 있습니다. API 프록시 라우팅에 사용되는 기본 경로는 API 프록시의 ProxyEndpoint 구성 파일에 정의되어 있습니다.-h: 에지 URL입니다. 기본적으로 URL은 클라우드의 Edge에 해당하는https://api.enterprise.apigee.com입니다. 온프레미스 배포의 경우 에지 관리 서버의 URL과 포트 8080을 다음과 같이 사용합니다.https://ms_URL:8080
또는
https://192.168.11.111:8080와 같이 관리 서버의 IP 주소를 사용합니다.
배포 셸 스크립트 구성 및 실행
가장 쉬운 방법은 샘플 API 프록시와 함께 제공되는 배포 스크립트를 실행하는 것입니다. 셸 스크립트는 Apigee Edge Python 배포 도구를 래핑합니다.
/simplyProxy 디렉터리에서 다음을 실행합니다.
$ sh deploy.sh
그러면 다음과 같이 표시됩니다.
Enter your password for user {myname} in the Apigee Enterprise organization {org_name}, followed by [ENTER]:
비밀번호를 입력하고 Enter 키를 누릅니다.
그러면 다음이 표시됩니다.
Deploying to test on https://api.enterprise.apigee.com using {myname} on enterprise.apigee.com and {org_name} on enterprise.apigee.com
다음과 같이 표시됩니다.
Enter your password for user Your USERNAME on enterprise.apigee.com in the Apigee Enterprise organization Your ORG on enterprise.apigee.com, followed by [ENTER]:
즉, 플랫폼 샘플 배포에서 /setup/setenv.sh 파일을 수정해야 합니다. 자세한 내용은 README 또는 Apigee Edge API를 참조하세요.
성공하면 배포 도구가 /apiproxy, 아래의 파일을 ZIP 파일로 압축하여 Apigee Edge의 조직으로 패키지를 가져온 다음 API 프록시를 '테스트' 환경에 배포합니다.
API 프록시를 호출할 준비가 되었습니다.