4.50.00.11 - Private Cloud용 Edge 출시 노트

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

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

업데이트 절차

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

  • edge-analytics-4.50.00-0.0.40046.noarch.rpm
  • apigee-sso-4.50.00-0.0.21034.noarch.rpm
  • apigee-tomcat-8.5.64-0.0.917.noarch.rpm
  • apigee-machinekey-1.1.0-0.0.20008.noarch.rpm
  • apigee-lib-4.50.00-0.0.1019.noarch.rpm
  • apigee-cassandra-2.1.22-0.0.2527.noarch.rpm
  • apigee-cassandra-client-2.1.22-0.0.2512.noarch.rpm
  • apigee-setup-4.50.00-0.0.1128.noarch.rpm
  • apigee-service-4.50.00-0.0.1428.noarch.rpm
  • apigee-configutil-4.50.00-0.0.613.noarch.rpm
  • edge-gateway-4.50.00-0.0.20140.noarch.rpm
  • edge-management-server-4.50.00-0.0.20140.noarch.rpm
  • edge-message-processor-4.50.00-0.0.20140.noarch.rpm
  • edge-postgres-server-4.50.00-0.0.20140.noarch.rpm
  • edge-qpid-server-4.50.00-0.0.20140.noarch.rpm
  • edge-router-4.50.00-0.0.20140.noarch.rpm
  • edge-mint-gateway-4.50.00-0.0.30233.noarch.rpm
  • edge-mint-management-server-4.50.00-0.0.30233.noarch.rpm
  • edge-mint-message-processor-4.50.00-0.0.30233.noarch.rpm
  • edge-management-ui-4.50.00-0.0.20020.noarch.rpm
  • edge-ui-4.50.00-0.0.20198.noarch.rpm
  • edge-management-ui-static-4.50.00-0.0.20033.noarch.rpm
  • apigee-validate-4.50.00-0.0.624.noarch.rpm
  • apigee-mtls-4.50.00-0.0.20224.noarch.rpm
  • apigee-adminapi-4.50.00-0.0.607.noarch.rpm

다음을 입력하여 현재 설치된 RPM 버전을 확인하고 업데이트가 필요한지 확인할 수 있습니다.

apigee-all version

설치를 업데이트하려면 에지 노드에서 다음 절차를 수행합니다.

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

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

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

    4. apigee-setup 유틸리티를 업데이트합니다.
      sudo /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    5. apigee-lib 유틸리티를 업데이트합니다.
      sudo /opt/apigee/apigee-service/bin/apigee-service apigee-lib update
    6. source 명령어를 사용하여 apigee-service.sh 스크립트를 실행합니다.
      source /etc/profile.d/apigee-service.sh
  2. 관리 서버에서 apigee-validate 유틸리티를 업데이트합니다.
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  3. apigee-adminapi 유틸리티를 업데이트합니다.
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  4. apigee-machinekey 유틸리티를 업데이트합니다.
    /opt/apigee/apigee-service/bin/apigee-service apigee-machinekey update
  5. apigee-config 유틸리티 업데이트:
    /opt/apigee/apigee-service/bin/apigee-service apigee-configutil update
  6. 모든 Cassandra 노드를 업데이트합니다.
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile

    여기서 configFile은 Private Cloud용 Apigee Edge를 설치하는 데 사용한 구성 파일을 지정합니다. 예를 들면 다음과 같습니다. /opt/silent.conf

  7. 모든 Edge 노드에서 에지 프로세스에 대해 update.sh 스크립트를 실행합니다.
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. 모든 노드에서 SSO를 위한 update.sh 스크립트를 실행합니다.
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile
  9. 모든 노드에서 UI의 update.sh 스크립트를 실행합니다.
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  10. New Edge 환경을 사용하는 경우 다음 명령어를 실행합니다.
    /opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
  11. Apigee mTLS를 사용하는 경우 Apigee mTLS 업그레이드에 설명된 절차를 따르세요. 자세한 내용은 Apigee mTLS 소개를 참조하세요.

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

이 릴리스에서 지원되는 소프트웨어는 변경되지 않습니다.

지원 중단 및 중단

이 버전에는 새로운 지원 중단이나 지원 중단이 없습니다.

새로운 기능

이 릴리스에서는 다음과 같은 새로운 기능을 제공합니다.

Nodetool 복구 도구 주변의 새로운 래퍼

래퍼는 노드 도구 복구를 실행하기 전에 Cassandra가 마운트된 디스크 공간에서 상태 검사를 실행합니다. 래퍼는 JMX 인증 및 JMX 관련 구성을 통한 SSL도 지원합니다.

LDAP 정책에 <BaseDN> 요소의 동적 문자열 대체 지원을 추가했습니다.

LDAP 정책의 <BaseDN> 요소는 모든 데이터가 존재하는 LDAP의 기본 수준을 지정합니다. 이 버전에서는 요소에 ref 속성을 추가했습니다. 이 속성을 사용하여 <BaseDN> 값이 포함된 흐름 변수(예: apigee.baseDN)를 지정할 수 있습니다. ref는 명시적인 BaseDN 값보다 우선합니다. ref와 값을 모두 지정하면 ref이 우선순위를 갖습니다. ref가 런타임 시 확인되지 않으면 값이 사용됩니다.

버그 수정

이 섹션에는 이번 출시 버전에서 수정된 Private Cloud 버그가 나열되어 있습니다.

문제 ID 설명
197513151

