4.19.06 Private Cloud용 Edge 출시 노트

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

이 섹션에서는 Private Cloud용 Edge 기능 출시 버전 4.19.06을 설명합니다.

버전 요약

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

새로운 기능

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

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

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

이전 버전과의 호환성

이 버전의 프라이빗 클라우드용 Apigee Edge에는 하위 호환성에 영향을 미치는 다음 문제가 도입되었습니다.

     
  • 19.03.01 공개 클라우드 출시 노트에 설명된 대로 문제 132443137이 수정됨에 따라 이제 메시지 프로세서가 X-Apigee-*로 시작하는 헤더를 무시합니다. 따라서 X-Apigee-* 헤더를 사용하는 코드를 리팩터링하고 지원되는 헤더로 대체해야 합니다.

  • Cassandra 로그 파일의 이름이 변경되었습니다. 이제 다음과 같습니다.

    /opt/apigee/var/log/apigee-cassandra/system.log
포함된 발표곡

이전 Edge for Private Cloud 기능 출시 이후 다음 출시가 있었으며 이 출시에 포함됩니다.

○ Edge:
   19.07.23 (UI)
   19.03.01
   19.02.19
   19.02.04
   19.01.23
   19.01.14
   18.12.04
   18.08.31
   18.07.31
○ 포털:
   19.07.08
   19.05.23
   19.05.08
   19.04.18
   19.03.20
   19.02.27
   19.02.21
   19.02.04
   19.01.16
중단 없음
지원 중단

4.19.06이 출시되면서 다음이 지원 중단됩니다.

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

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

버그 수정

이번 출시에는 다음과 같은 버그 수정이 포함되어 있습니다.

○ UseStringDeduplication이 설정되지 않음 (140270474)
○ MP 오류 (111445518)
○ JMX를 사용한 Cassandra 실패 (113342838)
○ 13노드 업그레이드 (138931337)
○ 이름이 동일한 프록시 (119802562)
○ 키 저장소가 로드되지 않음 (118851790)
○ 분석 실패 (110988191)
○ 백업 실패 (110785400)
○ Node.js에 대한 HEAD 요청 (79993247)
○ apigee-postgres 백업/복원 (70291825)
○ 시스템 관리자 비밀번호 재설정 (65737520)

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

알려진 문제

이 출시에는 다음과 같은 알려진 문제가 포함되어 있습니다.

○ Mint에서 처음에는 거래를 평가하지 않음 (141628497)
○ Mint 평가 서버 메모리 누수 (137865184)
○ apigee-sso 설치를 위한 메타데이터 파일 형식 (135616498)
○ Amazon Linux 1에서 apigee-monit이 지원되지 않음 (122370980)
○ 메시지 프로세서 백업이 올바른 파일 집합을 백업하지 않음 (121095148)
○ 다중 데이터 센터 구성의 DataAccessExceptions (76087166)
○ 로그 메시지에 추가 정보가 포함된 MessageLogging 정책 (68722102)

해결 방법을 비롯한 각 알려진 문제에 대한 자세한 내용은 알려진 문제를 참고하세요.

업그레이드 경로

다음 표에는 이번 출시의 업그레이드 경로가 나와 있습니다.

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가 많은 대규모 토폴로지의 경우 RPC를 통해 많은 동시 호출이 이루어지면 제한 시간이 초과될 수 있습니다.

따라서 Apigee에서는 대규모 배포의 경우 배포에 RPC 대신 HTTP를 사용하는 것이 좋습니다. 이제 HTTP 배포를 사용 설정할 수 있습니다.

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

Cassandra 랙 지원

이제 Apigee는 Apigee Edge for Private Cloud의 Cassandra를 랙 인식으로 만들어 Cassandra의 확장 작업에 관한 일반적인 안내를 제공합니다.

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

플러그인 가능한 분석

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

