4.19.06.10 - Private Cloud용 Edge 출시 노트

Apigee Edge 문서입니다.
Go to the Apigee X 문서로 이동합니다. info

2020년 9월 29일에 Private Cloud용 Apigee Edge의 새 버전이 출시되었습니다.

업데이트 절차

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

  • edge-gateway-4.19.06-0.0.20094.noarch.rpm
  • edge-management-server-4.19.06-0.0.20094.noarch.rpm
  • edge-message-processor-4.19.06-0.0.20094.noarch.rpm
  • edge-postgres-server-4.19.06-0.0.20094.noarch.rpm
  • edge-qpid-server-4.19.06-0.0.20094.noarch.rpm
  • edge-router-4.19.06-0.0.20094.noarch.rpm
  • apigee-mtls-4.19.06-0.0.20189.noarch.rpm
  • apigee-mtls-consul-4.19.06-0.0.20128.noarch.rpm
  • apigee-cassandra-2.1.16-0.0.2508.noarch.rpm
  • edge-ui-4.19.06-0.0.20164.noarch.rpm
  • edge-management-ui-static-4.19.06-0.0.20018.noarch.rpm
  • apigee-sso-4.19.06-0.0.20080.noarch.rpm
  • apigee-setup-4.19.06-0.0.1122.noarch.rpm

현재 설치된 RPM 버전을 확인하여 업데이트해야 하는지 알아보려면 다음을 입력하세요.

apigee-all version

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

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

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

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

    4. apigee-setup 유틸리티를 업데이트합니다. 
      sudo /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    5. source 명령어를 사용하여 apigee-service.sh 스크립트를 실행합니다. 
      source /etc/profile.d/apigee-service.sh

  2. 모든 Cassandra 노드를 업데이트합니다.

    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile

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

  3. 모든 Edge 노드에서 update.sh 프로세스의 edge 스크립트를 실행합니다. 이렇게 하려면 각 노드에서 다음 명령어를 실행합니다. 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

  4. Edge UI를 업데이트합니다.

    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  5. 모든 노드에서 SSO의 update.sh 스크립트를 실행합니다. 각 노드에서 다음 명령어를 실행합니다. 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile
  6. 새 Edge 환경을 사용하는 경우 다음 명령어를 실행합니다. 
    /opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
  7. Apigee mTLS를 사용하는 경우 Apigee mTLS 업그레이드에 설명된 절차를 따르세요.

    자세한 내용은 Apigee mTLS 소개를 참고하세요.

지원되는 소프트웨어

변경사항이 없습니다.

지원 중단 및 서비스 종료

새로운 지원 중단 또는 서비스 종료가 없습니다.

새로운 기능

이 섹션에서는 이번 출시 버전의 새로운 기능을 나열합니다.

JMX 비밀번호 암호화

이제 JMX 비밀번호를 암호화할 수 있습니다. 자세한 내용은 JMX 비밀번호 암호화 사용 설정 및 Cassandra용 JMX 인증 사용 설정을 참고하세요. (150633039)

수정된 버그

다음 표에는 이번 출시 버전에서 수정된 버그가 나와 있습니다.

문제 ID 설명
159360654

apigee-mtls 인증서는 30일 동안만 유효했습니다.

이제 새 인증서는 1년 동안 유효합니다. 1년 동안 유효한 새 인증서로 이전 30일 인증서를 업그레이드하려면 Apigee MTLS 업그레이드를 참고하세요.
147736003

enterprise.apigee.com의 오래된 라이브러리로 인해 보안 문제가 발생했습니다.

라이브러리가 업데이트되었습니다.
150594487

조직 수준의 Java 리소스 집합으로 인해 메시지 프로세서가 조직을 로드하지 못했습니다.
149739904

데이터 마스크 HTTP 헤더가 대소문자를 구분했습니다.

이 문제가 해결되었습니다. 이제 데이터 마스크가 대소문자를 구분하지 않습니다.
130416715

'True-Client-IP' 헤더로 인한 잠재적 취약점

이 출시 버전에서는 이 문제를 해결하는 새로운 액세스 제어 정책 요소인 IgnoreTrueClientIPHeader가 도입되었습니다. IgnoreTrueClientIPHeader 요소를 참고하세요.
161858295

일부 자동 변수가 잘못 입력되었습니다.

자동 설치 변수 SSO_JWT_SIGNING_KEY_FILEPATH 가 더 이상 잘못 입력되지 않습니다.
160951701

Consul 서버 문제로 인해 mTLS 설치가 실패했습니다.

Consul 바이너리가 v1.6.2에서 최신 안정화 버전인 v1.8.0으로 업그레이드되었습니다.
132654321

감사 로그에 역할이 업데이트된 사용자가 표시되지 않았습니다.

기존 사용자의 역할을 변경하거나 기존 사용자를 조직에 추가한 후 감사 로그에 '사용자 업데이트 정의되지 않음'이 표시되어 작업이 수행된 사용자를 확인할 수 없었습니다.
160916451

오래된 Consul 바이너리 버전으로 인해 mTLS 설치가 실패했습니다.

Consul 바이너리가 v1.6.2에서 최신 안정화 버전인 v1.8.0으로 업그레이드되었습니다.

이제 apigee-mtls가 네트워크 인터페이스와 주소가 여러 개인 서버를 올바르게 처리합니다.
161764596

패치 업데이트를 적용할 때 apigee-tomcat이 업데이트되지 않았습니다.

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

UI에서 프로토콜 사용 중지에 대한 문서가 누락되었습니다.

새 문서는 TLS 프로토콜 사용 중지를 참고하세요.

알려진 문제

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

문제 ID 설명
149245401

Ldap 정책 연결 풀링 문제

LDAP 리소스를 통해 구성된 JNDI의 LDAP 연결 풀 설정 이 반영되지 않으며 JNDI 기본값으로 인해 매번 일회용 연결이 발생합니다. 따라서 일회용으로 매번 연결이 열리고 닫히므로 LDAP 서버에 시간당 많은 연결이 생성됩니다.

해결 방법:

LDAP 연결 풀 속성을 변경하려면 다음 단계에 따라 모든 LDAP 정책에 전역 변경사항을 설정하세요.

  1. 구성 속성 파일이 아직 없는 경우 만듭니다 . 
    /opt/apigee/customer/application/message-processor.properties
  2. 파일에 다음을 추가합니다 (LDAP 리소스 구성 요구사항에 따라 Java Naming and Directory Interface (JNDI) 속성 값을 바꿈). 
    bin_setenv_ext_jvm_opts="-Dcom.sun.jndi.ldap.connect.pool.maxsize=20
-Dcom.sun.jndi.ldap.connect.pool.prefsize=2
-Dcom.sun.jndi.ldap.connect.pool.initsize=2
-Dcom.sun.jndi.ldap.connect.pool.timeout=120000
-Dcom.sun.jndi.ldap.connect.pool.protocol=ssl"
  3. 파일의 소유자가 apigee:apigee인지 확인합니다./opt/apigee/customer/application/message-processor.properties
  4. 각 메시지 프로세서를 다시 시작합니다.

연결 풀 JNDI 속성이 적용되는지 확인하려면 tcpdump를 실행하여 시간이 지남에 따라 LDAP 연결 풀의 동작을 관찰하면 됩니다.