4.51.00.12 - Private Cloud용 Edge 출시 노트

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

2023년 3월 30일에 프라이빗 클라우드용 Apigee Edge의 새 버전이 출시되었습니다.

참고: 이 버전은 2024년 3월 30일까지 지원됩니다.

업데이트 절차

이 섹션에서는 이전 패치 출시인 4.51.00.11에서 업데이트하는 경우 이 출시를 설치하는 방법을 설명합니다. 이전 버전에서 업데이트해야 하는 경우 여러 패치 버전 적용을 참고하세요.

이 버전을 설치하면 다음 RPM 목록의 구성요소가 업데이트됩니다.

  • edge-gateway-4.51.00-0.0.60186.noarch.rpm
  • edge-management-server-4.51.00-0.0.60186.noarch.rpm
  • edge-postgres-server-4.51.00-0.0.60186.noarch.rpm
  • edge-qpid-server-4.51.00-0.0.60186.noarch.rpm
  • edge-router-4.51.00-0.0.60186.noarch.rpm
  • apigee-postgresql-10.17-0.0.2535.noarch.rpm
  • edge-mint-gateway-4.51.00-0.0.40322.noarch.rpm
  • edge-mint-management-server-4.51.00-0.0.40322.noarch.rpm
  • edge-mint-message-processor-4.51.00-0.0.40322.noarch.rpm
  • apigee-sso-4.51.00-0.0.21244.noarch.rpm
  • apigee-attribution-4.51.00-0.0.723.noarch.rpm
  • apigee-sosreport-5.0-0.0.2508.noarch.rpm

다음 명령어를 입력하여 현재 설치된 RPM 버전을 확인하고 업데이트해야 하는지 확인할 수 있습니다.

apigee-all version

설치를 업데이트하려면 Edge 노드에서 다음 절차를 실행하세요.

  1. 모든 Edge 노드에서 다음을 실행합니다.

    1. Yum 저장소를 정리합니다. 
      sudo yum clean all
    2. 최신 Edge 4.51.00 bootstrap_4.51.00.sh 파일을 /tmp/bootstrap_4.51.00.sh에 다운로드합니다. 
      curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
    3. Edge 4.51.00 apigee-service 유틸리티 및 종속 항목을 설치합니다. 
      sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord

      여기서 uName 및 pWord은 Apigee에서 받은 사용자 이름과 비밀번호입니다. pWord를 생략하면 입력하라는 메시지가 표시됩니다.

    4. source 명령어를 사용하여 apigee-service.sh 스크립트를 실행합니다. 
      source /etc/profile.d/apigee-service.sh
  2. Postgres 노드 (마스터 및 대기)를 업데이트합니다. 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. 모든 에지 노드에서 에지 프로세스의 update.sh 스크립트를 실행합니다. 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  4. 모든 노드에서 SSO용 update.sh 스크립트를 실행합니다. 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile

새로운 기능

이번 출시에는 다음과 같은 새로운 기능이 도입되었습니다.

하위 트래픽을 위한 TLS 1.3

이 출시에서는 하위 트래픽 (메시지 프로세서와 백엔드 서버 간 트래픽)에 TLS 1.3 지원이 추가되었습니다. 자세한 내용은 다운스트림 트래픽에 TLS 1.3 구성을 참고하세요.

보안 문제 해결

이번 출시에서 해결된 보안 문제는 없습니다.

지원되는 소프트웨어 변경

이번 출시에서 지원되는 소프트웨어는 변경되지 않습니다.

지원 중단 및 사용 중단

이번 출시에는 새로운 지원 중단 또는 폐지가 없습니다.

버그 수정

이 섹션에는 이 출시에서 수정된 프라이빗 클라우드 버그가 나열되어 있습니다.

문제 ID 설명
197529839

조건 연산자 뒤에 후행 공백이 없어 배포가 실패했습니다.

이는 프록시의 조건문에서 줄바꿈 처리를 개선하여 해결되었습니다.
269545512

게이트웨이 및 수익 창출의 Postgres 드라이버 버전이 42.5.4로 업데이트되었습니다.
193007714

