이 튜토리얼에서는 Apigee 프록시 마법사를 사용하여 통합 대상으로 프록시를 만드는 방법을 보여줍니다. 프록시는 기존 통합의 API 트리거 참조를 사용하여 통합에서 일련의 단계를 시작합니다.
아래 단계에서는 프록시가 호출될 때 통합을 성공적으로 실행하기 위해 통합 대상 프록시를 구성하는 방법을 설명합니다.
시작하기 전에
- Apigee 로그인 사용자 인증 정보 및 조직 세부정보를 확인하세요. 이 정보는 Apigee UI 내에서 Apigee Integration 기능 및 프록시 마법사에 액세스하기 위해 필요합니다.
- API 트리거 및 최소 1개 이상의 태스크로 통합을 만들어 게시하세요.
- API 트리거를 사용하는 통합을 아직 만들지 않았으면 Apigee Integration 시작하기의 단계를 수행합니다.
- 이후 단계에 사용되므로 만들려는 통합의 이름 또는 사용하려는 기존 통합의 이름을 기록해 둡니다.
- Apigee 조직이 생성된 동일한 Google Cloud 프로젝트에서 Google 서비스 계정을 만들고 다음을 수행합니다.
- 서비스 계정에 Apigee Integration 호출자 역할
(roles/integrations.apigeeIntegrationInvokerRole)
을 할당합니다. 사전 정의된 Apigee Integration 역할에 대한 자세한 내용은 사전 정의된 IAM 역할을 참조하세요. - 사용자 계정(주 구성원)이
iam.serviceAccounts.actAs
권한이 있는 리소스에 서비스 계정을 연결할 수 있도록 허용합니다. 서비스 계정 권한에 대한 정보는 서비스 계정 인증 역할을 참조하세요.
API 프록시를 배포할 때 이 서비스 계정을 제공해야 합니다.
- 서비스 계정에 Apigee Integration 호출자 역할
Apigee Integration 대상 프록시 만들기
Apigee UI에서 통합 대상 프록시를 만들려면 다음을 수행합니다.
- Apigee UI로 이동하고 로그인합니다.
- UI 왼쪽 상단의 드롭다운 메뉴를 사용해 조직을 선택합니다.
- 기본 뷰에서 API 프록시를 클릭합니다.
또는 왼쪽 탐색 메뉴에서 개발 > API 프록시를 선택할 수 있습니다.
- 환경 드롭다운 목록에서 새 API 프록시를 만들 환경을 선택합니다.
- 새로 만들기를 클릭합니다.
- 프록시 유형 표시에서 통합 대상을 선택합니다.
프록시 만들기 마법사가 시작됩니다.
- 프록시 세부정보 구성 페이지에서 다음 세부정보를 제공하세요.
- 이름: 인스턴스의 이름을 입력합니다.
프록시 이름에는 영숫자 문자, 대시, 밑줄만 사용할 수 있습니다.
- 기본 경로: 프록시 이름에 따라 자동으로 채워집니다.
기본 경로는 API에 요청을 수행하는 데 사용되는 URL의 일부입니다. Apigee는 URL을 사용하여 수신 요청을 적절한 API 프록시로 일치시키며 라우팅합니다.
- 설명: (선택사항) 프록시에 대해 간략한 설명을 입력합니다.
예를 들면
Proxy test for Apigee Integration
입니다. - 통합 리전: 드롭다운 목록에서 통합 리전을 선택합니다.
- 통합 대상: 드롭다운 목록에서 통합 대상을 선택합니다. 통합 대상 목록은 선택된 통합 리전을 기준으로 채워집니다.
- 트리거: 드롭다운 목록에서 통합과 연결된 API 트리거를 선택합니다.
- 엔드포인트 유형: 동기화를 선택합니다.
- 이름: 인스턴스의 이름을 입력합니다.
- 다음을 클릭합니다.
- 일반 정책 구성 페이지에서 기본 선택 항목을 그대로 두고 다음을 클릭합니다.
- 요약 페이지에서 만들기를 클릭합니다.
통합 대상 프록시가 성공적으로 생성되었습니다.
프록시 배포
새로 만든 프록시를 배포하려면 다음 단계를 수행합니다.
- Apigee UI에서 개발 > API 프록시를 선택합니다.
UI에 API 프록시와 배포 상태의 목록이 표시됩니다.
- 환경 드롭다운 목록에서 API 프록시를 배포하려는 환경을 선택합니다.
배포하려는 최근에 만든 프록시를 클릭합니다. UI에 기본적으로 개요 페이지가 표시됩니다.
- 변경사항을 배포하려면 먼저 배포를 클릭하여 배포 대화상자를 표시합니다.
- 다음을 입력합니다.
- 버전: 배포하려는 프록시의 버전 번호입니다.
- 환경: 프록시를 배포하려는 환경입니다.
- 서비스 계정: 프록시에 생성된 서비스 계정입니다.
- 배포를 클릭합니다.
UI에서 선택한 수정 버전의 배포 프로세스가 시작됩니다. 프록시 배포가 완료되는 데 최대 1분이 걸릴 수 있습니다.
프록시가 배포되면 배포 섹션의 상태 열에 프록시의 버전 1이 배포됨을 보여주는 녹색 아이콘이 표시됩니다.
통합 대상 프록시 테스트
터미널 창에서 다음 명령어를 실행하여 프록시를 호출하고 통합을 트리거합니다.
curl -v https://YOUR_ENV_GROUP_HOSTNAME/PROXY_NAME
여기서 YOUR_ENV_GROUP_HOSTNAME
은 프록시가 배포된 환경이 포함된 환경 그룹의 호스트 이름입니다.
예를 들면 다음과 같습니다.
curl -v https://my-org-prod.hybrid.e2e.apigeeks.net/my-proxy
통합이 프록시 호출로 트리거되었는지 확인하려면 다음 안내를 따르세요.
- Apigee UI를 엽니다.
- 개발 > 통합을 클릭합니다.
- 위 단계에서 만든 통합 이름을 검색하거나 선택하고 통합 이름을 클릭합니다.
- 로그를 클릭합니다.
- 트리거된 통합에 대해 실행 로그가 존재하는지 확인합니다. 로그 세부정보를 보려면 행을 클릭하여 실행 세부정보를 확장합니다.
프록시 요청 페이로드 업데이트(선택사항)
프록시 요청 페이로드를 업데이트하려면 다음 단계를 수행합니다.
- Apigee UI의 왼쪽 탐색 메뉴에서 개발 > API 프록시를 선택합니다.
- 최근에 만든 프록시를 클릭합니다.
기본적으로 UI에는 프록시 편집기에 해당 프록시의 개요 탭이 표시됩니다.
- 개발 탭을 클릭합니다.
- 탐색기 창의 정책 제목 아래에서 통합 요청 설정을 선택합니다.
<Parameters>
블록의 주석 처리를 삭제하고 매개변수 세부정보를 입력합니다.개별 매개변수를 지정하려면
<Parameter>
요소를 사용합니다. 매개변수 배열을 지정하려면<ParameterArray>
요소를 사용합니다.- 저장을 클릭합니다.
다음 단계
통합 디자이너 레이아웃을 살펴보고 모든 개념에 설명된 다양한 통합 개념 이해하기