4.19.01 프라이빗 클라우드용 Edge 출시 노트

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

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

버전 요약

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

새로운 기능

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

○ Edge UI의 정식 버전 (GA) 출시
○ Edge UI에서의 수익 창출 정식 버전 (GA) 출시
apigee-monit에서 자가 복구 및 모니터링 서비스를 추가합니다.
○ Edge UI에 새로운 TLS 구성 속성이 추가되었습니다.
○ 이제 Edge UI에서 가상 호스트를 생성, 수정, 삭제할 수 있습니다.
○ OpenAPI v3 지원 추가
○ 이제 RedHat Enterprise Linux (RHEL) 및 CentOS 7.6이 지원됩니다.
○ Oracle Linux 7.5 지원

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

포함된 발표곡

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

○ 가장자리:
18.06.08
18.06.06
18.05.21
18.05.10
18.05.09
18.04.23.00
○ 포털:
18.11.28.00
18.10.17.00
18.10.09.00
18.07.16.00
퇴직 없음
지원 중단 Private Cloud용 Apigee Edge 버전 4.17.09는 더 이상 지원되지 않습니다 (지원 중단됨).

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

버그 수정

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

○ 주키퍼가 백업 스크립트에 의해 중지되지 않음 (122694069)
○ '조직 없음' 방문 페이지 추가됨 (120993451)
○ 맞춤 보고서 삭제 (120682369)
○ 새 Edge 환경의 Geomap 탭 (120681592)
○ 주키퍼 JVM 옵션 (120624977)
○ 도움말에 정의되지 않은 오류가 발생함 (80187407)
○ OpenAPI를 통해 역방향 프록시 생성 (79949124)
○ 비밀번호 재설정 시 링크가 전송되지 않음 (77515655)
○ 비밀번호 재설정 링크의 잘못된 헤더 (72799769)
○ WSDL을 사용하여 API 프록시 생성 (69550284)

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

알려진 문제

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

○ apigee-sso 설치의 메타데이터 파일 형식 (135616498)
apigee-monit는 Amazon Linux 1 (122370980)에서 지원되지 않음
○ 메시지 프로세서 백업이 올바른 파일 세트를 백업하지 않음 (121095148)
○ 세션 토큰 무효화되지 않음 (115278838)
○ JMX 인증을 사용하면 Cassandra 작업이 작동하지 않음 (113342838)
○ Node.js 대상에 대한 HEAD 요청이 중단됨 (79993247)
○ 호스트 이름이 확인되지 않음 (79757554)
○ 다중 데이터 센터 구성의 DataAccessExceptions (76087166)
○ 로그 메시지에 추가 정보가 포함된 MessageLogging 정책 (68722102)
○ 시스템 관리자 비밀번호 재설정에 실패함 (65737520)

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

업그레이드 경로

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

5월 4일 18일 이후 직접 4.18.05 → 4.19.01에서 업그레이드
4월 18일 이후 직접 4.18.01 → 4.19.01에서 업그레이드
2009년 4월 17일부터 직접 4.17.09 → 4.19.01에서 업그레이드
5월 4일 17일부터 4.17.05 → 4.18.01에서 업그레이드, 그런 다음 4.18.01 → 4.19.01에서 업그레이드하세요.
4월 17일 이후 4.17.01 → 4.18.01에서 업그레이드, 그런 다음 4.18.01 → 4.19.01에서 업그레이드하세요.
2009년 4월 16일 이후 4.16.09 → 4.18.01에서 업그레이드, 그런 다음 4.18.01 → 4.19.01에서 업그레이드하세요.
5월 4일 16일부터 4.16.05 → 4.18.01에서 업그레이드, 그런 다음 4.18.01 → 4.19.01에서 업그레이드하세요.
2016년 1월 4일 이후 4.16.01 → 4.18.01에서 업그레이드, 그런 다음 4.18.01 → 4.19.01에서 업그레이드하세요.
4.15.0x 이상 4.15.0x → 4.16.01, 그런 다음 4.16.01 → 4.18.01에서 업그레이드하세요. 그런 다음 4.18.01 → 4.19.01에서 업그레이드하세요.

새로운 기능

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

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

Edge UI의 정식 버전 (GA) 출시

Apigee Edge UI는 Google의 최신 관리 UI 서비스입니다. 이전에는 베타. Private Cloud용 Apigee Edge v4.19.01에서 Edge UI가 일반 출시 버전에 포함되었습니다.

Edge UI를 사용하려면 SAML을 사용 설정한 다음 자체 노드에 Edge UI를 설치해야 합니다.

자세한 내용은 Google의 에지 UI는 프라이빗 클라우드로,

Edge UI의 수익 창출 정식 버전 (GA) 출시

이제 새로운 Edge 환경 UI에서 수익 창출의 정식 버전이 출시되었습니다.

이제 새로운 Edge 환경 UI에서 비공개 클라우드용 Apigee Edge의 모든 수익 창출 작업을 관리할 수 있습니다. 다음과 같습니다.

이번 발표에 따라 수익 창출 변동 보고서가 공식적으로 지원 중단되었습니다. Apigee 지원 중단을 참조하세요.

Apigee-monit은 자가 복구 및 모니터링 서비스를 추가합니다.

