4.16.09 - Private Cloud용 Edge 출시 노트

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

2016년 9월 19일 월요일에 새로운 버전의 Apigee Edge for Private Cloud가 출시되었습니다.

이전 Edge for Private Cloud 기능 출시 이후 다음 출시가 진행되었으며 이 기능 출시에 포함되어 있습니다.

• 클라우드: 16.04.13 (UI), 16.04.13 (수익 창출), 16.04.20 (UI), 16.04.27 (수익 창출), 16.04.27 (UI), 16.05.04 (UI), 16.05.11 (UI), 16.05.11 (수익 창출), 16.05.18 (UI), 16.05.25 (수익 창출), 16.06.08 (수익 창출), 16.06.15 (UI), 16.06.22 (수익 창출), 16.06.29 (UI), 16.07.06 (수익 창출), 16.07.06.02 (수익 창출), 16.07.13 (UI), 16.07.20.01 (수익 창출), 16.07.27 (UI), 16.08.17

특정 클라우드 출시가 프라이빗 클라우드용 Edge 버전에 포함되어 있는지 확인하는 방법을 알아보려면 출시 번호 지정 정보를 참고하세요.

출시 개요

이번 출시에서는 기본 API 프록시 편집기가 삭제되고 기본 편집기와 함께 사용할 수 있었던 새 프록시 편집기로 대체되었습니다. 기타 주목할 만한 개선사항으로는 API 제품 리소스 경로의 동작 개선, 메시지 할당 및 오류 발생 정책에 정의된 JSON 페이로드 처리 개선, XML-JSON 변환 개선, 리소스 검증 개선, 개별 API 프록시의 제한 시간 설정 기능, API 프록시 마법사의 SOAP 프록시 생성 업데이트, JavaScript용 고성능 암호화 객체 등이 있습니다.

수익 창출 개선사항에는 알림 요금제가 포함된 새로운 알림 기능, 개발자를 수익 창출로 이전하는 API, 요금제를 공개 또는 비공개로 설정하는 기능이 포함됩니다.

이 주제의 나머지 부분에는 이번 출시에 포함된 모든 새로운 기능, 업데이트, 버그 수정에 관한 세부정보가 포함되어 있습니다.

지원 중단됨

API 서비스

기본 프록시 편집기 삭제 (Cloud 16.04.20 UI)

이제 새 버전의 API 프록시 편집기만 지원됩니다. 기존 버전은 더 이상 사용할 수 없으며 '기존 버전의 프록시 편집기에 액세스' 링크가 삭제되었습니다. 기존 버전을 사용한 경우 API 프록시가 새 편집기에 자동으로 로드됩니다. (EDGEUI-498)

수익 창출

지원 중단된 다음 기능이 삭제되었으며 더 이상 지원되지 않습니다.

• 한도 설정
• 전송 한도 알림

또는 다음 섹션에 설명된 대로 알림을 설정할 수 있습니다.

• 일정 알림 설정하기
• 요금제에 대한 한도 알림 만들기

(DEVRT-2742)

새로운 기능 및 업데이트

이번 출시 버전의 새로운 기능과 향상된 기능은 다음과 같습니다. 다음 개선사항 외에도 이번 출시에는 사용성, 성능, 보안, 안정성 개선사항이 여러 개 포함되어 있습니다.

자세한 내용과 안내는 프라이빗 클라우드용 Edge 문서를 참고하세요.

프라이빗 클라우드

Postgres를 버전 9.4로 업그레이드

이 출시에는 Postgres 9.4로의 업그레이드가 포함되어 있습니다. 시스템 업데이트에 관한 안내는 Apigee Edge를 4.16.09로 업데이트를 참고하세요.

Edge UI의 GeoMap 지원

지역 집계를 사용하면 지역, 대륙, 국가, 도시와 같은 지리적 속성을 기반으로 API 호출에 대한 분석 데이터를 수집할 수 있습니다. 이 분석 데이터를 통해 API 요청의 위치를 보여주는 지도를 Edge UI에서 볼 수 있습니다.

