4.50.00 프라이빗 클라우드용 Edge 출시 노트

Apigee Edge 문서를 보고 있습니다.
Apigee X 문서로 이동하세요.
info

이 섹션에서는 Edge for Private Cloud 기능 출시 버전 4.50.00을 설명합니다.

버전 요약

다음 표에는 이 버전의 변경사항이 요약되어 있습니다.

새로운 기능

이번 출시 버전에는 다음과 같은 새로운 기능이 포함됩니다.

○ 이제 API 프록시에서 TLS 연결 정보를 사용할 수 있습니다.
○ ZooKeeper 업그레이드
○ Drupal 8 포털의 가용성 및 Drupal 7의 지원 종료

각 새로운 기능에 대한 자세한 내용은 새로운 기능을 참고하세요.

이전 버전과의 호환성 이 버전의 프라이빗 클라우드용 Apigee Edge에는 하위 호환성에 영향을 미치는 다음 문제가 도입되었습니다.
     
  • 19.03.01 공개 클라우드 출시 노트에 설명된 대로 문제 132443137이 수정됨에 따라 이제 메시지 프로세서가 X-Apigee-*로 시작하는 헤더를 무시합니다. 따라서 X-Apigee-* 헤더를 사용하는 코드를 리팩터링하고 지원되는 헤더로 대체해야 합니다.
  • Cassandra 로그 파일의 이름이 변경되었습니다. 이제 다음과 같습니다.

    /opt/apigee/var/log/apigee-cassandra/system.log
포함된 발표곡

이전 Edge for Private Cloud 기능 출시 이후 다음 출시가 있었으며 이 출시에 포함됩니다.

○ Edge:
   20.04.06 (런타임, API 관리, 수익 창출 관리)
   20.03.27 (UI)
   20.03.16 (Edge 분석)
   20.03.11 (UI)
   20.02.27 (API 모니터링)
   20.02.24 (UI)
   20.02.03 (API 모니터링)
   20.01.29 (UI)
   20.01.22 (UI)
   20.01.06 (API 관리/런타임)
○ Edge (계속):
   20.01.06 (UI)
   19.11.13 (API 보안 보고)
   19.10.01 (UI)
   19.09.26 (Edge UI/포털)
   19.08.27 (UI)
   19.08.15 (API 보안 보고)
   19.07.29 (UI)
○ 포털:
   20.05.27.00
   20.04.13.00
   20.03.20.00
   19.12.20.00
   19.11.21.00
   19.09.25.00
중단 없음
지원 중단

4.50.00 출시와 함께 다음 사항이 적용됩니다.

  • 4.18.05: 프라이빗 클라우드용 Apigee Edge 버전 4.18.05가 지원 중단되었습니다.

이번 출시에서 지원 중단된 기능은 다음과 같습니다.

  • Node.js 프록시 및 보안 저장소 지원
  • OAuth v1 정책 지원
  • 동시 실행 비율 제한 정책 지원
  • Istio용 Apigee 어댑터 지원
  • Teams 사전 체험 기능 지원

삭제 타임라인을 비롯한 지원 중단에 대한 자세한 내용은 Apigee 지원 중단 및 서비스 종료를 참고하세요.

버그 수정

이번 출시에는 다음과 같은 버그 수정이 포함되어 있습니다.

○ 키 저장소가 비슷한 이름이나 별칭으로 구성된 경우 메시지 프로세서가 환경을 로드하지 못합니다. (154428338)
○ 패치 설치 중 QPid 종속 항목 충돌 (152574421)
○ 캐시 메모리 제한기가 최대 L1 캐시 크기를 따르지 않음 (151449163)
○ 백업 스크립트 실패 (150710952)
○ QPid 서버에서 추가 로그 메시지 전송 (148231209)
○ Postgresql 백업에서 SSO 정보를 저장하지 않음 (147458330)
○ apigee-nginx 버전이 업그레이드되지 않음 (146872858)
○ '새 UI 사용해 보기' 메시지가 더 이상 표시되지 않음 (145419621)
○ Apigee SmartDocs API 취약점 (145340106)
○ Postgres 백업 스크립트 실패 (145254693)
○ 다양한 보안 수정사항 (142150706)
○ 라우터에서 메시지 프로세서로의 시간 초과 비율이 높음 (138107618)
○ SSO 설정 스크립트 실패 (135616498)
○ JMX 포트 (132044907)
○ 경합 상태로 인해 런타임 트래픽에 간헐적으로 404가 발생함 (130653816)
○ 업그레이드 중 OpenLDAP 손상 (120799182)
○ 여러 데이터 센터 구성에서 DataAccessException (76087166)
○ MessageLogging 정책에서 FormatMessage가 false로 설정되어 작동하지 않음 (68722102)

