4.19.06 Edge for Private Cloud 출시 노트

Apigee Edge 문서를 보고 있습니다.
Apigee X 문서를 확인하세요.

이 섹션에서는 프라이빗 클라우드 기능 출시 버전의 4.19.06 버전을 설명합니다.

출시 요약

다음 표에는 이번 버전의 변경사항이 요약되어 있습니다.

새로운 기능

이번 출시 버전에는 다음과 같은 새로운 기능이 포함됩니다.

○ SSO를 위한 LDAP 지원
○ HTTP 배포 지원
○ 플러그인 가능한 분석
○ Cassandra 랙 지원
○ IPv6 지원
○ 간소화된 새 Edge 환경 설치
INVALID_TSC 트랜잭션 제외 (수익 창출)

새로운 각 기능에 대한 자세한 내용은 새로운 기능을 참조하세요.

이전 버전과의 호환성

이 버전의 Private Cloud용 Apigee Edge에는 이전 버전과의 호환성에 영향을 미치는 다음 문제가 발생했습니다.

     
  • 문제 132443137의 수정으로 인해 (19.03.01 퍼블릭 클라우드 출시 노트의 설명 참조) 이제 메시지 프로세서는 X-Apigee-*로 시작하는 헤더를 무시합니다. 따라서 X-Apigee-* 헤더를 사용하는 코드를 리팩터링하고 이러한 헤더를 지원되는 헤더로 교체해야 합니다.

  • Cassandra 로그 파일의 이름이 변경되었습니다. 현재 시각:

    /opt/apigee/var/log/apigee-cassandra/system.log
포함된 출시 버전

이전 프라이빗 클라우드 기능 출시 버전 이후 다음 버전이 발생했으며 이 출시에 포함되었습니다.

○ 에지:
   19.07.23 (UI)
   19.03.01
   19.02.19
   19.02.04
   19.01.23
} 1.1.1