프록시의 대상 세부정보를 JSON으로 가져올 때 일부 속성이 누락되었습니다.

문제가 해결되었습니다.
245387101

개발자 앱 관련 API의 감사 데이터가 수정되었습니다.

이제 고객 보안 비밀이 마스킹된 방식으로 일관되게 로깅됩니다. 감사에서 일반 텍스트 보안 비밀을 로깅하려는 경우 관리 서버에서 CWC conf_keymanagement_app.auditlog.mask.secret를 false로 설정하여 보안 비밀이 마스킹되지 않도록 할 수 있습니다.
260013493

OASValidation 정책의 일부로 Open API 사양 리소스의 로딩을 최적화하는 수정사항이 추가되었습니다.

MP가 많은 OAS 리소스를 로드해야 하는 경우 메시지 프로세서 부팅 시간이 빨라집니다. 이렇게 하면 OAS 리소스가 포함된 프록시를 로드하는 동안 불필요한 오류 및 경고 로그가 생성되지 않습니다.
274587823

외부 항목은 XSLTransform 정책에서 기본적으로 로드할 수 없습니다.

메시지 프로세서에서 conf_feature-flags_xsl.allow.external.entities=true 플래그를 설정하여 사용 설정할 수 있습니다.
260714664

일부 Cassandra 테이블에서 기본적으로 SizeTieredCompactionStrategy을 사용하고 있었습니다.

LeveledCompactionStrategy로 변경되었습니다. 이 변경사항은 프라이빗 클라우드용 Apigee Edge의 신규 설치에만 적용됩니다.
261631942

일부 조건에서 구성 파일 백업이 실패하는 apigee-postgresql의 사전 설치 스크립트에서 사소한 회귀가 수정되었습니다.
258898812

앱 가져오기의 API 응답에서 예상치 못한 매개변수 credentialsLoaded이 삭제되었습니다.
272136041

최근 Apigee에 추가된 다음 API 필드가 프라이빗 클라우드용 Edge에 표시됩니다. 하지만 Edge for Private Cloud에서는 효과가 없으므로 이러한 오류가 발생하면 무시해도 됩니다.

  • proxy_deployment_type
  • sense_action_id
  • sense_flag_headers
  • x_apigee_grpc_status
  • x_apigee_grpc_service_name
  • x_apigee_grpc_rpc_name

알려진 문제

알려진 문제의 전체 목록은 프라이빗 클라우드용 Edge에서 알려진 문제를 참고하세요.

여러 패치 버전 적용

이 섹션에서는 이전 패치 출시 버전보다 이전 버전의 Edge for Private Cloud에서 업데이트하는 경우 여러 패치 버전을 적용하는 방법을 설명합니다.

각 패치 출시에는 edge-management-server와 같은 Edge for Private Cloud의 특정 구성요소에 대한 업데이트가 포함됩니다. 패치 버전을 여러 개 적용하려면 현재 설치된 버전보다 늦은 패치 버전에 포함된 각 Edge 구성요소를 업데이트해야 합니다. 현재 버전보다 최신 버전의 프라이빗 클라우드용 Edge 출시 노트를 살펴보고 해당 출시의 RPM 목록을 확인하면 이러한 구성요소를 찾을 수 있습니다. 모든 프라이빗 클라우드용 Edge 출시 노트 링크는 Apigee 출시 노트를 참고하세요.

참고: 패치 버전에 포함된 최신 버전의 구성요소용 RPM을 설치하여 각 구성요소를 한 번만 업데이트하면 됩니다. 해당 버전의 출시 노트에 나온 안내에 따라 구성요소를 업데이트합니다.

참고: 구성요소를 업그레이드하면 구성요소의 최신 패치 버전이 자동으로 설치됩니다. 최신 버전이 아닌 패치 버전으로 업그레이드하려면 Apigee 미러를 사용하여 Apigee 저장소의 자체 tarball 사본을 유지하고 Apigee 설치에 이 미러를 사용해야 합니다. 자세한 내용은 로컬 Edge 저장소를 사용하여 Edge 버전 유지를 참고하세요.