4.19.06.10 - Private Cloud용 Edge 출시 노트

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

2020년 9월 29일에 프라이빗 클라우드용 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는 프라이빗 클라우드용 Apigee Edge를 설치하는 데 사용한 구성 파일을 지정합니다. 예를 들면 다음과 같습니다. /opt/silent.conf

  3. 모든 Edge 노드에서 edge 프로세스의 update.sh 스크립트를 실행합니다. 이렇게 하려면 각 노드에서 다음 명령어를 실행합니다. 
    /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. /opt/apigee/customer/application/message-processor.properties 파일의 소유자가 apigee:apigee인지 확인합니다.
  4. 각 메시지 프로세서를 다시 시작합니다.

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