4.53.00.05 - Private Cloud용 Edge 출시 노트

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

2025년 7월 21일에 Apigee Edge for Private Cloud의 새 버전이 출시되었습니다.

업데이트 절차

이 섹션에서는 비공개 클라우드용 Edge의 이전 버전에서 업데이트하는 경우 이 출시 버전을 설치하는 방법을 설명합니다. 이전 출시 버전에서 업데이트해야 하는 경우 여러 패치 버전 적용을 참고하세요.

이 버전을 업데이트하면 아래에 나열된 구성요소가 업데이트됩니다.

  • edge-gateway-4.53.00-0.0.60310.noarch.rpm
  • edge-management-server-4.53.00-0.0.60310.noarch.rpm
  • edge-message-processor-4.53.00-0.0.60310.noarch.rpm
  • edge-postgres-server-4.53.00-0.0.60310.noarch.rpm
  • edge-qpid-server-4.53.00-0.0.60310.noarch.rpm
  • edge-router-4.53.00-0.0.60310.noarch.rpm
  • apigee-qpidd-8.0.6-0.0.2540.noarch.rpm
  • apigee-setup-4.53.00-0.0.1151.noarch.rpm
  • apigee-sso-4.53.00-0.0.21590.noarch.rpm
  • apigee-tomcat-9.0.106-0.0.957.noarch.rpm
  • edge-uapim-4.53.00-0.0.60313.noarch.rpm
  • edge-uapim-connector-4.53.00-0.0.60313.noarch.rpm
  • edge-mint-gateway-4.53.00-0.0.40542.noarch.rpm
  • edge-mint-management-server-4.53.00-0.0.40542.noarch.rpm
  • edge-mint-message-processor-4.53.00-0.0.40542.noarch.rpm

현재 설치된 RPM 버전을 확인하여 업데이트해야 하는지 확인할 수 있습니다.

apigee-all version

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

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

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

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

    4. source 명령어를 사용하여 apigee-service.sh 스크립트를 실행합니다. 
      source /etc/profile.d/apigee-service.sh
    5. apigee-setup 유틸리티를 업데이트합니다. 
      apigee-service apigee-setup update
  2. 모든 Edge 노드에서 edge 프로세스 (수익 창출 포함)에 대해 update.sh 스크립트를 실행합니다. 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  3. 모든 Qpid 노드에서 update.sh 스크립트를 실행합니다. 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. SSO를 사용하는 경우 다음 명령어를 실행합니다. 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile

버그 수정

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

문제 ID 설명
429056579 qpid의 wait_for_ready 스크립트가 수정되었습니다.
391852306 시간대 변경 후 수익 창출 거래 평가 실패를 수정했습니다.

개선 사항

이 섹션에는 이번 출시의 개선사항이 나열되어 있습니다.

문제 ID 설명
430665793 메시지 프로세서 부팅 중 키 및 인증서 작업에 관한 로깅을 추가했습니다.
366144787 개별 항목의 주문형 데이터 동기화를 용이하게 하기 위해 수익 창출 API가 추가되었습니다.

해결된 보안 문제

문제 ID 설명
391546513 수익 창출과 관련된 여러 보안 문제가 수정되었습니다.

프라이빗 클라우드용 Edge API 허브 커넥터 통합

이 출시에는 프라이빗 클라우드 통합을 위한 Apigee API 허브 커넥터 지원이 포함되어 있어 조직에서 API 메타데이터와 런타임 분석을 모두 Google Cloud API 허브에 동기화할 수 있습니다. 통합에는 새로운 Apigee API Hub 커넥터 바이너리와 런타임 데이터를 네트워크 파일 시스템 (NFS)으로 내보내는 메시지 프로세서의 개선사항이 포함됩니다. 프라이빗 클라우드용 API 허브 커넥터는 이 데이터를 사용하고 API 허브에 게시합니다. 기존 Private Cloud용 Apigee Edge 동작에 대한 버그 수정이나 변경사항은 없습니다. 프라이빗 클라우드용 Edge API 허브 커넥터 통합에 대한 자세한 내용은 API 허브 커넥터 통합 개요 및 흐름을 참고하세요.

주요 특징:

  • 새 Apigee API 허브 커넥터 바이너리
  • 런타임 데이터를 NFS로 내보내기 위한 메시지 프로세서 개선사항
  • API 메타데이터 및 런타임 데이터를 API 허브에 게시하는 기능 완전 지원
  • 프라이빗 클라우드 API 흐름을 위한 표준 Apigee API 허브 커넥터를 사용한 선택 기반 활성화
  • 환경 및 프록시 번들 업로드를 지원하는 커넥터와의 새로운 API 통합
  • 이제 커넥터의 서비스 계정에서 새 API 기능을 사용 설정하려면 새로운 IAM 권한 (roles/apihub.admin)이 필요합니다.

개인 식별 정보 (PII) 마스킹

이 기능을 사용하면 API 프록시 및 공유 흐름 번들 내의 민감한 정보를 API 허브에 동기화하기 전에 마스킹하여 데이터 개인 정보 보호 및 규정 준수를 보장할 수 있습니다.

  • 기본 마스크: 커넥터는 정책 구성에서 알려진 개인 식별 정보 소스를 마스킹하기 위해 기본 제공 XPath 표현식 목록 (기본 마스크)을 자동으로 적용합니다 (예: 하드코딩된 기본 인증 비밀번호, JWT/JWS 정책의 비공개 키).
  • 맞춤 마스크: /opt/apigee/customer/application/uapim-connector.properties 파일에서 conf_uapim_connector.uapim.mask.xpaths 속성을 설정하여 추가 맞춤 마스크를 구성할 수 있으므로 고객별 민감한 필드를 타겟팅할 수 있습니다.

조직 조정 (백필)

이제 커넥터는 기존 Apigee 조직의 전체 API 메타데이터 세트를 API 허브에 조정 (또는 백필)하기 위한 정의된 프로세스를 제공합니다.

  • 프로세스: 조직을 커넥터의 구성에서 일시적으로 선택 해제 (runtimeDataPubsub 및 metadataPubsub 속성 값 지우기)한 다음 즉시 다시 선택 (값 복원)하여 조정이 이루어집니다.
  • 기능: 이 작업은 커넥터가 지정된 조직의 모든 메타데이터를 완전히 가져오고 완전히 다시 동기화하도록 강제하여 잠재적인 데이터 불일치를 해결합니다.

지원되는 소프트웨어 변경사항

Tomcat v9.0.106이 지원됩니다. 지원되는 소프트웨어의 전체 목록은 프라이빗 클라우드용 Edge 지원 소프트웨어를 참고하세요.

지원 중단 및 중단

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

알려진 문제

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

여러 패치 버전 적용

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

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

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

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