각 수정사항에 관한 자세한 내용은 버그 수정을 참고하세요.

알려진 문제

이 출시에는 다음과 같은 알려진 문제가 포함되어 있습니다.

○ JWT 검증 실패 (159788170)
○ Mint 등급 서버 메모리 누수 (137865184)
○ Amazon Linux 1에서 apigee-monit이 지원되지 않음 (122370980)
○ 메시지 프로세서 백업이 올바른 파일 집합을 백업하지 않음 (121095148)
○ 업그레이드 후 캐시 부적중 비율 증가 (160109014)
○ 본문이 비어 있고 Content-Encoding: gzip인 GET 요청에 대한 HTTP 408 응답 (159858015)

해결 방법을 비롯한 각 알려진 문제에 대한 자세한 내용은 알려진 문제를 참고하세요.

업그레이드 경로

다음 표에는 이번 출시의 업그레이드 경로가 나와 있습니다.

4.19.01 또는 4.19.06 4.19.01/4.19.06 → 4.50.00에서 직접 업그레이드
4.18.05부터 4.18.05에서 4.50.00으로 직접 업그레이드

새로운 기능

이 섹션에는 이번 출시의 새로운 기능이 나열되어 있습니다. 또한 이 출시에는 포함된 출시에 나열된 Edge UI, Edge 관리, 포털 출시의 모든 기능이 포함됩니다.

이번 출시에는 다음과 같은 개선사항 외에도 여러 유용성, 성능, 보안, 안정성 개선사항이 포함되어 있습니다.

이제 API 프록시에서 TLS 연결 정보를 사용할 수 있음

TLS를 지원하는 가상 호스트를 통해 API 프록시에 대한 요청 중에 Edge는 TLS 연결 정보를 캡처할 수 있습니다. 이제 API 프록시가 흐름 변수를 통해 해당 정보에 액세스하여 추가 분석과 유효성 검사를 수행할 수 있습니다. 자세한 내용은 API 프록시에서 TLS 연결 정보에 액세스를 참고하세요.

Zookeeper 업그레이드

이번 출시에는 Zookeeper 3.4.14가 포함되어 있습니다.

Drupal 8 포털의 사용 가능 여부 및 Drupal 7의 지원 종료

Drupal 8이 프라이빗 클라우드용 Apigee 권장 개발자 포털로 Drupal 7을 대체했습니다. Drupal 7 자체의 장기 지원이 2021년 11월에 종료되므로 Drupal 7용 Apigee 모듈은 2021년 11월부터 지원되지 않습니다. Drupal 7의 설치/업그레이드 스크립트는 아직 사용할 수 있지만 더 이상 사용해서는 안 되며 향후 출시에서 삭제될 예정입니다.

Apigee와 통합되는 Drupal 8 모듈에 대해 알아보려면 Drupal 8을 사용하여 포털 빌드를 참고하세요.

지원되는 소프트웨어

이 출시에는 지원되는 소프트웨어에 대한 다음과 같은 변경사항이 포함되어 있습니다.

지원 추가됨 더 이상 지원되지 않음

이 출시 버전에서는 다음 플랫폼에 대한 지원이 추가되었습니다.

  • Red Hat Enterprise Linux (RHEL) 7.8
  • CentOS 7.8
  • Oracle Linux 7.8

이 출시 버전에서는 다음 플랫폼이 더 이상 지원되지 않습니다.

  • Red Hat Enterprise Linux (RHEL) 6.10
  • CentOS 6.10
  • Oracle Linux 6.9

지원되는 플랫폼의 전체 목록은 지원되는 소프트웨어 및 지원되는 버전을 참고하세요.

버그 수정

이 섹션에는 이 출시에서 수정된 비공개 클라우드 버그가 나열되어 있습니다. 또한 이 버전에는 포함된 버전에 표시된 Edge UI, Edge 관리, 포털 버전의 모든 버그 수정이 포함되어 있습니다.

문제 ID 설명
154428338

키 저장소가 유사한 이름 또는 별칭으로 구성된 경우 메시지 프로세서가 환경을 로드하지 못합니다.

이름 지정 규칙이 비슷한 키 저장소를 로드할 때 발생하는 정규식 조회 충돌이 수정되었습니다. 이로 인해 메시지 프로세서가 키 저장소와 연결된 환경을 로드하지 못하거나 조회 중에 충돌하는 키 저장소가 여러 개 반환될 때 시작하지 못했습니다.
152574421

패치 설치 중 QPid 종속 항목 충돌

이제 올바른 버전의 QPid가 설치됩니다.
151449163

캐시 메모리 제한기가 최대 L1 캐시 크기를 따르지 않음

