Apigee 기술 기능 개요

이 페이지는 ApigeeApigee Hybrid에 적용됩니다.

Apigee Edge 문서 보기

이 주제에서는 Apigee의 기능을 요약하고 Apigee와 Apigee Hybrid의 기능을 비교합니다.

다음 표에서는 이 주제에서 비교한 Apigee API 관리 제품을 보여줍니다.

제품 호스팅된 위치 관리
Apigee Google Cloud Apigee
Apigee Hybrid Google Cloud와 고객의 비공개 데이터 센터 모두 Apigee는 관리 영역을 관리하고 고객은 런타임 영역을 관리합니다.

Apigee 기능 요약

다음 표에서는 Apigee(및 하이브리드)의 기능 수준 요약을 제공합니다.

기능 Apigee 및 하이브리드 지원
API 프록시 버전

배포되면 변경할 수 없음

Istio용 Apigee 어댑터 지원 중단됨: Envoy용 Apigee 어댑터를 대신 사용하는 것이 좋습니다.
앱 조직 AppGroups 또는 개발자 앱 연결을 사용하여 앱을 정리합니다. 클라이언트 앱 소유권 정리를 참조하세요.
배포
  • 비동기 배포
  • 배포 상태 가져오기는 런타임 영역이 관리 영역으로 '체크인된' 마지막 시점을 기준으로 함
환경
  • 환경 그룹 지원
  • Apigee UI 및 API를 통한 셀프서비스
  • 제공 토폴로지의 유연성
  • MP pod는 하나의 환경만 지원할 수 있음

자세한 내용은 환경 및 환경 그룹 정보를 참조하세요.

gRPC 기반 프록시 지원

gRPC 대상 서버에 대한 단항 gRPC 프로토콜 API 요청을 처리합니다. gRPC API 프록시 만들기를 참고하세요.

HTTP/1.1 헤더 필드 이름 사례

백엔드로 전달될 때 HTTP/1.1 헤더 필드 이름을 소문자로 변환합니다. 이 동작은 케이스가 보존될 것으로 예상되는 애플리케이션에 영향을 줄 수 있습니다.

키 저장소/트러스트 저장소
  • Kubernetes 보안 비밀로 관리되는 상위 연결
KVM
  • Apigee UI에서 암호화된 환경 범위의 KVM을 만들 수 있습니다. KVM은 항상 암호화됩니다. UI에서 KVM 항목을 추가, 업데이트 또는 볼 수 없습니다.
  • 디버그(Trace) 세션에서 KVM 정보를 숨기려면 GET 명령어를 사용하여 KVM에 액세스할 때 모든 변수가 있는 private. 속성을 사용하세요. private. 속성을 사용하지 않으면 KVM이 여전히 암호화됩니다. 그러나 KVM 정보는 디버그(Trace) 세션에 복호화되어 표시되며 예외가 발생하지 않습니다.
  • keyvaluemaps.entries API 또는 KeyValueMapOperations 정책을 사용하여 KVM 항목을 관리할 수 있습니다.
  • KVM과 동일한 사용 사례에 속성 집합을 사용할 수 있습니다. 속성 세트 사용을 참조하세요.
  • <MapName> 요소를 사용하면 KeyValueMapOperations 정책에서 런타임 시 동적으로 사용할 KVM을 식별할 수 있습니다.

UI에서 KVM을 만드는 방법에 대한 자세한 내용은 키-값 맵 사용을 참조하세요. 올바른 데이터 지속성 메커니즘을 선택하는 방법은 구성 데이터 액세스를 참조하세요.

수익 창출 수익 창출 개요를 참조하세요.
Node.js
  • Node.js API 프록시는 지원되지 않습니다.
  • Apigee에서는 Node.js 애플리케이션을 Kubernetes에서 별도의 컨테이너(동일한 클러스터 또는 다른 클러스터)로 호스팅하는 것을 권장합니다.
OAuth RevokeOAuthv2 정책이 최종 사용자 ID, 앱 ID 또는 둘 다에 의해 취소됩니다.
정책 정책 개요를 참조하세요.
리소스 조직 수준의 리소스를 사용할 수 없습니다.
역할 및 권한
  • Google Cloud Console의 IAM 서비스를 통해 관리됩니다.
  • 즉시 선별된 일부 역할은 사용 가능합니다.
  • 다른 Google Cloud 권한을 포함할 수 있는 커스텀 역할을 만들 수 있습니다.

자세한 내용은 사용자 및 역할을 참조하세요.

프록시 빌드 마법사의 SOAP 서비스 지원되지 않음. Apigee와 함께 사용할 SOAP 유틸리티를 제공하는 오픈소스 프로젝트인 wsdl2apigee를 참조하세요.
Trace/디버그 세션 Trace 지원을 참조하세요.
가상 호스트

하이브리드의 경우:

  • 인그레스는 Anthos Service Mesh를 통해 구현됩니다.
  • 키와 인증서는 Kubernetes에 직접 배포됩니다.