○ 포털:
   19.07.08
   19.05.23
   19.05.08
   19.04.18
   19.13.20
{11.2202


은퇴 없음
지원 중단

4.19.06 출시부터는 다음 지원이 중단됩니다.

  • 4.18.01: 프라이빗 클라우드용 Apigee Edge 버전 4.18.01이 지원 중단되었습니다.

자세한 내용은 Apigee 지원 중단, 사용 중지, CPS 변경사항을 참고하세요.

버그 수정

이번 출시에는 다음과 같은 버그가 수정되었습니다.

○ (9)










HEAD

각 수정사항에 관한 자세한 내용은 버그 수정을 참고하세요.

알려진 문제

이 버전에는 다음과 같은 알려진 문제가 있습니다.

○ Mint가 처음에 트랜잭션을 평가하지 않음(141628497)
○ 1 종목 1 종합 정책 1 2





apigee-monit

해결 방법을 포함하여 알려진 각 문제에 관한 자세한 내용은 알려진 문제를 참조하세요.

업그레이드 경로

다음 표는 이 버전의 업그레이드 경로를 보여줍니다.

4.19.01부터 직접 4.19.01에서 4.19.06으로 업그레이드
4.18.05부터 직접 4.18.05에서 4.19.06으로 업그레이드
4.18.01부터 직접 4.18.01에서 4.19.06으로 업그레이드

새로운 기능

이 섹션에는 이 버전의 새로운 기능이 나와 있습니다. 또한 이 버전에는 포함된 출시에 나열된 Edge UI, Edge 관리, 포털 출시 버전의 모든 기능이 포함되어 있습니다.

이 개선사항에는 다음과 같은 개선사항 외에도 여러 사용성, 성능, 보안 및 안정성 개선사항이 포함되어 있습니다.

HTTP 배포 지원

기본적으로 Edge는 RPC를 사용하여 API 프록시를 배포합니다. 이 모드는 대부분의 설치에서 잘 작동하지만 MP를 통해 많은 수의 동시 호출이 발생하는 경우 MP가 많은 대규모 토폴로지에서 시간 초과가 발생할 수 있습니다.

따라서 Apigee에서는 대규모 배포에는 배포에 RPC가 아닌 HTTP를 사용하는 것이 좋습니다. 이제 HTTP 배포 사용 설정이 지원됩니다.

자세한 내용은 HTTP 배포 사용 설정을 참조하세요.

Cassandra 랙 지원

이제 Apigee에서 Apigee Edge용 프라이빗 클라우드 랙을 인식하여 Cassandra의 확장 작업에 대한 일반적인 안내를 제공합니다.

자세한 내용은 Cassandra 랙 지원을 참조하세요.

플러그인 가능한 분석

기본적으로 메시지 프로세서에서 수집한 분석 데이터는 처리를 위해 Qpid 및 Postgres에 업로드됩니다. 그러면 Edge UI에서 분석 데이터를 볼 수 있습니다.

이 기능을 사용하면 분석 데이터를 디스크에 쓰도록 메시지 프로세서를 구성하거나 두 옵션을 모두 사용하도록 선택할 수 있습니다.

자세한 내용은 파일에 분석 데이터 쓰기를 참고하세요.

간소화된 New Edge 환경 설치

새 스크립트로 New Edge 환경 설치가 간소화되었습니다.

자세한 내용은 새 Edge 환경 설치하기를 참고하세요.

LDAP IDP 지원

이제 Edge UI 및 Edge Management API 호출을 통한 사용자 인증이 SAML 외에 LDAP도 지원합니다. LDAP 지원에는 직접 바인딩과 간접 바인딩 방법이 모두 포함됩니다.

자세한 내용은 외부 IDP 인증 개요를 참조하세요.

IPv6 지원

기본적으로 프라이빗 클라우드용 Apigee Edge에 대한 모든 런타임 API는 IPv4를 사용합니다. 새 속성으로 라우터에 IPv6 지원을 추가할 수 있습니다.

자세한 내용은 라우터에서 IPv6 사용을 참조하세요.

거래 INVALID_TSC개 제외 (수익 창출)

이제 수익 창출을 사용할 때 INVALID_TSC 트랜잭션이 Postgres 데이터베이스에 추가되지 않도록 제외할 수 있습니다.

자세한 내용은 수익 창출 서버 속성을 참조하세요.

지원되는 소프트웨어

지원되는 소프트웨어에 다음과 같은 변경사항이 적용되었습니다.

지원 추가됨 더 이상 지원되지 않음

이 출시 버전에서는 다음 플랫폼에 대한 지원이 추가되었습니다.

  • Red Hat Enterprise Linux (RHEL) 6.10
  • CentOS 6.10
  • Oracle Linux 6.9

이 출시 버전에서는 다음 플랫폼이 더 이상 지원되지 않습니다.

  • Red Hat Enterprise Linux (RHEL) 6.9
  • CentOS 6.9
  • Oracle 6.8

지원되는 플랫폼의 전체 목록은 지원되는 소프트웨어 및 지원 버전을 참고하세요.

버그 수정

이 섹션에는 이 버전에서 수정된 Private Cloud 버그가 나와 있습니다. 또한 이 버전에는 포함된 버전에 나와 있는 Edge UI, Edge 관리, 포털 출시 버전의 모든 버그가 수정되었습니다.

문제 ID 설명
140270474

UseStringDeduplicate 설정되지 않음

프로덕션 환경의 UseStringDeduplicationedge-message-processor 구성요소에 설정되지 않았습니다.
111445518

MP 오류

메시지 프로세서가
2019-06-29 00:02:05,775 Apigee-Timer-6 ERROR CMgmt -
  ConnectorServiceImpl.refreshToken() : Connector Management API auth token
  generation failed: 0 null
오류 메시지를 5분마다 지속적으로 기록했습니다.
113342838

JMX로 Cassandra 실패

JMX 인증이 사용 설정된 경우 Cassandra 작업이 작동하지 않음
138931337

노드 13개 업그레이드

17.09, 18.01, 18.05에서 13개 노드 설치의 업그레이드가 실패했습니다.
119802562

동일한 이름의 프록시

동일한 조직의 두 사용자가 이름이 동일한 프록시를 만든 경우 두 번째 생성된 사용자가 첫 번째를 덮어씁니다. 이는 다른 사용자가 다른 프록시를 볼 수 없는 경우에만 발생했습니다.
118851790

키 저장소가 로드되지 않음

조직/환경의 키 저장소가 100개를 초과하면 Edge UI의 키 저장소 및 참조 섹션이 로드되지 않았습니다. 대신 UI에 Internal Error (Error Fetching Keystores) 오류가 표시되었습니다.
110988191

애널리틱스 실패

향후 날짜로 설정된 Micro Gateway의 데이터가 제공되면 환경에 대한 분석이 실패했습니다.
110785400

백업 실패

ZooKeeper, Cassandra, OpenLDAP가 다음 오류와 함께 데이터를 간헐적으로 백업하지 못했습니다. File changed as we read it.
79993247

Node.js에 대한 HEAD 요청

Node.js 대상에 대한 HEAD 요청이 중단될 수 있으며 이로 인해 연결이 대기 중입니다.
70291825

apigee-postgres 백업/복원

이제 Apigee-postgres 백업/복원을 실행하면 모든 구성요소의 데이터가 백업됩니다.
65737520

sysadmin 비밀번호 재설정하기

특수문자가 포함된 관리 서버의 시스템 관리자 비밀번호를 재설정하지 못합니다.

알려진 문제

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

문제 ID 설명
141628497

처음에 거래를 평가하지 않는 Mint

프라이빗 클라우드용 Edge는 조직에서 수익 창출을 처음 사용 설정할 때 처음에는 거래를 평가하지 않습니다. 이는 신규 및 기존 조직에 적용됩니다.

수익 창출 사용 설정 API는 작업 ID로 응답하며, 완료 시 작업 상태가 성공으로 표시됩니다. 하지만 처음에 수익을 창출한 API 호출은 수익 창출에 의해 처리되지 않으며 등급이 지정되지 않습니다. 이러한 거래는 일반 분석에만 표시됩니다.

해결 방법:

다음을 수행할 수 있는 메시지 프로세서 (MP)를 다시 시작합니다.
apigee-service edge-message-processor restart

수익 창출을 사용 설정한 후 MP를 다시 시작하면 Edge가 시작 시 ZooKeeper에서 구성을 로드합니다. 이 문제는 다시 시작할 때마다 발생하므로 해당 문제는 처음에만 적용됩니다.

137865184

민트 평가 서버 메모리 누수

새 Qpid 인스턴스가 mxgroup에 등록되면 대기열이 소비자 없이 빌드되므로 사용 가능한 모든 리소스를 사용할 때까지 대기열 깊이가 커집니다.

해결 방법:

없음
135616498

apigee-sso 설치를 위한 메타데이터 파일 형식

apigee-sso를 설치하고 URL 대신 metadata.xml 파일을 사용하는 경우, 메타데이터 끝에 XML 줄 바꿈 (CRLF)이 포함되어 있지 않으면 metadata.xml 파일을 완전히 읽지 못합니다.

해결 방법:

이 문제를 해결하려면 다음 중 하나를 실행하세요.

  • metadata.xml 파일의 끝에 CRLF 추가

    또는

  • 메타데이터에 URL 기반 위치 사용
122370980

Amazon Linux 1에서 apigee-monit 지원되지 않음

해결 방법:

없음
121095148

메시지 프로세서 백업이 올바른 파일을 백업하지 않음

해결 방법:

백업을 두 번 실행하면 올바른 파일 세트가 백업됩니다.

76087166

여러 데이터 센터 구성의 DataAccessException

여러 데이터 센터 구성에서 하나의 Datastore를 사용할 수 없게 되면 다음 오류가 표시될 수 있습니다.

DataAccessException: Error while accessing datastore;
Please retry later

그 결과, 관리 서버가 dc-1 및 dc-2에서 모두 Cassandra 노드에 연결을 시도하기 때문에 관리 서버가 시작되지 않을 수 있습니다. DataAccessExceptions는 Cassandra 노드가 다운된 경우에 발생합니다. 이로 인해 메시지 프로세서가 KVM을 검색하려고 시도하는 동안 DataAccessExceptions을 보고하는 API 트래픽 중단이 발생할 수도 있습니다.

예상 상태는 관리 서버가 여러 리전의 Datastore 구성요소에 연결되지 않는 상태라는 점에 유의하세요.

해결 방법

해결 방법은 사용할 수 없는 데이터 센터에서 다음 Cassandra 노드 유형을 등록 취소하고 Cassandra 노드를 다시 사용할 수 있게 된 후 다시 등록하는 것입니다.

  • kms-datastore
  • dc-datastore
  • keyvaluemap-datastore

이러한 Cassandra 노드 유형을 등록 취소하고 재등록하려면 다음 안내를 따르세요.

  1. 다음 curl 명령어를 사용하여 Cassandra 노드의 UUID를 가져옵니다.
    curl -u ADMIN_EMAIL:ADMIN_PW \
      "http://MS_IP:MS_PORT/v1/servers?region=REGION&pod=GATEWAY_POD \
      &type=CASSANDRA_NODE_TYPE"

    각 항목의 의미는 다음과 같습니다.

    • ADMIN_EMAILADMIN_PW는 Apigee 계정의 사용자 인증 정보입니다.
    • MS_IPMS_PORT는 관리 서버의 IP 주소 및 포트 번호입니다.
    • REGION은 관리 서버가 있는 데이터 센터의 이름입니다.
    • GATEWAY_POD는 포드 이름이며 기본적으로 '게이트웨이'입니다. 하지만 다른 이름으로 변경했을 수도 있으므로 구현을 확인하세요.
    • CASSANDRA_NODE_TYPEkms-datastore, dc-datastore, keyvaluemap-datastore 중 하나입니다.

    예를 들면 다음과 같습니다.

    curl -u nickdanger@google.com:myP@$$w0rD
      "http://192.168.0.1:8080/v1/servers?region=dc-1&pod=gateway&type=dc-datastore"

    응답에는

    {
      "internalIP" : "POD_IP_ADDRESS",
      "isUp" : [true|false],
      "pod" : "GATEWAY_POD",
      "reachable" : [true|false],
      "region" : "dc-1",
      "tags" : {
        "property" : [ ]
      },
      "type" : [ "kms-datastore", "dc-datastore", "keyvaluemap-datastore" ],
        "uUID" : "POD_UUID"
    }
    형식이 사용됩니다.

    예를 들면 다음과 같습니다.

    {
      "internalIP" : "192.168.1.11",
      "isUp" : false,
      "pod" : "gateway",
      "reachable" : false,
      "region" : "dc-1",
      "tags" : {
        "property" : [ ]
      },
      "type" : "dc-datastore",
      "uUID" : "13cee956-d3a7-4577-8f0f-1694564179e4"
    }

    응답의 uUID 필드 값을 기록합니다. 이를 사용하여 노드를 등록 취소합니다.

  2. 각 Cassandra 노드 유형(kms-datastore, dc-datastore, keyvaluemap-datastore)에 1단계를 반복합니다. 반환되는 UUID를 기록해 두세요.
  3. 다음 명령어를 사용하여 노드를 등록 취소합니다.
    curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers/UUID" -X DELETE

    여기서 UUID는 이전 명령어의 응답에서 반환된 UUID입니다.

  4. 1단계와 2단계에서 수집한 각 UUID에 3단계를 반복합니다.
  5. 다음 명령어를 사용하여 노드를 다시 등록합니다.
    curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers -d \
      "Type=kms-datastore&Type=dc-datastore&Type=keyvaluemap-datastore& \
      Type=counter-datastore&Type=cache-datastore&InternalIP=POD_IP_ADDRESS& \
      region=REGION&pod=GATEWAY_POD" -H \
      'content-type: application/x-www-form-urlencoded' -X POST

이러한 작업은 Zookeeper에서 노드를 등록 및 등록 취소하며 Cassandra 클러스터에는 영향을 미치지 않습니다. 이러한 명령어에 대한 자세한 내용은 Datastore 등록 업데이트를 참조하세요.

68722102

로그 메시지에 추가 정보가 포함된 MessageLogging 정책

MessageLogging 정책의 FormatMessage 요소는 로깅되는 메시지의 형식을 제어합니다. FormatMessage=false인 경우 로깅된 메시지에 Apigee에서 생성한 정보가 포함되지 않습니다. 하지만 FormatMessage=false를 설정해도 로그 메시지에는 다음 정보가 포함됩니다.

  • 우선순위 점수
  • 타임스탬프

해결 방법:

없음

다음 단계

Edge for Private Cloud 4.19.06을 시작하려면 다음 링크를 사용하세요.

신규 설치 수:
새 설치 개요
기존 설치:
업그레이드 경로