이제 캐시 메모리 제한기가 최대 L1 캐시 크기를 준수합니다.
150710952

백업 스크립트 실패

업데이트된 백업 스크립트를 기반으로 백업 절차가 업데이트되었습니다.
148231209

QPid 서버에서 추가 로그 메시지 전송

QPid 서버가 더 이상 추가 로그 메시지를 보내지 않습니다.
147458330

Postgresql 백업에 SSO 정보가 저장되지 않음

이제 Postgresql 백업이 SSO 정보를 저장합니다.
146872858

apigee-nginx 버전이 업그레이드되지 않았습니다.

apigee-nginx 버전이 올바르게 업그레이드됩니다.
145419621

`새 UI 사용해 보기` 메시지가 더 이상 표시되지 않음

UI에 더 이상 '새 UI 사용해 보기' 메시지가 표시되지 않습니다.
145340106

Apigee SmartDocs API 취약점

보안 취약점을 해결하기 위해 Apigee SmartDocs 프록시가 업데이트되었습니다. 자세한 내용과 필수 단계는 SmartDocs 설치 절차를 참고하세요.
145254693

Postgres 백업 스크립트가 실패함

이제 Postgres 백업 스크립트가 올바르게 작동합니다.
142150706

다양한 보안 수정사항

#111390246을 비롯한 보안 문제 수정
138107618

라우터에서 메시지 프로세서로의 시간 제한 비율이 높음

이 문제는 해결된 상태입니다.
135616498

SSO 설정 스크립트 실패

파일 스키마 URL을 사용하면 SSO 설정 스크립트가 실패하는 문제가 수정되었습니다.
132044907

JMX 포트

JMX 포트는 외부 액세스가 아닌 내부 서버에만 열려 있어야 합니다.
130653816

경합 상태로 인해 런타임 트래픽에 간헐적으로 404가 발생함

일부 프록시가 올바르게 배포되지 않는 MP 부트스트랩 중의 경합 상태가 수정되었습니다.
120799182

업그레이드 중 OpenLDAP 손상

이 문제는 해결된 상태입니다.
76087166

여러 데이터 센터 구성의 DataAccessException

여러 데이터 센터 구성에서 하나의 데이터 스토어를 사용할 수 없게 되면 더 이상 DataAccessException 오류가 표시되지 않습니다.
68722102

MessageLogging 정책에서 FormatMessage가 false로 설정되어 작동하지 않음

이제 MessageLogging 정책에서 FormatMessage를 false로 설정할 수 있습니다.

알려진 문제

다음 표에는 이번 출시의 알려진 문제가 나와 있습니다.

문제 ID 설명
159788170

JWT 검증 실패

2048비트 미만의 RSA 키의 경우 JWT 유효성 검사가 실패합니다.

해결 방법:

키가 2048비트 이상인지 확인합니다.
137865184

민트 평점 서버 메모리 누수

새 Qpid 인스턴스가 mxgroup에 등록되면 소비자가 없는 대기열이 빌드되어 사용 가능한 모든 리소스를 사용할 때까지 대기열 깊이가 증가합니다.

해결 방법:

없음
122370980

Amazon Linux 1에서 apigee-monit이 지원되지 않음

해결 방법:

없음
121095148

메시지 프로세서 백업이 올바른 파일 집합을 백업하지 않음

해결 방법:

백업을 두 번째로 실행하면 올바른 파일 세트가 백업됩니다.

160109014

업그레이드 후 캐시 부적중 비율 증가

버전 4.50.00으로 업그레이드한 후 프록시의 캐시 부적중 비율이 증가할 수 있습니다. 이러한 누락은 다음과 유사한 MP 로그의 오류 메시지 증가를 동반할 수 있습니다.

InvalidClassException when fetching cps cache entry from second level - com.apigee.jsonparser.LinkedJSONObject; local class incompatible: stream classdesc serialVersionUID = -8575741446425131573, local class serialVersionUID = 752634431212433936. Considering it as cache miss.

해결 방법:

없음 캐시 적중률은 시간이 지남에 따라 안정화될 것으로 예상됩니다.

159858015

본문이 비어 있고 Content-Encoding: gzip인 GET 요청에 대한 HTTP 408 응답

API 클라이언트가 Content-Encoding: gzip 헤더와 빈 요청 본문으로 GET 요청을 하면 408 제한 시간 응답을 받습니다.

해결 방법:

본문이 비어 있는 GET 요청을 할 때는 Content-Encoding 헤더를 생략합니다.

다음 단계

Edge for Private Cloud 4.50.00을 시작하려면 다음 링크를 사용하세요.

신규 설치 수:
새 설치 개요
기존 설치:
업그레이드 경로