1.0.0(GA) - Apigee Hybrid 런타임 출시 노트

Apigee Edge 문서입니다.
Apigee X 문서로 이동 info

Google은 2019년 11월 20일에 Apigee Hybrid 런타임 1.0.0 버전을 출시했습니다. 이 섹션에서는 1.0.0 버전의 버그 수정 및 알려진 문제를 설명합니다.

알려진 문제(GA)

다음 표에서는 이번 출시 버전의 알려진 문제를 설명합니다.

문제 설명
144886537 기본 경로 라우팅은 Apigee Hybrid v1.0.0에서 작동하지 않습니다. 재정의가 동일한 hostAlias를 사용하여 다른 환경으로 라우팅되도록 설정되어 있으면 인그레스가 경로를 기반으로 환경으로 라우팅되지 않습니다.
144584813 디버그 세션을 만들었지만 세션에 아직 트랜잭션이 없다면 List Debug Sessions API에서는 이 목록에 있는 세션을 포함하지 않습니다. API는 세션에 하나 이상의 트랜잭션이 포함된 경우에만 응답에 세션을 포함합니다.
144436206 캐시 성능 보기에서 캐시 적중률 계산이 잘못되었습니다.
144321491 Apigee Hybrid는 잠재적인 성능 저하를 나타내는 '누락된 캐시 생성' 알림을 로깅합니다. 이러한 메시지는 예상되며 무시해도 됩니다.
144321144 보호되는 가상 호스트가 있는 프록시를 다시 로드할 수 없습니다.
144286363

env.json의 디버그 마스크는 응답 데이터를 마스킹하지 않습니다.

env.json 디버그 마스크를 responseJSONPaths 필드로 업데이트하는 다음 API가 작동하지 않습니다.

PATCH /v1/organizations/org/environments/env/debugmask?replaceRepeatedFields=true
{
  "responseJSONPaths": ["$.maskedDataEnv"]
}

trace로 이 문제를 해결하려면 UI에서 전체 trace 세션을 삭제하거나 trace API를 사용하여 세션 내 개별 트랜잭션을 삭제할 수 있습니다.
143774187 하이브리드 UI는 앱 보기에 '회사' 라벨을 표시합니다.
143659917

PopulateCache 정책의 만료 설정은 1~30 사이의 명시적 값으로 설정되어야 합니다. 예: 

<ExpirySettings>
  <TimeoutInSec>30</TimeoutInSec>
</ExpirySettings>
133192879

요약: API 또는 UI를 사용하여 조직의 배포 상태를 가져올 때 지연 시간은 매우 깁니다. 이 지연 시간으로 인해 HTTP 204 (No Content) 또는 HTTP 400 (Bad Request) 응답이 발생할 수 있습니다.

해결 방법: 브라우저를 새로고침하거나 요청을 다시 보냅니다.
123932912 다운타임 없이 배포하면 새 버전의 배포가 실패할 때 원본 버전은 배포되지 않습니다. 배포 상태를 복원하려면 원래 버전을 다시 배포해야 합니다.
해당 없음

잘못된 HTTP 헤더 오류: Istio 인그레스는 모든 수신 대상 응답을 HTTP2 프로토콜로 전환합니다. 하이브리드 메시지 프로세서는 HTTP1만 지원하므로 API 프록시가 호출되면 다음 오류가 표시될 수 있습니다.

http2 error: Invalid HTTP header field was received: frame type: 1, stream: 1,
   name: [:authority], value: [domain_name]

이 오류가 표시되면 다음 작업 중 하나를 수행하여 문제를 해결할 수 있습니다.

  • 응답에서 호스트 헤더를 생략하도록 대상 서비스를 수정합니다.
  • 필요한 경우 API 프록시에서 AssignMessage 정책을 사용하여 호스트 헤더를 삭제합니다.

수정된 버그

Apigee Hybrid 베타 2 출시 노트에 나와 있는 다음과 같은 문제를 해결했습니다.

문제 설명
133444606

업데이트 개발자 앱 API는 문서화된 입력란을 모두 지원하지는 않습니다.
133192879

API 또는 UI를 사용하여 조직의 배포 상태를 가져올 때 지연 시간이 매우 깁니다. 이 지연 시간으로 인해 HTTP 204 (No Content) 또는 HTTP 400 (Bad Request) 응답이 발생할 수 있습니다.
131111865

파일 시스템이 가득 차면 동기화 담당자가 실패합니다. 이는 Kubernetes 가비지 컬렉션 프로세스로 인해 발생하며 기본적으로 85%에 도달할 때까지 트리거되지 않습니다.

닫힘: 재현 불가

지원되지 않는 Apigee Edge 기능

Google은 Apigee Hybrid에서 다음 기능을 지원하지 않을 예정입니다.

  • 다음을 위한 API
    • KVM 항목 조작
    • 토큰이 해시되어 OAuth 액세스 토큰 검색 또는 취소
  • Drupal 7을 사용하는 개발자 포털 개발
  • OAuth v1 또는 OAuthv1.0a 정책
  • ConcurrentRateLimit 정책 비율 제한 정책
  • Trireme(2019년 10월 10일에 지원 종료)

하이브리드와 Edge의 기능 전체를 비교하려면 하이브리드와 Edge 비교를 참고하세요.

다음 단계