1.1.0 - Apigee Hybrid 런타임 출시 노트

현재 Apigee Edge 문서가 표시되고 있습니다.
Apigee X 문서로 이동 정보

2020년 1월 27일에 Google은 Apigee Hybrid 런타임 1.1.0 버전을 출시했습니다. 이 섹션에서는 1.1.0 버전에서 출시된 새로운 기능과 변경사항을 설명합니다.

업그레이드 중

1.0.0에서 1.1.0으로 업그레이드할 수 없으며 새 버전은 1.0.0 버전과 호환되지 않습니다. 1.1.0 버전에서는 새 설치가 필요합니다.

새로운 기능 및 개선사항

Apigee Connect (알파 출시 버전)

Apigee Connect 알파를 사용하면 MART 엔드포인트를 노출하지 않고도 Apigee Hybrid 서비스를 관리 영역에 연결할 수 있습니다. Apigee Connect를 사용하면 호스트 별칭 및 승인된 DNS 인증서로 MART 인그레스 게이트웨이를 구성할 필요가 없습니다. 자세한 내용은 Apigee 담당자에게 문의하세요.

기본 경로 라우팅

기본 경로 라우팅을 사용하면 Apigee Hybrid가 API 프록시 호출을 특정 환경으로 라우팅하는 방법을 구성 및 관리할 수 있습니다. 자세한 내용은 기본 경로 라우팅 구성을 참조하세요.

변경사항

Hybrid 런타임 버전 1.1.0의 변경사항은 다음과 같습니다. 변경사항 중 일부는 앞서 언급한 대로 이전 버전 1.0.0과 호환되지 않습니다..

  • 이제 apigeectl CLI가 istio-system 네임스페이스에 Istio를 설치합니다. Istio의 기본 네임스페이스입니다. 이 변경사항은 이전 버전인 Hybrid 버전 1.0.0과 호환되지 않습니다.
  • 이제 apigeectl CLI가 cert-manager 네임스페이스에 CertManager를 설치합니다. 이 변경사항은 이전 버전인 Hybrid 버전 1.0.0과 호환되지 않습니다.
  • 지원되는 버전의 Istio는 Apigee Hybrid 런타임으로 배포되며 버전 1.2.x는 더 이상 지원되지 않기 때문에 1.4.2로 마이그레이션되었습니다.

수정된 버그

Apigee Hybrid 1.0.0 출시 노트에 나열된 다음 문제가 해결되었습니다.

문제 설명
144886537 기본 경로 라우팅은 Apigee Hybrid v1.0.0에서 작동하지 않습니다. 재정의가 동일한 hostAlias를 사용하여 다른 환경으로 라우팅되도록 설정되어 있으면 인그레스가 경로를 기반으로 환경으로 라우팅되지 않습니다.
143774187 하이브리드 UI는 앱 보기에 '회사' 라벨을 표시합니다.

알려진 문제

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

문제 설명
N/A mart 및 envs 구성에서는 hostAlias 속성에 '*'를 사용할 수 없습니다. mart 구성에 특정 호스트 이름을 사용하는 것이 가장 좋습니다.
N/A Apigee Connect 알파 버전에서는 HTTP_PROXY, HTTPS_PROXY, NO_PROXY 변수를 설정할 수 없습니다.
N/A

잘못된 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 정책을 사용하여 호스트 헤더를 삭제합니다.
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를 사용하여 세션 내 개별 트랜잭션을 삭제할 수 있습니다.
143659917

PopulateCache 정책의 만료 설정은 1~30 사이의 명시적 값으로 설정되어야 합니다. 예를 들면 다음과 같습니다. 

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

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

해결 방법: 브라우저를 새로고침하거나 요청을 다시 보냅니다.