이제 Private Cloud용 Apigee Edge에 오픈소스 기반 도구인 apigee-monit가 포함됩니다. monit 유틸리티가 있습니다. apigee-monit에서 주기적으로 Edge 폴링 서비스 서비스를 사용할 수 없는 경우 apigee-monit에서 다시 시작을 시도합니다.

apigee-monit 설치, 구성, 사용에 대한 자세한 내용은 다음을 참조하세요. Apigee-monit을 통한 자가 복구

새 TLS 구성 속성

Edge UI는 다음을 설정하는 데 사용할 수 있는 새로운 TLS 구성 속성을 지원합니다.

  • 기본 TLS 프로토콜
  • 지원되는 TLS 프로토콜 목록
  • 지원되는 TLS 알고리즘
  • 지원되는 TLS 암호화

자세한 내용은 선택적 TLS 속성 설정

Edge UI에서 가상 호스트 만들기, 수정, 삭제

이제 셀프 서비스 기능이 확장되어 이제 만들고, 수정하고, 삭제할 수 있습니다. 가상 호스트를 지원합니다 (Edge UI만 해당).

자세한 내용은 브라우저를 사용하여 가상 호스트 만들기

OpenAPI v3 지원 추가됨

이 출시 버전에는 OpenAPI 버전 3 (Edge UI만 해당)을 통해 프록시를 만드는 기능이 추가되었습니다.

지원되는 소프트웨어

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

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

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

  • Red Hat Enterprise Linux (RHEL) 7.6
  • CentOS 7.6
  • Oracle Linux 7.6

다음 플랫폼은 이번 출시에서 더 이상 지원되지 않습니다.

  • RHEL/CentOS/Oracle 버전 7.3
  • RHEL/CentOS 버전 6.8
  • Oracle Linux 6.7

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

버그 수정

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

문제 ID 설명
122694069

백업 스크립트로 Zookeeper가 중지되지 않음

주키퍼 프로세스가 진행 중이었음 백업 스크립트에 의해 중지되었습니다.
120993451

'조직 없음' 방문 페이지 추가됨

사용자로 로그인하는 개발자 존재하지 않는 페이지로 이동되지 않습니다. 가 새 방문 페이지가 추가되었습니다.
120682369

맞춤 보고서 삭제

사용자가 새 Edge에서 맞춤 보고서를 삭제할 수 없음 경험해 볼 수 있습니다
120681592

New Edge 환경의 위치정보 탭

사용자가 새 Edge 환경에서 오류가 발생했습니다.
120624977

Zookeeper JVM 옵션

Config와 함께 코드를 사용하여 JVM 옵션 설정 주키퍼가 작동하지 않았습니다.
80187407

도움말에 정의되지 않은 오류가 발생함

차트에 시계열이 하나만 있는 경우 도움말에 정의되지 않은 오류가 발생했습니다.
79949124

OpenAPI를 통해 역방향 프록시 만들기

OpenAPI 사용 프록시 생성이 작동하지 않았기 때문에 버튼이 표시되었습니다.
77515655

링크가 전송되지 않는 비밀번호 재설정

다음 시점에 사용자가 이메일을 받지 못했습니다. 비밀번호 재설정 링크를 요청하는 사용자
72799769

비밀번호 재설정 링크의 잘못된 헤더

사용자가 trustxforwarded 속성을 true로 변경, 결과 요청 헤더 HTTPS를 사용하지 않았습니다.
69550284

WSDL을 사용하여 API 프록시 만들기

사용 시 API 프록시 생성에 실패함 WSDL.

알려진 문제

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

문제 ID 설명
135616498

Apigee-sso 설치의 메타데이터 파일 형식

apigee-sso를 설치하고 URL 대신 metadata.xml 파일을 사용할 때 metadata.xml 파일의 끝부분에 새 줄 (CRLF)이 포함되어 있지 않으면 metadata.xml 파일을 완전히 읽을 수 없습니다.

해결 방법:

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

  • metadata.xml 파일 끝에 CRLF 추가

    또는

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

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

해결 방법:

없음
121095148

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

해결 방법:

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

115278838

세션 토큰이 무효화되지 않음

사용자가 Apigee Edge 로그아웃 버튼을 클릭해도 서버에서 세션 토큰이 무효화되지 않습니다.

해결 방법:

SAML과 함께 New Edge 환경 사용

113342838

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

해결 방법:

nodetool 명령어를 호출할 때마다 사용자 이름과 비밀번호를 추가합니다.

79993247

Node.js 대상에 대한 HEAD 요청이 중단됨

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

해결 방법:

이 문제를 해결하려면 빈 응답을 명시적으로 반환하도록 HEAD 요청의 핸들러를 정의하세요.

79757554

호스트 이름이 확인되지 않음

Private Cloud용 Edge를 설치하거나 업그레이드한 후 호스트 이름이 주소로 확인되지 않을 수 있습니다.

해결 방법:

이 문제를 해결하려면 다음과 같이 Edge UI 구성요소를 다시 시작하세요.

/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
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를 설정해도 로그 메시지에는 다음 정보가 포함됩니다.

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

해결 방법:

없음
65737520

시스템 관리자 비밀번호 재설정에 실패함

특수문자가 포함된 관리 서버에 대한 시스템 관리자 비밀번호는 재설정되지 않습니다.

해결 방법:

데이터 파일에 비밀번호를 정의한 다음 Management API의 /users 엔드포인트에 전달합니다. 자세한 내용은 시스템 관리자 비밀번호 재설정을 참고하세요.

다음 단계

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

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