현재 Apigee Edge 문서가 표시되고 있습니다.
Apigee X 문서로 이동 정보
이 섹션에서는 Edge for Private Cloud 기능 출시의 버전 4.18.05를 설명합니다.
버전 요약
다음 표에는 이번 기능 출시의 변경사항이 요약되어 있습니다.
새로운 기능 | ○ JWT 정책 정식 버전 출시 (GA) ○ RedHat Enterprise Linux 6.9 지원 ○ Oracle Linux 6.9 지원 ○ CentOS 6.9 지원 ○ 새로운 Edge 환경 설치 구성 변경사항 ○ 이제 가상 호스트 수준에서 라우터 재시도 옵션 설정 가능 |
|||
포함된 출시 버전 |
|
|||
퇴직 | ○ API BaaS ○ 모니터링 대시보드 (베타) |
|||
지원 중단 | ○ Apigee 보안 저장소 (보관소)가 KVM으로 대체됨 ○ API 프록시 성능 탭에 경로 추가 ○ 개발자 서비스 포털의 SMTPSSL 속성 |
|||
버그 수정 | ○ 사용자 이메일 주소 변경 방지 (65550638) ○ jackson-databind 보안 취약점 (69711616) ○ 메시지 프로세서의 메모리 누수 (71612599) |
|||
알려진 문제 | 이 릴리스에는 다음과 같은 알려진 문제가 있습니다. ○ 메시지 프로세서 백업이 올바른 파일 집합을 백업하지 않음 sql 메시지 프로세서 백업이 표시됨 sql 2 올바른 파일 집합을 백업하지 않음○ ○ 7 추가 메시지 구성(121095148) ○ Node.js 대상에 대한 HEAD 요청이 중단됨(79993247)○ Open API 옵션을 통한 역방향 프록시 생성이 표시됨(79949124) 54 - 54 - 호스트 이름 7 5 54 오류 메시지 해결 방법을 비롯한 각 알려진 문제에 관한 자세한 내용은 알려진 문제를 참조하세요. |
|||
다음 섹션에서는 이러한 각 주제를 자세히 설명합니다.
업그레이드 경로
다음 표에는 이 기능 출시의 업그레이드 경로가 나와 있습니다.
4.18.01부터 | 4.18.01 → 4.18.05에서 직접 업그레이드 |
2009년 4월 17일부터 | 4.17.09 → 4.18.05에서 직접 업그레이드 |
5월 4.17일부터 | 4.17.05 → 4.18.05에서 직접 업그레이드 |
4.17.01부터 | 4.17.01 → 4.18.01에서 업그레이드한 후 4.18.01 → 4.18.05에서 업그레이드 |
2009년 4월 16일부터 | 4.16.09 → 4.18.01에서 업그레이드한 후 4.18.01 → 4.18.05에서 업그레이드 |
5월 4.16일부터 | 4.16.05 → 4.18.01에서 업그레이드한 후 4.18.01 → 4.18.05에서 업그레이드 |
4.16.01부터 | 4.16.01 → 4.18.01에서 업그레이드한 후 4.18.01 → 4.18.05에서 업그레이드 |
4.15.0x 이상 | 4.15.0x → 4.16.01에서 업그레이드한 후 4.16.01 → 4.18.01에서 업그레이드한 후 4.18.01 → 4.18.05에서 업그레이드 |
새로운 기능
이 섹션에서는 이번 기능 출시의 새로운 기능을 설명합니다. 이러한 기능 외에도 이 출시 버전에는 포함된 출시 버전에 나열된 Edge UI, 에지 관리, 포털 출시 버전의 모든 기능이 포함되어 있습니다.
다음과 같은 개선사항 외에도 이 출시에는 여러 사용성, 성능, 보안 및 안정성 개선사항이 포함되어 있습니다.
JWT 정책
다음 JWT 정책은 더 이상 베타 버전이 아닌 정식 버전으로 제공됩니다.
지원되는 소프트웨어
이번 기능 출시에서는 지원되는 소프트웨어에 대해 다음과 같은 변경사항이 적용되었습니다.
- 이제 Red Hat Enterprise Linux (RHEL) 6.9가 지원됩니다.
- 이제 Oracle Linux 6.9가 지원됩니다.
- 이제 CentOS 6.9가 지원됩니다.
- RHEL/CentOS/Oracle Linux 7.2 지원 중단
자세한 내용은 지원되는 소프트웨어 및 지원되는 버전을 참조하세요.
새로운 Edge 환경 설치 구성 변경사항
New Edge 환경의 4.18.05 출시에는 4.18.01 출시 이후의 구성 파일 변경사항이 포함되어 있습니다. 새 속성은 Edge 4.18.01의 설치 구성 변경사항에 설명되어 있습니다.
이제 가상 호스트 수준에서 라우터 재시도 옵션을 설정할 수 있습니다.
이제 라우터가 가상 호스트의 메시지 프로세서와 통신하기 위한 재시도 옵션을 설정할 수 있습니다. 이렇게 하면 라우터 수준에서만 설정할 수 있었던 이전 옵션보다 더 세밀하게 제어할 수 있습니다.
자세한 내용은 가상 호스트 구성 속성을 참조하세요.
새로운 애널리틱스 측정기준 및 x_forwarded_for_ip
측정기준으로 변경됨
Edge가 Edge 애널리틱스에서 x_forwarded_for_ip
측정기준을 설정하는 방식이 변경되었습니다. 이전에는 X-Forwarded-For
헤더에 여러 IP 주소가 있는 경우 x_forwarded_for_ip
측정기준에 나열된 마지막 IP 주소만 포함되었습니다.
고객은 종종 x_forwarded_for_ip
측정기준을 사용하여 Edge에 API를 요청하는 클라이언트의 IP 주소를 확인합니다.
이 출시 버전에서는 이제 x_forwarded_for_ip
측정기준에 X-Forwarded-For
헤더의 전체 IP 주소 목록이 포함됩니다.
경고: X-Forwarded-For
헤더는 액세스가 거부된 IP에 의해 스푸핑될 가능성이 있습니다. 단, 헤더의 마지막 주소는 예외적으로, 마지막 외부 TCP 핸드셰이크에서 Edge가 수신된 IP 주소입니다.
Edge에 API 요청을 보내는 원래 클라이언트 IP 주소를 확인하기 위해 이 출시 버전에서는 Edge 애널리틱스에 새 측정기준 ax_resolved_client_ip
를 추가합니다.
이제 맞춤 보고서 또는 맞춤 보고서의 필터 조건에서 ax_resolved_client_ip
측정기준을 사용하여 API 요청을 실행하는 클라이언트의 IP 주소를 확인할 수 있습니다.
ax_resolved_client_ip
측정기준에 대한 자세한 내용은
애널리틱스 측정항목, 측정기준 및 필터 참조를 확인하세요.
이 변경사항은 AccessControl 정책이 X-Forwarded-For
헤더를 처리하는 방식에도 영향을 미칩니다.
이 출시 버전에서 Edge는 마지막 외부 TCP 핸드셰이크에서 수신한 단일 IP 주소 (예: 클라이언트 IP 또는 라우터)로 X-Forwarded-For
HTTP 헤더를 자동으로 채웁니다.
이전 출시 버전의 Edge는 첫 번째 외부 TCP 핸드셰이크에서 수신한 단일 IP 주소 (예: 클라이언트 IP 또는 라우터)로 X-Forwarded-For
HTTP 헤더를 설정했습니다.
자세한 내용은 X-Forwarded-For HTTP 헤더 정보를 참조하세요.
포함된 출시 버전
이전 Edge for Private Cloud 기능 출시 이후 다음 출시가 발생했으며 이 기능 출시에 포함되었습니다.
Edge UI | 에지 관리/런타임 | 포털 |
---|---|---|
18.04.04 18.03.02 18.02.14 17.11.06 |
18.04.06 18.04.04 18.03.02* 18.02.02 18.01.05 |
18.04.25.01 18.04.25.00 18.04.23.00 18.03.28.00 18.03.05.00 18.02.15.00 18.02.15.00{/10.00.00 {10.02.15.0018.02.15.00 {1.0.02.15.0018.01.31.0017.12.20.00 |
* 버그 수정 74622499는 Edge for Private Cloud 4.18.05 출시 버전에 포함되지 않습니다. |
위의 링크를 클릭하면 이 기능 출시에 포함된 이러한 버전의 버그 수정 및 새로운 기능을 확인할 수 있습니다.
퇴직
이 섹션에서는 이번 기능 출시에서 지원 중단된 기능을 설명합니다.
API BaaS
API BaaS가 지원 중단되었습니다. 자세한 내용은 Apigee 지원 중단, 지원 중단, CPS 변경사항을 참조하세요.
모니터링 대시보드 (베타)
모니터링 대시보드 (베타)가 지원 중단되었으며 더 이상 지원되지 않습니다. 따라서 다음 구성요소는 더 이상 설치에 포함되지 않습니다.
apigee-influxdb
apigee-telegraf
apigee-grafana
라우터, 메시지 프로세서, 노드 측정항목을 계속 가져오려면 Apigee에서 JMX를 사용하여 프라이빗 클라우드용 Edge의 데이터를 자체 모니터링 도구와 통합하는 것이 좋습니다. 자세한 내용은 모니터링 대상과 모니터링 방법을 참고하세요.
기존 설치를 버전 4.18.05로 업그레이드하는 경우 Monitoring 대시보드를 제거해야 합니다. Apigee에서는 서비스가 계속해서 예상대로 작동할 것을 보장하지 않습니다.
지원 중단
다음 기능은 이번 출시에서 지원 중단되었습니다.
자세한 내용은 Apigee 지원 중단, 지원 중단, CPS 변경사항을 참조하세요.
Apigee 보안 저장소 (Vault)
'보관소'라고도 하는 Apigee 보안 저장소는 지원 중단되었으며 2018년 9월에 지원이 중단됩니다.
보안 저장소를 사용하는 대신 키-값 맵 작업에 설명된 대로 암호화된 키-값 맵 (KVM)을 사용합니다. 암호화된 KVM은 Vault만큼 안전하며 더 많은 생성 및 검색 옵션을 제공합니다.
API 프록시 성능 탭에 경로 추가
이 버전이 출시되기 전에는 관리 UI의 API 프록시로 이동하고 성능 탭으로 이동하여 프록시의 성능 탭과 비즈니스 거래 대시보드에서 차트 기반 비교를 위한 다양한 경로를 만들 수 있었습니다.
이 기능은 이제 지원 중단되었으며 더 이상 UI에서 사용할 수 없습니다. 이 기능의 대안은 Business Transactions API의 대안을 참조하세요.
개발자 서비스 포털의 SMTPSSL 속성
포털에 연결된 SMTP 서버에서 사용하는 프로토콜을 설정하려면 이제 SMTPSSL
속성 대신 SMTP_PROTOCOL
속성을 사용합니다. 유효한 SMTP_PROTOCOL
값은 'standard', 'ssl', 'tls'입니다.
자세한 내용은 개발자 서비스 포털 설치를 참고하세요.
버그 수정
이 섹션에는 이 기능 출시에서 수정된 Private Cloud 버그가 나열되어 있습니다. 아래 나열된 버그 외에도 이 기능 출시에는 포함된 출시에 표시된 Edge UI, Edge 관리, 포털 출시의 모든 버그 수정이 포함되어 있습니다.
문제 ID | 설명 |
---|---|
71612599 |
메시지 프로세서의 메모리 누수 메모리 누수를 해결했습니다. 이 문제는 Qpidd가 중지되었을 때 메시지 프로세서에서 발생했습니다. |
69711616 |
jackson-databind의 보안 취약점 역직렬화 결함을 방지하기 위해 jackson-databind 라이브러리가 버전 2.7.9.1로 업데이트되었습니다. |
65550638 |
사용자의 이메일 주소 변경 방지 더 이상 관리 API로 전송된 메시지 페이로드에서 사용자의 이메일 주소를 변경할 수 없습니다. 또한 관리 API는 이제 요청 본문에 XML을 허용하지 않습니다. |
알려진 문제
다음 표에는 이번 기능 출시의 알려진 문제가 나와 있습니다.
문제 ID | 설명 |
---|---|
121095148 |
메시지 프로세서 백업이 올바른 파일 세트를 백업하지 않음 해결 방법: 백업을 두 번 실행하면 올바른 파일 세트가 백업됩니다. |
79993247 |
Node.js 대상에 대한 Node.js 대상에 대한 HEAD 요청이 중단되어 연결이 대기 중인 상태로 남겨질 수 있습니다. 해결 방법: 이 문제를 해결하려면 빈 응답을 명시적으로 반환하도록 |
79949124 |
Open API를 통한 역방향 프록시 만들기 옵션이 표시됨 프록시 마법사에는 현재 Open API를 통해 새 프록시를 만드는 옵션이 표시됩니다. 프라이빗 클라우드용 에지에서는 이를 수행할 수 없습니다. 해결 방법: 없음 |
79757554 |
호스트 이름이 확인되지 않음 Private Cloud용 Edge를 설치하거나 업그레이드한 후 호스트 이름이 주소로 확인되지 않을 수 있습니다. 해결 방법: 이 문제를 해결하려면 Edge UI 구성요소를 다시 시작합니다. /opt/apigee/apigee-service/bin/apigee-service edge-ui restart |
76087166 |
여러 데이터 센터 구성의 DataAccessException 여러 데이터 센터 구성에서 데이터 저장소 하나를 사용할 수 없게 되면 다음과 같은 오류가 표시될 수 있습니다. DataAccessException: Error while accessing datastore; Please retry later 그 결과, dc-1 및 dc-2 모두에서 Cassandra 노드에 연결을 시도하여 관리 서버가 시작되지 않을 수 있습니다. Cassandra 노드가 다운되면 예상되는 상태는 관리 서버가 리전 간에 Datastore 구성요소에 연결되지 않는 것입니다. 해결 방법 해결 방법은 사용할 수 없는 데이터 센터에서 다음 Cassandra 노드 유형을 등록 취소한 다음 Cassandra 노드를 다시 사용할 수 있게 되면 다시 등록하는 것입니다.
Cassandra 노드 유형을 등록 취소하고 다시 등록하려면 다음 안내를 따르세요.
이러한 작업은 Jokeeper에서 노드를 등록 및 등록 취소하며 Cassandra 클러스터에는 영향을 주지 않습니다. 이러한 명령어에 대한 자세한 내용은 Datastore 등록 업데이트를 참조하세요. |
72379834 |
apigee-postgresql을 중지할 때 권한 오류 메시지가 표시됨
해결 방법: N/A |
68722102 |
로그 메시지의 추가 정보가 포함된 MessageLogging 정책 MessageLogging 정책의
해결 방법: 없음 |
다음 단계
Edge for Private Cloud 4.18.05를 시작하려면 다음 링크를 사용하세요.