이 페이지는 Apigee 및 Apigee Hybrid에 적용됩니다.
Apigee Edge 문서 보기
이 단계에서 수행할 작업
테스트 API 프록시를 만들고 배포하려면 다음 단계를 따르세요. 마지막으로 HTTP 요청을 전송하여 API 프록시를 테스트합니다.
API 프록시 만들기 및 배포
Apigee 프로비저닝 절차는 API 프록시를 자동으로 만들고 배포하지 않습니다. 프록시 만들기 및 배포를 수동으로 수행해야 합니다.
Cloud 콘솔의 Apigee UI
첫 번째 프록시를 만들고 배포하려면 다음 안내를 따르세요.
- 브라우저에서 Cloud 콘솔의 Apigee UI를 엽니다.
- UI 왼쪽 상단 모서리에 있는 드롭다운 메뉴에서 조직 이름이 선택되어 있는지 확인합니다. 조직 이름은 Google Cloud 프로젝트 이름과 동일합니다.
- 왼쪽 탐색창에서 프록시 개발 > API 프록시를 클릭합니다.
- + 만들기를 클릭합니다.
프록시 만들기 페이지가 열립니다.
- 프록시 템플릿 상자에서 역방향 프록시(가장 일반적)를 선택합니다.
- 1단계: 프록시 세부정보에서 다음 값으로 프록시를 구성합니다.
매개변수 이름 값 프록시 이름 hello-world
기본 경로 /hello-world
대상(기존 API) mocktarget.apigee.net
- 다음을 클릭합니다.
- 2단계: 배포(선택사항)에서 다음 안내를 따르세요.
- 배포 환경: 선택사항. 체크박스를 사용해서 프록시를 배포하려는 환경을 하나 이상 선택합니다. 이 시점에서 프록시를 배포하지 않으려면 배포 환경 필드를 비워 둡니다. 나중에 언제든지 프록시를 배포할 수 있습니다.
- 서비스 계정: 선택사항. 서비스 계정의 역할 및 권한에 지정된 대로 배포에 서비스 계정을 연결하여 Google Cloud 서비스에 액세스하도록 프록시를 사용 설정합니다.
- 만들기를 클릭합니다.
새 API 프록시가 생성되고 선택한 환경에 배포됩니다.
- 새로 만든 프록시의 프록시 요약 페이지가 열립니다. 상태에서 녹색 체크표시는 프록시가 성공적으로 배포되었음을 나타냅니다. 프록시가 배포되지 않았으면 API 프록시 배포를 선택하고 단계에 따라 수동으로 배포합니다.
- 왼쪽 탐색 창에서 관리 > 환경 > 환경 그룹을 선택합니다.
- 환경 그룹의 호스트 이름을 복사합니다. 다음 단계에서 이 호스트 이름을 사용하여 API 프록시를 호출합니다.
Apigee UI
첫 번째 프록시를 만들고 배포하려면 다음 안내를 따르세요.
- Apigee UI에 로그인합니다.
- UI 왼쪽 상단 모서리에 있는 드롭다운 메뉴에서 조직 이름이 선택되어 있는지 확인합니다. 조직 이름은 Google Cloud 프로젝트 이름과 동일합니다.
- 기본 뷰에서 API 프록시를 클릭합니다.
- 환경 선택 드롭다운 목록에서 환경을 선택합니다.
- 새로 만들기를 클릭합니다.
- 역방향 프록시(가장 일반적)를 클릭합니다.
- 프록시 세부정보 페이지에서 다음 값으로 프록시를 구성합니다.
매개변수 이름 값 이름 hello-world
기본 경로 /hello-world
대상(기존 API) https://mocktarget.apigee.net
- 다음을 클릭합니다.
- 일반 정책 페이지의 보안: 승인에서 통과(승인 없음)를 선택합니다.
- 다음을 클릭합니다.
- 요약 페이지의 선택적 배포에서 프록시를 배포할 환경을 선택합니다.
- 만들기 및 배포를 클릭합니다.
새 API 프록시가 생성되고 선택한 환경에 배포됩니다.
- 프록시 목록으로 이동을 클릭합니다. 상태에서 녹색 체크표시는 프록시가 성공적으로 배포되었음을 나타냅니다. 프록시가 배포되지 않았으면 API 프록시 배포를 선택하고 단계에 따라 수동으로 배포합니다.
- 왼쪽 탐색 창에서 관리자 > 환경 > 그룹을 선택합니다.
- Google Cloud 콘솔에서 보기를 클릭합니다.
- 환경 그룹의 호스트 이름을 복사합니다. 다음 단계에서 이 호스트 이름을 사용하여 API 프록시를 호출합니다.
- Google Cloud 콘솔을 닫습니다.
내부 액세스 권한을 사용하여 프록시 호출
4단계: 액세스 라우팅 맞춤설정에서 내부 액세스 권한을 허용한 경우 내부 전용 액세스 권한으로 API 프록시 호출의 안내를 따르세요.
외부 액세스 권한을 사용하여 프록시 호출
4단계: 액세스 라우팅 맞춤설정에서 외부 액세스 권한을 허용한 경우 다음 단계를 따르세요.
- 호스트의 DNS 항목을 설정합니다. 이 태스크를 수행하는 다음과 같은 두 가지 방법이 있습니다.
- 등록 기관에서 DNS 구성 아래의 마법사 페이지에 표시된 IP로 환경 그룹 호스트 이름을 연결하는 A 레코드를 만듭니다. 예를 들어 호스트 이름이
sales.example.com
이고 IP가 10.23.0.2이면sales.example.com
의 레코드를10.23.0.2
주소로 연결합니다. - Google Cloud DNS를 사용하여 URL을 IP 주소에 매핑합니다.
- 등록 기관에서 DNS 구성 아래의 마법사 페이지에 표시된 IP로 환경 그룹 호스트 이름을 연결하는 A 레코드를 만듭니다. 예를 들어 호스트 이름이
- 터미널 창에서 다음 요청을 전송하여 API 프록시를 테스트합니다.
curl -v -H "Host:YOUR_ENV_GROUP_HOSTNAME" \ https://YOUR_INSTANCE_IP_OR_DNS/hello-world
각 항목의 의미는 다음과 같습니다.
Host
헤더(YOUR_ENV_GROUP_HOSTNAME) 값은 환경 > 환경 그룹 페이지의 호스트 이름입니다.
요청에 성공하면
Hello, Guest!
문자열이 반환됩니다. 요청이 실패하면 문제 해결을 참조하세요.
다음 단계
- 다음을 포함하여 Apigee 가이드 살펴보기.