자세한 내용은 지역 집계 및 지역 지도 사용 설정을 참고하세요.

API BaaS

다음 항목에 관한 문서가 추가되었습니다.

• TLS를 사용하도록 API BaaS를 구성하는 방법 자세한 내용은 API BaaS용 TLS 구성을 참고하세요.
• 모든 애셋이 모든 API BaaS 스택 노드에서 사용할 수 있도록 공유 스토리지를 사용하도록 모든 API BaaS 스택 노드를 구성하는 방법 자세한 내용은 애셋 업로드를 참고하세요.
• BaaS 스택 노드를 구성할 때 Cassandra 비밀번호를 암호화하는 방법 자세한 내용은 Edge 비밀번호 재설정을 참고하세요.

모니터링 도구 및 대시보드의 베타 출시

이 출시에는 Edge용 새로운 모니터링 도구 및 대시보드의 베타 버전이 포함되어 있습니다. 이 도구를 사용하면 배포의 다양한 조직과 환경에 대한 HTTP 오류 코드뿐만 아니라 다양한 구성요소 (라우터, 메시지 프로세서, ZooKeeper, Cassandra)의 상태를 파악할 수 있습니다. 대시보드 데이터의 스냅샷을 찍어 Apigee와 공유하여 지원 인시던트를 해결할 수도 있습니다.

설치 안내를 포함한 문서는 버전 4.18.01의 Edge 4.16.09 문서에 포함되어 있습니다.

하지만 대시보드를 설치하고 사용하려면 버전 4.18.01에서도 제공되는 Apigee 평가 계약을 작성하여 orders@apigee.com으로 이메일을 보내 Apigee에 반환해야 합니다.

분석 수집기 도구 베타 출시

모든 Edge for Private Cloud 고객은 API 프록시 트래픽에 관한 통계를 Apigee에 제출해야 합니다. Apigee에서는 고객이 크론 작업을 만들어 하루에 한 번 정보를 업로드하는 것이 좋습니다.

이 데이터의 업로드를 지원하기 위해 Apigee에서는 apigee-analytics-collector 명령줄 유틸리티의 베타 버전을 제공합니다. 이 유틸리티는 API 호출량 보고서를 Apigee에 다시 전송합니다. 프라이빗 클라우드용 Edge 설치는 이 유틸리티를 사용하여 트래픽 데이터를 가져와 Apigee에 보고할 수 있습니다.

자세한 내용은 Apigee에 API 트래픽 데이터 업로드 - 베타 버전을 참고하세요.

API 서비스

메시지 할당 및 오류 발생의 JSON 페이로드 (Cloud 16.08.17)

이 개선사항을 통해 적절한 JSON 메시지 형식을 보장하기 위한 해결 방법이 필요하지 않으며, 잘못된 JSON을 만들지 않고 중괄호를 사용하여 변수를 지정할 수 있습니다. 예를 들어 다음은 JSON 메시지에 message.content 값을 삽입합니다.

<Payload contentType="application/json">{"Message: " : "{message.content}"}</Payload>

해결 방법을 사용한 경우 코드는 그대로 작동합니다. 중괄호 대신 variablePrefix 및 variableSuffix를 사용하여 변수를 나타낼 수도 있습니다.

메시지 할당 정책 및 오류 제기 정책 참조 문서의 <Set><Payload> 요소를 참고하세요. (APIRT-1160)

XML to JSON 정책 개선사항 (클라우드 16.08.17)

XML to JSON 정책이 다음과 같은 기능으로 개선되었습니다. 다음과 같이 정책을 구성할 수 있습니다.

• 변환 중에 일부 XML 요소를 배열로 처리하여 JSON 문서의 대괄호 '[ ]'에 값을 배치합니다.
• 최종 JSON 문서에서 XML 문서 계층 구조의 수준을 삭제합니다.

자세한 내용은 XML to JSON 정책을 참고하세요. (APIRT-1144)