Apigee의 경우:

  • 각 인스턴스는 자체 서명된 인증서를 통해 HTTPS 엔드포인트를 노출합니다. 조직을 쿼리하면 인증서의 CA를 다운로드할 수 있습니다.

Trace/디버그 지원

다음 표에서는 Apigee 및 하이브리드 Trace 지원을 보여줍니다.

기능 Apigee 및 하이브리드 지원
시의성 약간의 지연: 비동기
세션 이름/ID 사용자의 세션 이름을 수락하지 않음
필터 AND 및 OR 논리 연산을 포함한 복잡한 필터링 로직을 지원합니다. 흐름 변수 참조에 언급된 흐름 변수에 대한 액세스입니다. 구문은 조건 참조에 표시된 것처럼 조건부에 사용되는 것과 동일합니다.
세션 제한 시간

디버그 세션의 길이만 정의합니다. 시작점은 메시지 프로세서가 디버그 모드에서 실행 요청을 받을 때입니다.

기본값은 세션이 API로 시작될 시 5분, UI에서 시작될 시 10분입니다.

하이브리드에서 자동으로 삭제하기 전에 데이터가 24시간 동안 유지됩니다.

세션 유효성 세션 생성 요청이 유효한 기간입니다. 이 시간 내에 디버그 세션이 시작되지 않는 경우 동기화 담당자는 세션 생성 요청을 무시할 수 있습니다. 기본 요건에 설명된 대로 동기화 담당자의 시계를 동기화된 상태로 유지해야 합니다.
Trace 요청 수 기본값은 메시지 프로세서당 10개이며 최댓값은 15개입니다.
API Apigee는 Debug Session APIDebug Session Data API를 노출합니다.

API 개요

다음은 Apigee API와 기능을 요약한 것입니다.

동작 Apigee API
기본 도메인 apigee.googleapis.com
미디어 유형 application/json
인증 OAuth2
키의 타임스탬프 String 형식

{
  "createdAt": "1234",
  "lastModifiedAt": "5678"
}
expand=false 쿼리 매개변수의 구조

{
  "proxies": [
    {
      "name": "helloworld"
    },
    {
      "name": "weather"
    }
  ]
}
밑줄로 프리픽스가 붙은 쿼리 매개변수 지원되지 않음(optimal=true)
페이로드의 속성:
  • created_by
  • modified_by
  • self
지원되지 않음
페이로드의 기본값 미포함
오류 처리 구조

{
  "error": {
    "code": 409,
    "message": "...",
    "status": "ABORTED",
    "details": [...]
  }
}
캐시 삭제 응답 반환: 204 No Content
Cache API 작업 나열삭제만 가능합니다. API 프록시 배포 시 단기 L1 캐시가 자동으로 생성됩니다. 자세한 내용은 캐시 내부를 참조하세요.

Apigee 측정항목 API

Apigee 측정항목 API 요약:

기능 Apigee API
API 엔드포인트 apigee.googleapis.com
일일 분석 이메일 지원되는 API 없음
비동기 쿼리 목록 API userId 속성은 응답에서 생략됩니다. 메서드: organizations.environments.queries.list를 참조하세요.
커스텀 보고서 API createdBylastModifiedBy 속성이 응답에서 삭제되었습니다. Reports API를 참조하세요.

Apigee Hybrid 기능

다음 표에는 하이브리드 기능이 요약되어 있습니다.

서비스 하이브리드 영역
애널리틱스 런타임 영역의 데이터 수집 pod는 fluentdUDCA(범용 데이터 수집 에이전트)를 사용하여 분석을 수집하고 관리 영역의 UAP(통합 분석 플랫폼)로 데이터를 제공합니다.
API 프록시 게이트웨이 메시지 프로세서(MP)는 수신되는 요청을 처리합니다. MP는 런타임 영역에서 하나 이상의 컨테이너화된 앱으로 구현됩니다.
지속성 Cassandra는 KMS, KVM, 할당량, 캐시 기능에 대한 지속성을 제공합니다.
배포 동기화 담당자는 API 프록시 구성, 환경 정보, 기타 데이터를 관리 영역과 런타임 영역 간에 최신 상태로 유지합니다.
관리 사용자 인터페이스 Apigee UI는 관리 영역에서 호스팅되는 컨테이너화된 앱입니다.
부하 분산 Istio 인그레스 컨트롤러는 런타임 영역의 라우터/메시지 프로세서(RMP) 컨테이너화된 앱에 요청을 보냅니다.
API Apigee API관리 서버MART를 통해 액세스됩니다. MART는 로컬 Cassandra Datastore와 상호작용하고 Apigee API가 런타임 데이터 항목에 액세스하고 관리할 수 있도록 API 제공업체 역할을 합니다.
측정항목 모든 서비스에 대해 클러스터당 단일 Prometheus 서버가 관리합니다.