4.19.06 Private Cloud용 Edge 출시 노트

<ph type="x-smartling-placeholder"></ph> 현재 Apigee Edge 문서를 보고 있습니다.
Apigee X 문서.
정보

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

버전 요약

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

새로운 기능

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

○ SSO를 위한 LDAP 지원
○ HTTP 배포 지원
○ 플러그형 분석
○ Cassandra 랙 지원
○ IPv6 지원
○ 간소화된 New Edge 환경 설치
○ 거래 INVALID_TSC건 제외 (수익 창출)

각각의 새로운 기능에 대한 자세한 내용은 새로운 기능.

이전 버전과의 호환성

이 버전에서 이전 버전과의 호환성에 영향을 미치는 다음 문제가 발생했습니다. 프라이빗 클라우드용 Apigee Edge의 일부입니다.

     
  • 문제 132443137( 2019년 3월 1일 일반 대중에게 Cloud 출시 노트)에 나와 있는 것처럼, 메시지 프로세서는 이제 X-Apigee-*입니다. 따라서 API를 사용하는 경우 X-Apigee-* 헤더를 추가하고 해당 헤더를 지원되는 헤더로 바꿉니다.

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

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

이전 Private Cloud 기능 출시 버전 이후 다음 출시는 이 출시 버전에 포함되어 있습니다.

○ 가장자리:
2023년 7월 19일 (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 변경사항을 참조하세요.

버그 수정

이 릴리스에서는 다음 버그 수정이 포함되었습니다.

○ UseString중복 삭제가 설정되지 않음 (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)
apigee-monit는 Amazon Linux 1 (122370980)에서 지원되지 않음
○ 메시지 프로세서 백업이 올바른 파일 세트를 백업하지 않음 (121095148)
○ 다중 데이터 센터 구성의 DataAccessExceptions (76087166)
○ 로그 메시지에 추가 정보가 포함된 MessageLogging 정책 (68722102)

해결 방법을 포함하여 이러한 알려진 문제 각각에 대한 자세한 내용은 다음을 참조하세요. 알려진 문제.

업그레이드 경로

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

2019년 4월 19일부터 직접 4.19.01 → 4.19.06에서 업그레이드
5월 4일 18일 이후 직접 4.18.05 → 4.19.06에서 업그레이드
4월 18일 이후 직접 4.18.01 → 4.19.06에서 업그레이드

새로운 기능

이 섹션에는 이번 버전의 새로운 기능이 나열되어 있습니다. 또한 이 릴리스에서는 에지 UI, 에지 관리, 포털 출시 버전에 포함된 포함된 출시 버전.

다음과 같은 향상된 기능 외에도 이번 출시에는 여러 사용성도 포함되어 있습니다. 성능, 보안, 안정성이 향상됩니다.

HTTP 배포 지원

기본적으로 Edge는 RPC를 사용하여 API 프록시를 배포합니다. 이 모드는 대부분의 사용자에게 매우 잘 작동하지만 많은 수의 MP가 있는 큰 토폴로지에서는 동시 호출은 RPC를 통해 이루어집니다.

따라서 Apigee에서는 대규모 배포 시 RPC가 아닌 HTTP를 사용하도록 권장합니다. 배포할 수 있습니다 이제 HTTP 배포 사용 설정이 지원됩니다.

자세한 내용은 HTTP 사용 설정 배포를 클릭합니다.

Cassandra 랙 지원

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

자세한 내용은 Cassandra 랙 지원.

플러그형 분석

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

이 기능 출시로 분석 데이터를 기록하도록 메시지 프로세서를 구성할 수 있습니다. 두 옵션을 모두 사용할 수 있습니다

자세한 내용은 파일에 분석 데이터 쓰기

간소화된 새 Edge 환경 설치

새 스크립트를 사용하여 New Edge 환경의 설치가 간소화되었습니다.

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

LDAP IDP 지원

이제 Edge UI 및 Edge 관리 API 호출을 통한 사용자 인증이 추가할 수 있습니다. LDAP 지원에는 직접 바인딩과 간접 바인딩 방법이 모두 포함됩니다.

자세한 내용은 외부 개요 IDP 인증

IPv6 지원

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

자세한 내용은 라우터를 설정합니다.

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

이제 Postgres에 추가되지 않도록 INVALID_TSC 트랜잭션을 제외할 수 있습니다. 데이터베이스에 저장하는 것이 좋습니다.

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

지원되는 소프트웨어

이 릴리스에서는 지원되는 소프트웨어에 다음과 같은 변경 사항이 포함되어 있습니다.

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

이 릴리스에서는 다음 플랫폼에 대한 지원을 추가합니다.

  • 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

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

버그 수정

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

문제 ID 설명
140270474

UseString중복 삭제가 설정되지 않음

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개 이상인 경우 키 저장소와 키 저장소는 참조 섹션이 로드되지 않았습니다 대신 UI에 Internal Error (Error Fetching Keystores) 오류가 표시되었습니다.
110988191

분석 실패

Microgateway로부터 다음과 같은 데이터가 제공되면 환경에 대한 Analytics가 실패했습니다. 미래의 날짜로 설정할 수 있습니다.
110785400

백업 실패

주키퍼, Cassandra, OpenLDAP에서 간헐적으로 실패함 다음 오류와 함께 데이터를 제대로 백업합니다. File changed as we read it.
79993247

Node.js에 대한 HEAD 요청

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

Apigee-postgres 백업/복원

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

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

특수 항목이 포함된 관리 서버에 대한 시스템 관리자 비밀번호 재설정 실패합니다

알려진 문제

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

문제 ID 설명
141628497

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

조직의 수익 창출을 처음 사용 설정할 때는 처음에 Private Cloud용 Edge에서 트랜잭션을 평가하지 않습니다. 이는 신규 및 기존 조직에 적용됩니다.

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

해결 방법:

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

수익 창출이 사용 설정된 후 MP를 다시 시작하면 Edge가 시작 시 동물원Keeper의 구성을 로드합니다. 이 문제는 다시 시작할 때마다 발생하므로 문제가 처음에만 적용됩니다.

137865184

Mint 등급 서버 메모리 누수

새 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

여러 데이터 센터 구성에서 하나의 Datastore를 사용할 수 없게 되면 다음 오류가 반환됩니다.

DataAccessException: Error while accessing datastore;
Please retry later

결과적으로 관리 서버가 Cassandra에 연결을 시도하기 때문에 시작되지 않을 수 있습니다. dc-1과 dc-2 모두에 DataAccessExceptions은 Cassandra 노드가 다음과 같은 경우에 발생합니다. 감소합니다. 이로 인해 API 트래픽 중단이 발생할 수도 있습니다. API 트래픽 중단은 메시지 프로세서가 DataAccessExceptions를 발생시킵니다.

예상되는 상태는 관리 서버가 데이터 저장소 구성요소에 연결되지 않는 것입니다. 여러 리전 간에 분산될 수 있습니다

해결 방법

해결 방법은 사용할 수 없는 데이터 센터에서 다음 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_TYPE은(는) kms-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)에 대해 1단계를 반복합니다. dc-datastore, keyvaluemap-datastore 다음 반환되는 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

이러한 작업은 주키퍼에서 노드를 등록 및 등록 취소하며, 영향을 미칠 수 있습니다 이러한 명령어에 관한 자세한 내용은 데이터 스토어 등록을 업데이트합니다.

68722102

로그 메시지에 추가 정보를 포함하는 MessageLogging 정책

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

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

해결 방법:

없음

다음 단계

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

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