이 기능 출시를 통해 메시지 프로세서를 구성하여 분석 데이터를 디스크에 쓸 수 있으며, 두 옵션을 모두 사용할 수도 있습니다.

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

간소화된 새 Edge 환경 설치

새 스크립트를 통해 새로운 Edge 환경의 설치가 간소화되었습니다.

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

LDAP IDP 지원

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

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

IPv6 지원

기본적으로 Private Cloud용 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

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

버그 수정

이 섹션에는 이 출시에서 수정된 비공개 클라우드 버그가 나열되어 있습니다. 또한 이 버전에는 포함된 버전에 표시된 Edge UI, Edge 관리, 포털 버전의 모든 버그 수정이 포함되어 있습니다.

문제 ID 설명
140270474

UseStringDeduplication이 설정되지 않음

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

MP 오류

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

애널리틱스 실패

미래 날짜로 설정된 Microgateway의 데이터가 제공되면 환경의 분석이 실패합니다.
110785400

백업 실패

ZooKeeper, Cassandra, OpenLDAP가 다음 오류로 인해 데이터를 올바르게 백업하지 못하는 문제가 간헐적으로 발생했습니다. File changed as we read it.
79993247

Node.js에 대한 HEAD 요청

Node.js 타겟에 대한 HEAD 요청이 중단되어 연결이 대기 상태로 남을 수 있습니다.
70291825

apigee-postgres 백업/복원

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

시스템 관리자 비밀번호 재설정

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

알려진 문제

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

문제 ID 설명
141628497

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

조직의 수익 창출을 처음 사용 설정하면 Edge for the Private Cloud에서 처음에는 거래를 평가하지 않습니다. 이는 신규 및 기존 조직에 적용됩니다.

수익 창출 사용 설정 API는 작업 ID로 응답하며, 완료되면 작업 상태가 성공으로 표시됩니다. 하지만 처음 이루어진 수익 창출 API 호출은 수익 창출에 의해 처리되지 않으며 평가되지 않습니다. 이러한 거래는 일반 애널리틱스에만 표시됩니다.

해결 방법:

다음과 같이 메시지 프로세서 (MP)를 다시 시작합니다.
apigee-service edge-message-processor restart

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

137865184

민트 평점 서버 메모리 누수

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

해결 방법:

없음
135616498

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

apigee-sso를 설치하고 URL 대신 metadata.xml 파일을 사용하는 경우 metadata.xml 파일 끝에 새 줄 (CRLF)이 포함되지 않으면 metadata.xml 파일이 완전히 읽히지 않습니다.

해결 방법:

이 문제를 해결하려면 다음 중 하나를 수행하면 됩니다.

  • metadata.xml 파일 끝에 CRLF 추가

    또는

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

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

해결 방법:

없음
121095148

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

해결 방법:

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

76087166

여러 데이터 센터 구성의 DataAccessException

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

DataAccessException: Error while accessing datastore;
Please retry later

그 결과 관리 서버가 dc-1과 dc-2 모두에서 Cassandra 노드에 연결하려고 하므로 시작되지 않을 수 있습니다. Cassandra 노드가 다운되면 DataAccessExceptions가 발생합니다. 또한 메시지 프로세서가 KVM을 가져오려고 할 때 DataAccessExceptions를 보고하는 API 트래픽 중단이 발생할 수도 있습니다.

예상되는 상태는 관리 서버가 리전 간에 데이터 스토어 구성요소에 연결되지 않는 것입니다.

해결 방법

해결 방법은 사용할 수 없는 데이터 센터에서 다음 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은 포드 이름으로, 기본값은 'gateway'입니다. 하지만 다른 이름으로 이름을 바꿨을 수도 있으므로 구현을 확인하세요.
    • 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 클러스터에는 영향을 미치지 않습니다. 이러한 명령어에 대한 자세한 내용은 데이터 스토어 등록 업데이트를 참고하세요.

68722102

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

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

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

해결 방법:

없음

다음 단계

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

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