API 제품 리소스 경로의 와일드카드 여러 개 (Cloud 16.08.17)

API 제품에서 리소스 경로를 정의할 때 리소스 경로의 여러 위치에 와일드 카드를 포함할 수 있습니다. 예를 들어 /team/*/invoices/**은 /team 뒤에 오는 값과 invoices/ 뒤에 오는 리소스 경로를 사용하여 API 호출을 허용합니다. API 호출에서 허용되는 URI는 proxyBasePath/team/finance/invoices/company/a입니다.

이 출시 후 기존 API 제품 리소스 경로가 예상대로 작동하지 않으면 조직에서 다음 속성을 설정하여 이전 동작으로 되돌리세요. features.enableStandardWildCardMatchForAPIProductResources = true

(MGMT-3273)

JavaScript의 암호화 함수 (Cloud 16.08.17)

다음 해시 객체(MD5, SHA-1, SHA256, SHA512)를 만들고 가져오고 업데이트하는 데 사용할 수 있는 새로운 고성능 JavaScript crypto 함수가 제공됩니다. crypto 객체를 사용하면 다양한 형식으로 날짜를 가져올 수도 있습니다. 자세한 내용은 JavaScript 객체 모델을 참고하세요. (APIRT-2886)

Java Callout JAR 버전 확인 (클라우드 16.08.17)

Java JAR 리소스를 API 프록시에 업로드할 때 Java 리소스 버전이 지원되는 소프트웨어 및 지원되는 버전에 나열된 Edge 지원 Java 버전과 호환되지 않으면 HTTP 400 상태 코드가 반환됩니다(500 대신). (MGMT-3420)

API 프록시 리소스 검증 (Cloud 16.08.17)

환경 또는 조직 범위에 저장된 API 프록시 리소스 파일 (예: JavaScript 또는 Java JAR)이 있는 경우 유효성 검사 프레임워크에서는 유효성 검사를 통과하기 위해 가져올 프록시 번들에 API 프록시 수준의 리소스를 포함할 필요가 없습니다. 이제 리소스 유효성 검사는 가져오기 시간이 아닌 배포 시간에 실행됩니다. (MGMT-1430)

개별 API 프록시의 시간 제한 구성 (Cloud 16.08.17)

지정된 시간이 지나면 타임아웃되도록 API 프록시를 구성할 수 있습니다 (504 게이트웨이 타임아웃 상태). 기본 사용 사례는 실행하는 데 시간이 오래 걸리는 API 프록시가 있는 Private Cloud 고객을 위한 것입니다. 예를 들어 특정 프록시를 3분에 타임아웃해야 한다고 가정해 보겠습니다. API 프록시 구성에서 새 api.timeout 속성을 사용할 수 있습니다. 3분 예시를 사용하여 이 작업을 수행하는 방법은 다음과 같습니다.

1. 먼저 3분 후 부하 분산기, 라우터, 메시지 프로세서가 타임아웃되도록 구성해야 합니다.
2. 그런 다음 관련 프록시가 3분 안에 타임아웃되도록 구성합니다. 값을 밀리초 단위로 지정하세요. 예를 들면 다음과 같습니다.

   <ProxyEndpoint name="default">
     <HTTPProxyConnection>
       <BasePath>/v1/weather</BasePath>
       <Properties>
         <!-- api.timeout is in milliseconeds -->
         <Property name="api.timeout">180000</Property>
       </Properties>
       ...

3. 그러나 시스템 시간 제한을 늘리면 api.timeout 설정이 없는 모든 프록시가 새로운 상위 부하 분산기, 라우터, 메시지 프로세서 시간 제한을 사용하므로 성능 문제가 발생할 수 있습니다. 따라서 더 짧은 시간 제한을 사용하기 위해 더 이상 시간 제한이 필요 없는 다른 API 프록시를 구성합니다. 예를 들어 다음은 1분 후 API 프록시가 시간 초과되도록 설정합니다.
   <Property name="api.timeout">60000</Property>

Edge 시간 제한을 수정할 수 없는 클라우드 고객은 표준 Edge 메시지 프로세서 시간 제한인 57초보다 짧은 경우 API 프록시 시간 제한도 구성할 수 있습니다.

변수로 값을 채울 수 없습니다. 이 속성은 엔드포인트 속성 참조에 설명되어 있습니다. (APIRT-1778)

프록시 마법사 사용 시 SOAP 프록시 동작 (Cloud 16.07.27 UI)

프록시 마법사를 사용하여 WSDL에서 SOAP 기반 프록시를 만들 때 프록시 생성에는 두 가지 옵션이 있습니다.

• 프록시가 SOAP 요청 페이로드를 그대로 전달하는 패스 스루 SOAP
• REST에서 SOAP로, SOAP에서 REST로: 프록시가 JSON과 같은 수신 페이로드를 SOAP 페이로드로 변환한 다음 SOAP 응답을 호출자가 예상하는 형식으로 다시 변환합니다.

이번 출시에는 이러한 옵션의 동작 방식에 관한 다음과 같은 업데이트가 포함되어 있습니다. 이전 동작과 새 동작의 차이점은 프록시 마법사에서 자동으로 생성되는 정책과 구성에 있습니다.

통과 SOAP

• 이제 모든 WSDL 작업이 프록시 리소스('/cityforecastbyzip' 등)가 아닌 프록시 기본 경로 '/'로 전송됩니다. 작업 이름은 타겟 SOAP 서비스로 전달됩니다. 이 동작은 SOAP 사양과 일치합니다.

• 생성된 프록시가 더 이상 요청에서 JSON을 지원하지 않습니다. XML만 지원합니다. 프록시는 SOAP 요청에 Envelope, Body, 네임스페이스가 있는지 확인합니다.

REST-SOAP-REST

• WSDL 2.0은 지원되지 않습니다.
• 새 동작은 WS-Policy로 테스트되지 않았습니다.
• 프록시를 사용하면 FormParams 대신 JSON 데이터를 POST할 수 있습니다.
• 프록시 빌더를 사용하여 프록시에 CORS (교차 출처 리소스 공유) 지원을 추가하면 다음과 같은 개선사항이 표시됩니다.
  • Access-Control-Allow-Headers 헤더: Origin, x-requested-with, Accept 헤더 외에도 Access-Control-Allow-Headers 헤더에는 Content-Type, Accept-Encoding, Accept-Language, Host, Pragma, Referrer, User-Agent, Cache-Control이 포함됩니다.
  • Access-Control-Allow-Methods 헤더: GET, PUT, POST, DELETE 외에도 이 헤더에는 PATCH 및 OPTIONS 동사가 포함됩니다.
• WSDL의 API 프록시를 생성할 때 Edge는 WSDL에서 추상으로 정의된 ComplexTypes를 읽고 추상 유형을 기반으로 하는 인스턴스 유형을 올바르게 인식합니다.

wsdl2apigee 오픈소스 명령줄 유틸리티

Apigee는 WSDL에서 패스스루 또는 rest-to-soap API 프록시를 생성하는 오픈소스 명령줄 유틸리티도 제공합니다. https://github.com/apigee/wsdl2apigee를 참고하세요.

(EDGEUI-614)

키 값 맵 작업 정책의 만료/새로고침 기본값 (Cloud 16.06.15 UI)

키 값 맵 작업 정책을 사용하면 값이 새로고침되기 전에 유지되는 시간을 결정할 수 있습니다. 새로고침 간격은 <ExpiryTimeInSecs> 요소로 설정됩니다. GET 작업이 실행되고 만료 간격이 초과된 경우 값이 새로고침되고 정책에서 업데이트된 값을 가져옵니다. 이 정책을 API 프록시에 추가하면 기본 만료 시간이 이제 300초가 됩니다. (이전 기본값은 -1이었으며 이는 값이 새로고침되지 않음을 의미합니다.) (EDGEUI-579)

수익 창출

조정 가능한 알림 요금제 (Cloud 2020년 4월 16일 UI, Cloud 2020년 4월 13일 수익 창출)

Edge 수익 창출의 새로운 조정 가능한 알림 요금제를 사용하면 API 제공업체가 각 앱 개발자의 타겟 트랜잭션 수를 조정할 수 있습니다. 목표 수의 90%, 100%, 150% 등 도달한 비율에 따라 알림을 전송할지 여부와 시기를 구성할 수 있습니다. 이 기능은 이전 버전에서 제공된 관리 API 외에도 관리 UI를 통해 사용할 수 있습니다. 자세한 내용은 조정 가능한 알림 계획 세부정보 지정을 참고하세요. (DEVRT-2375, DEVRT-2370)

조정 가능한 알림 요금제 (Cloud 16.04.27 수익 창출)용 웹훅 알림

조정 가능한 알림 요금제의 경우 지정한 URL로 알림을 전송하는 웹훅을 만들 수 있습니다. 거래 한도에 도달할 때까지 특정 간격 (백분율)으로 알림이 발생하도록 제어할 수도 있습니다. 웹훅 알림은 기존 알림 템플릿을 사용하는 대신 유연하게 사용할 수 있는 대안입니다. 웹훅을 사용하여 알림 설정하기를 참고하세요. (DEVRT-2393, DEVRT-2394)

맞춤 속성 요금제를 사용한 조정 가능한 알림 (Cloud 16.05.18 UI)

Edge 수익 창출에서 새로운 '맞춤 속성이 포함된 조정 가능한 알림' 요금제를 사용하면 맞춤 속성 값을 사용하여 개발자의 거래 수를 추가할 수 있습니다. 표준 조정 가능한 알림 요금제를 사용하면 API 호출이 성공할 때마다 개발자의 거래 수에 1이 추가됩니다. 하지만 맞춤 속성이 있는 조정 가능한 알림 요금제의 경우 맞춤 속성 값이 개발자의 거래 수에 추가됩니다. 예를 들어 맞춤 속성 'small'의 값이 응답에서 0.1인 경우 거래 수가 0.1만큼 증가합니다. 맞춤 속성 'addressTotal'의 값이 50인 경우 거래 수가 50만큼 증가합니다. 자세한 내용은 맞춤 속성 세부정보로 요금제 지정을 참고하세요. (DEVRT-2504)

회사 및 개발자의 합산 거래 총액을 기반으로 알림 설정(Cloud 2022년 6월 16일 수익 창출)

일반적으로 개발자가 회사 앱을 사용하여 API에 액세스하면 회사 내 모든 개발자의 거래 합계가 자동으로 추적됩니다. 개발자가 자체 개발자 앱을 사용하여 API에 액세스하고 있으며 트래픽 중단 없이 개발자의 합산 거래 총계를 추적해야 하는 경우 어떻게 해야 하나요? 개발자를 회사에 추가하고 회사 및 개발자의 합산 거래 총계를 기준으로 기준점에 도달하면 알림이 전송되도록 설정할 수 있습니다. 자세한 내용은 회사 및 개발자의 합산 거래 총액에 따라 알림 설정하기를 참고하세요. (DEVRT-2643)

알림 보기 및 재처리 (Cloud 16.06.08 수익 창출)

수익 창출 테스트 모음의 일부로 관리 API를 사용하여 이전에 전송된 알림을 보고 다시 처리할 수 있습니다. 자세한 내용은 알림 보기 및 재처리를 참고하세요. (DEVRT-2643)

수익 창출 테스트 (클라우드 16.05.25 수익 창출)

수익 창출에서는 웹훅 실행을 테스트하여 알림이 전송되는지 확인할 수 있는 API 세트를 제공합니다. 자세한 내용은 알림 설정 테스트를 참고하세요. (DEVRT-2625)

개발자를 수익 창출로 마이그레이션 (Cloud 16.05.11 수익 창출)

개발자의 수익 창출로의 이전을 용이하게 하는 새로운 API가 제공됩니다. 거래 사용량을 이전하고 맞춤 설정 및 반복 수수료를 청구할 수 있습니다. 또한 게시된 요금제를 수락할 때 이미 청구된 경우 설정 수수료를 면제할 수 있습니다. 자세한 내용은 개발자를 수익 창출로 이전하기를 참고하세요. (DEVRT-2446)

개발자 포털의 공개 및 비공개 요금제 (Cloud 16.04.27 수익 창출)

요금제를 '공개' 또는 '비공개'로 설정할 수 있습니다. 공개 요금제는 개발자 포털에 표시되지만 비공개 요금제는 표시되지 않습니다. 요금제의 기본값은 Public입니다. 자세한 내용은 http://docs.apigee.com/monetization/content/create-rate-plans#public-versus-private-rate-plans을 참고하세요. (DEVRT-2445)

개발자 정지 해제 (클라우드 16.06.08 수익 창출)

수익 창출에서는 이전에 정지된 개발자를 정지 해제하는 데 사용할 수 있는 API 집합을 제공합니다. 구성된 한도에 도달하면 개발자가 정지될 수 있습니다. 예를 들어 거래 수가 최대 한도에 도달했거나 선불 계정 잔액이 소진된 경우입니다. 자세한 내용은 개발자 정지 해제를 참고하세요. (DEVRT-2641)

거래 상태 보기 (Cloud 16.06.08 수익 창출)

수익 창출 테스트 스위트의 일부로 관리 API를 사용하여 지정된 기간에 발생한 거래의 상태를 볼 수 있습니다. 자세한 내용은 트랜잭션 상태 보기를 참고하세요. (DEVRT-2640)

수익 보고서에 개발자 맞춤 속성 포함 (Cloud 16.05.25 수익 창출)

수익 보고서의 경우 맞춤 속성이 개발자에게 정의되어 있으면 보고서에 맞춤 속성을 포함할 수 있습니다. 자세한 내용은 API를 사용하여 수익 보고서에 개발자 맞춤 속성 포함을 참고하세요. (DEVRT-2447)

거래 기록 정책 및 API 제품 리소스 일관성 (Cloud 16.05.18 UI)

수익 창출 거래 기록 정책의 리소스 경로가 API 제품에 정의된 리소스 경로와 일치하지 않으면 (예: API 제품 리소스 경로를 변경한 경우) 제품 페이지의 거래 기록 정책 아이콘에 경고 기호가 표시됩니다. 아이콘을 클릭하여 거래 기록 정책을 보면 페이지 상단에 경고가 표시됩니다. 트랜잭션 기록 정책에서 리소스 경로를 수정하면 경고 표시기가 사라집니다. (DEVRT-2240)

수정된 버그

다음은 이번 출시 버전에서 수정된 버그입니다. 이 목록은 주로 자신의 지원 티켓에서 제기한 문제가 수정되었는지 확인하는 사용자를 위한 것입니다. 모든 사용자에게 자세한 정보를 제공하기 위한 목적은 아닙니다.

프라이빗 클라우드용 Edge

16.08.17

16.07.27 (UI)

16.07.20.01 (수익 창출)

이 출시에는 사소한 DB 스키마 변경사항이 포함되어 있습니다. 이 출시에는 다른 소프트웨어 업데이트가 없습니다.

16.07.13 (UI)

16.07.06.02 (수익 창출)

16.07.06 (수익 창출)

16.06.29 (UI)

2022년 6월 16일 (수익 창출)

없음

16.06.15 (UI)

16.06.08 (수익 창출)

없음

2025년 5월 16일 (수익 창출)

16.05.18 (UI)

16.05.11 (수익 창출)

16.05.11 (UI)

16.05.04 (UI)

16.04.27 (UI)

16.04.27 (수익 창출)

없음

2020년 4월 16일 (UI)

16.04.13 (수익 창출)

없음

16.04.13 (UI)

알려진 문제

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