기본 UI의 일관되지 않은 jQuery 스크립트 경로 수정

151852439

.properties 파일의 구성 오류로 인해 UI용 향상된 로깅에 실패했습니다.

이 문제가 해결되었습니다.
194875545

개발자 앱 페이지에서 개발자로 이동하는 중에 404 오류 발생

이 문제가 해결되었습니다.
179769806

회사가 Edge UI에 표시되지 않음

이 문제가 해결되었습니다.
188039112

Edge UI의 자체 서명 인증서 신뢰 문제

이 문제가 해결되었습니다.
195932618

console.log()로 인해 과도한 로깅이 발생함

이 문제가 해결되었습니다.
193216745

Cassandra 설정 스크립트에서 데이터 센터 이름을 정렬하는 방식에 사소한 버그가 있었습니다.

이 문제가 해결되었습니다.
1195932115

Apigee SSO가 응답에서 스택 트레이스를 잘못 반환했습니다.

이 문제가 해결되었습니다. 스택 트레이스는 계속 로깅됩니다.
79591934

apigee-validate가 모호한 메시지로 인해 실패함

이 문제가 해결되었습니다. apigee-validate 스크립트의 오류 로깅이 개선되었습니다.
174732169

시스템 로그 메시지가 잘못 삭제됨

이 문제가 해결되었습니다.
193239069

게이트웨이 및 Machinekey 구성요소에서 기존 키 삭제

197760258

권한 API 오류로 인해 Edge UI와 게이트웨이 간 호환성 문제가 발생함

외부 LDAP 인증이 사용 설정되었을 때 발생하던 이 문제는 해결되었습니다.
194485178

모든 HTTP 요청 및 응답 한도 속성에서 후행 및 선행 공백을 삭제했습니다.

193918953

게이트웨이 구성요소에서 일부 사용되지 않는 구성 삭제됨

112262604

Postgres 장애 조치를 수행할 때 Mint Management Server를 업데이트해야 함

Mint Management 서버의 Postgres 연결 세부정보를 변경하기 위해 향상된 스크립트가 생성되었습니다. PostgreSQL 데이터베이스 장애 조치 처리를 참조하세요.
197301743

큰 SSL 핸드셰이크 메시지로 자바 1.8.0_3XX에서 문제가 발생함

이 문제가 해결되었습니다.
188526117

ip 명령어에 절대 경로가 앞에 붙지 않음

이 문제가 해결되었습니다. 이제 Apigee 스크립트가 명령어의 전체 경로를 한정합니다.
171240470

Cassandra JMX 인증 또는 SSL이 사용 설정된 경우 관리 업데이트에 실패함

Management 서버에서 설정 또는 업데이트를 실행할 때 Cassandra JMX 인증 및 SSL 구성을 제공하는 기능을 추가했습니다.
193564174

Edge UI 분석 대시보드에서 데이터를 가져올 수 없음

이름에 마침표가 있는 환경에서 애널리틱스 쿼리가 실패하는 버그가 수정되었습니다.
167960487

측정기준 텍스트 내의 예약된 키워드 및/또는 예약된 키워드 때문에 애널리틱스 보고서에 실패했습니다.

이 문제가 해결되었습니다.
132402519

router.properties의 IP 주소 목록에 추가 공백이 있어 라우터가 표시되지 않음

이 문제가 해결되었습니다. 이제 추가 공백이 삭제됩니다.
184573211

Apigee SSO 모듈에서 Java Management Extensions (JMX)가 더 이상 기본적으로 사용 설정되지 않습니다.

보안 문제 해결됨

다음은 이번 버전에서 해결된 알려진 보안 문제 목록입니다. 이러한 문제를 방지하려면 최신 버전의 Edge Private Cloud를 설치하세요.

문제 ID 설명
N/A

구성 파일 델타 변경사항이 정상적으로 로깅되어 비밀번호가 Private Cloud용 Edge에 로깅되었습니다. 다음과 같이 구성 변경사항의 로깅을 방지할 수 있습니다.

  • Edge 구성요소가 이미 설치되어 있으면 다음 단계 중 하나를 따릅니다.
    • LOGGER_PRINT_CONFIG_DELTA=false를 환경 변수로 설정합니다. 이렇게 하면 해당 노드의 모든 구성요소에 대한 구성 델타 로깅이 중지됩니다.
    • 특정 구성요소의 구성 델타 로깅을 중지하려면 해당 구성요소의 고객별 구성 파일에 logger.print.config.delta=false을 추가합니다. 이렇게 하면 해당 구성요소의 구성 변경사항 로깅이 중지됩니다. 자세한 내용은 Edge 구성 방법을 참조하세요.
  • Edge 구성요소를 설치하는 경우 silent.conf 파일에
    CONFIG_DELTA_LOG=n
    항목을 추가하여 구성 변경사항이 로깅되지 않도록 할 수 있습니다.

    이렇게 하면 구성요소가 구성 변경사항을 로깅하지 않도록 구성합니다.

N/A 플랫폼에 저장된 비밀번호 및 관련 데이터의 보안이 강화됩니다.
CVE-2015-9251 jQuery에서 dataType 옵션 없이 교차 도메인 Ajax 요청을 수행할 때 교차 사이트 스크립팅 (XSS)이 수정되었습니다.
N/A SAML 어설션 재전송 공격에 대한 추가적인 보호 조치를 추가했습니다.

알려진 문제

알려진 문제의 전체 목록은 Private Cloud용 Edge의 알려진 문제를 참조하세요.