커넥터를 설치하고 구성하기 전에 Google Cloud 프로젝트 내에서 API 허브를 프로비저닝하고 필요한 리소스를 만들어야 합니다.
API 허브 프로비저닝
- Google Cloud 프로젝트 만들기: Google Cloud 프로젝트가 없는 경우 콘솔 또는 gCloud CLI를 사용하여 새 Google Cloud 프로젝트를 만듭니다. 모든 결제 관련 설정이 구성되어 있는지 확인합니다. 자세한 내용은 Google Cloud 프로젝트 만들기를 참고하세요.
- API 허브 프로비저닝: API 허브 API를 사용 설정하고 Google Cloud UI를 사용하여 프로비저닝 흐름을 따릅니다. 메타데이터/런타임 이벤트를 처리하는 데 필요한 권한 및 부가기능을 사용 설정합니다.
플러그인 생성
이 단계에서는 서비스 계정을 설정하고 Private Cloud용 Apigee Edge 조직을 API 허브에 등록합니다.
- 서비스 계정 만들기: 고객 프로젝트 내에서 새 Google Cloud 서비스 계정을 만듭니다. 이 서비스 계정은 Apigee API Hub for Private Cloud 커넥터가 API 메타데이터와 런타임 데이터를 API 허브에 쓰는 데 사용됩니다. 자세한 내용은 서비스 계정 만들기를 참고하세요.
API 허브에서 플러그인 인스턴스 만들기
- 프라이빗 클라우드용 Apigee Edge 조직 등록:
API 허브에 하나 이상의 Apigee Edge for Private Cloud 조직을 등록합니다. 각 플러그인 인스턴스는 하나의 조직만 지원할 수 있습니다. 따라서 여러 조직을 온보딩해야 하는 경우 조직별로 별도의 플러그인 인스턴스를 만들어야 합니다. API Hub UI를 통해 또는 API 요청을 사용하여 이 작업을 수행할 수 있습니다.
- 서비스 계정 설정:
플러그인 인스턴스를 만드는 동안 이전 단계에서 만든 서비스 계정을 제공해야 합니다. 서비스 계정은 Apigee API Hub for Private Cloud 커넥터가 API 메타데이터와 런타임 데이터를 API Hub에 쓰는 데 사용됩니다.
- 여러 조직의 가능한 토폴로지::
- 옵션 1: 조직별 서비스 계정 분리: 조직별로 전용 서비스 계정을 만듭니다. 각 플러그인 인스턴스는 해당 서비스 계정에 연결됩니다. 이 경우 키 가장 서비스 계정에는 각 개별 서비스 계정을 대신하여 키를 생성할 수 있는 권한이 필요합니다.
- 옵션 2: 여러 조직에 단일 서비스 계정 사용: 더 간단한 설정을 선호하는 경우 모든 조직에 하나의 서비스 계정을 사용할 수 있습니다. 이 방법을 사용하면 모든 조직이 동일한 서비스 계정을 공유하므로 구성이 간소화됩니다. 하지만 이 방법을 사용하면 서비스 계정의 변경사항 (예: 키 순환)이 연결된 모든 조직에 영향을 미칩니다.
- 여러 프라이빗 클라우드용 Apigee Edge 인스턴스 처리: 설정에 여러 프라이빗 클라우드용 Apigee Edge 인스턴스가 포함된 경우에도 동일한 원칙이 적용됩니다. 프라이빗 클라우드용 Apigee Edge 인스턴스마다 조직별로 별도의 플러그인 인스턴스가 필요합니다. 다음 중 원하는 방법을 선택하면 됩니다.
- Apigee Edge for Private Cloud 인스턴스별로 별도의 서비스 계정을 사용합니다.
- 선택한 토폴로지에 따라 여러 Apigee Edge for Private Cloud 인스턴스에 단일 서비스 계정을 사용합니다.
플러그인 인스턴스가 성공적으로 생성된 경우:
플러그인 인스턴스를 만든 후 Private Cloud용 Apigee API 허브 커넥터를 구성하는 데 필요한 다음 주요 정보가 제공됩니다.
- 런타임 데이터 pub/sub 주제: API 런타임 (분석) 데이터를 업로드하기 위한 pub/sub 주제입니다.
- 메타데이터 Pub/Sub 주제: API 메타데이터를 업로드하기 위한 Pub/Sub 주제입니다.
- 플러그인 인스턴스 ID: Apigee Edge for Private Cloud 게이트웨이의 고유 식별자로, 형식은
projects/PROJECT_ID/locations/LOCATION/plugins/PLUGIN_ID/instances/INSTANCE_ID입니다.