4.16.01 - Private Cloud용 Edge 출시 노트

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

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

이전 Edge for Private Cloud 분기별 출시 (4.15.07.00) 이후 다음 출시가 있었으며 이 기능 출시에 포함되어 있습니다.

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

지원 중단

프라이빗 클라우드 4.15.07.03

API 설명
QPID 대기열 확인 더 이상 API를 사용하여 QPID 대기열을 확인할 수 없음
다음 CURL 명령어를 실행하여 QPID 서버에서 생성된 대기열을 더 이상 확인할 수 없습니다.
curl http:// <qpid_IP>:8083/v1/servers/self/queues
해당 API는 지원 중단되었습니다.

애널리틱스: 여러 보고서의 맞춤 보고서 대시보드 보기(Cloud 15.09.30)

최대 4개의 맞춤 보고서를 표시하는 특정 맞춤 보고서 대시보드 기능이 지원 중단되며 향후 출시에서 삭제될 예정입니다. (MGMT-2673) 커스텀 보고서의 다른 모든 측면은 계속 사용할 수 있습니다.

프라이빗 클라우드에서 조직 이름 길이를 재정의할 수 없음

다음과 같이 설정하여 조직 이름 길이를 20자로 재정의할 수 없습니다.

  • APIGEE_ORG_NAME_LENGTH=25
  • APIGEE_ENV_NAME_LENGTH=25

새로운 기능 및 개선사항

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

프라이빗 클라우드

RedHat, CentOS, Oracle 6.7~7.2 지원 추가

이 출시에서는 RedHat Enterprise Linux, CentOS, Oracle Linux 버전 6.7~7.2에 대한 지원이 추가되었습니다.

시스템 요구사항의 전체 목록은 지원되는 소프트웨어 및 지원되는 버전을 참고하세요.

RPM 기반 설치

이 Edge 버전에서는 RPM 기반 설치 메커니즘을 사용하여 설치 및 이전 절차를 크게 간소화합니다.

새 기본 디렉터리

Edge 4.16.01 버전의 디렉터리 구조가 변경되었습니다. 이전 Edge 출시에서는 기본 디렉터리에 Edge를 설치했습니다.

/<install-dir>/apigee4

install-dir은 어디에나 있을 수 있으며 기본값은 /opt입니다. 예를 들면 다음과 같습니다.

/opt/apigee4

버전 4.16.01의 경우 Edge를 다음 디렉터리에 설치해야 합니다.

/opt/apigee

apigee4 디렉터리가 apigee로 변경된 것도 확인하세요.

데이터 디렉터리의 위치는 영향을 받지 않습니다. /opt/apigee에 있을 수도 있고 다른 위치에 있을 수도 있습니다.

새 가상 호스트 요구사항

Edge 이전 스크립트는 기존 Netty 라우터를 Nginx로 이전하는 데 필요한 대부분의 작업을 처리합니다. 하지만 업그레이드의 일환으로 마이그레이션하기 전에 모든 가상 호스트 정의에 호스트 별칭이 포함되어 있는지 확인해야 합니다.

호스트 별칭을 기존 가상 호스트에 추가하는 방법에 관한 자세한 내용은 Apigee ftp 사이트(ftp://ftp.apigee.com/)에서 제공되는 Edge 설치 가이드 를 참고하세요.

구성을 사용한 코드

Edge 버전 4.16.01에서는 더 이상 /<install-dir>/apigee4/conf 디렉터리 아래의 .properties 파일을 사용하여 Edge 구성요소를 구성하지 않습니다. 4.16.01부터는 .properties 파일을 사용하여 Edge 구성요소를 구성하지만 이제는 다음 디렉터리에 있습니다.

/opt/apigee/customer/application

노드에 설치된 각 Edge 구성요소에 대해 해당 디렉터리에 .properties 파일이 있습니다. 구성요소를 구성하려면 해당 .properties 파일을 수정하여 기존 속성의 값을 변경하거나 새 속성과 값을 추가합니다. 파일이 아직 없는 경우 파일을 만들 수 있습니다.

이전 버전의 Edge와 달리 Edge 4 .16.01의.properties 파일에는 구성요소의 모든 속성이 포함되어 있지 않습니다. 이번 출시의 변경사항 중 하나는 .properties 파일에 기본 속성 값의 재정의만 포함된다는 것입니다.

이 아키텍처의 장점은 최신 버전의 Edge로 이전할 때 Edge 설치 프로그램이 /opt/apigee/customer/application의 파일을 덮어쓰지 않는다는 것입니다. 이렇게 하면 Edge에서 실수로 설정을 덮어쓸 가능성이 없어집니다.

마이그레이션 시 Edge 설치 프로그램은 기존 .properties 파일을 검사하고 변경사항을 기본 속성 값에 복사하여 /opt/apigee/token 디렉터리에 저장합니다. 따라서 마이그레이션 후에는 수정할 필요가 없습니다.

자세한 내용은 Apigee ftp 사이트(ftp://ftp.apigee.com/)에서 제공되는 Apigee Edge 작업 가이드를 참고하세요.

에지 구성 스크립트가 대체됨

이전 버전의 Edge에서 사용한 구성 스크립트가 삭제되고 다음 중 하나로 대체되었습니다.

  • apigee-service, apigee-all, apigee-setup, apiee-provision 또는 apigee-migrate 유틸리티와 같은 Apigee 유틸리티를 통해 실행하는 명령어
    예를 들어 all-start.sh 및 all-stop.sh 스크립트는 다음 명령어로 대체되었습니다.
    > /opt/apigee/apigee-service/bin/apigee-all start
    > /opt/apigee/apigee-service/bin/apigee-all stop
  • Edge 구성요소에서 직접 실행하는 명령어 예를 들어 이전 버전에서는 OpenLDAP 비밀번호를 변경하는 데 사용되는 chpasswd-openldap.sh 스크립트를 사용했습니다. 이 스크립트는 apigee-openldap 구성요소에서 실행하는 다음 명령어로 대체되었습니다.
    > /opt/apigee/apigee-service/bin/apigee-service apigee-openldap change-ldap-password -o oldPword -n newPword

명령어를 통해 구성하는 방법에 관한 자세한 내용은 Apigee ftp 사이트(ftp://ftp.apigee.com/)에서 제공되는 Apigee Edge 작업 가이드를 참고하세요.

새 에지 라우터

이 Private Cloud용 Edge 버전에는 Nginx 라우터를 기반으로 하는 새로운 라우터 아키텍처가 포함되어 있습니다. Nginx 라우터는 4.16.01 이전 Edge 출시에서 사용된 Netty 라우터를 대체합니다.

Nginx 라우터는 Netty 라우터와 동일한 하드웨어 및 포트 요구사항을 가지므로 기존 노드를 변경할 필요가 없습니다.

자세한 내용은 Apigee ftp 사이트(ftp://ftp.apigee.com/)에서 제공되는 Edge 설치 가이드 의 부록 A: Nginx 라우터 정보를 참고하세요.

BaaS 부하 분산기 삭제됨

내부 부하 분산기가 API BaaS 포털에서 삭제되었습니다. 이제 API BaaS 포털과 세 개의 API BaaS 스택 노드 사이에 자체 부하 분산기를 사용해야 합니다.

부하 분산기의 대안으로 round-robin DNS를 사용할 수 있습니다. 이 시나리오에서는 BaaS 스택 IP 주소에 해당하는 A 레코드가 여러 개인 DNS 항목을 만듭니다. DNS 조회 중에 DNS 서버는 라운드 로빈 방식으로 A 레코드 값을 자동으로 반환합니다.

Cassandra 및 ZooKeeper 노드를 추가하는 방법과 기존 데이터 센터에 데이터 센터를 추가하는 방법을 설명하는 새로운 문서

이제 Apigee ftp 사이트의 문서 ZIP 파일에는 Cassandra 및 ZooKeeper 노드를 추가하는 방법과 기존 데이터 센터에 데이터 센터를 추가하는 방법을 설명하는 '프라이빗 클라우드용 Edge 확장'이 포함되어 있습니다.

Orgtool이 삭제됨

orgtool은 Edge 설치를 쿼리하여 조직에 관한 정보를 가져올 수 있습니다. 이제 해당 도구가 삭제되었습니다. 이제 Edge UI 또는 API 호출을 사용하여 조직에 관한 정보를 가져옵니다.

4.16.01에서 작업을 수행하는 방법

다음 표에서는 4.15.07.03에서 작업을 수행한 방법과 현재 4.16.01에서 작업을 수행하는 방법을 보여줍니다. 자세한 내용은 Apigee ftp 사이트(ftp://ftp.apigee.com/)에서 제공되는 Edge 작업 가이드를 참고하세요.

작업 4.15.07.0x 4.16.01

설치 디렉터리

/<inst_dir>/apigee4 /opt/apigee

로그 디렉터리

/<inst_dir>/apigee4/var/log /opt/apigee/var/log/comp

구성요소 설치

/<inst_root>/apigee4/share/installer/apigee-setup.sh -p comp -f configFile

/opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

모든 시작, 중지, 다시 시작, 상태, 버전

/<inst_root>/apigee4/bin/all-start.sh
/<inst_root>/apigee4/bin/all-stop.sh
/<inst_root>/apigee4/bin/all-status.sh
/<inst_root>/apigee4/bin/check.sh

/<inst_root>/apigee/apigee-service/bin/apigee-all start|stop|restart|status|version

구성 시작, 중지, 다시 시작, 상태, 버전

/<inst_root>/apigee4/bin/apigee-service comp start|stop|restart|status

/<inst_root>/apigee/apigee-service/bin/apigee-service comp start|stop|restart|status|version

백업/복원

/<inst_root>/apigee4/bin/backup.sh
/<inst_root>/apigee4/bin/restore-comp.sh

/<inst_root>/apigee/apigee-service/bin/apigee-service comp backup

/<inst_root>/apigee/apigee-service/bin/apigee-service comp restore

테스트 설치

/<inst_root>/apigee4/test/test-sa.sh

  1. /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
  2. /opt/apigee/apigee-service/bin/apigee-service apigee-validate setup

온보딩

/<inst_root>/apigee4/bin/setup-org.sh

  1. /opt/apigee/apigee-service/bin/apigee-service apigee-provision install
  2. /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

한 단계로 조직, 환경, 가상 호스트 추가

/<inst_root>/apigee4/bin/setup-org.sh

/<inst_root>/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

조직 추가

/<inst_root>/apigee4/bin/create-org.sh

/<inst_root>/apigee/apigee-service/bin/apigee-service apigee-provision create-org -f configFile

환경 추가

/<inst_root>/apigee4/bin/add-env.sh

/<inst_root>/apigee/apigee-service/bin/apigee-service apigee-provision add-env -f configFile

사용자 추가

API 호출

API 호출 또는

/<inst_root>/apigee/apigee-service/bin/apigee-service apigee-provision create-user -f configFile

마이그레이션

/<install_root>/apigee4/share/installer/apigee-upgrade.sh -c comp

  1. /opt/apigee/apigee-service/bin/apigee-service apigee-migrate install
  2. /opt/apigee/apigee-migrate/bin/migrate.sh -c cs,zk -f configFile

모니터링 도구 및 대시보드의 알파 출시

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

설치 안내를 비롯한 문서는 Apigee ftp 사이트(ftp://ftp.apigee.com/)에서 제공되는 Edge 4.16.01 문서의 ZIP 파일에 포함되어 있습니다.

하지만 대시보드를 설치하고 사용하려면 문서 ZIP 파일에 포함된 Apigee 평가 계약을 작성하여 orders@apigee.com으로 이메일을 보내 Apigee에 반환해야 합니다.

Edge 플랫폼

관리 UI 스타일 변경 (Cloud 15.09.30)

관리 UI의 여러 페이지가 디자인 업데이트되었습니다. (MGMT-2627)

API 서비스

API 프록시 마법사 재설계 (Cloud 2016년 1월 20일)

API 프록시 마법사가 재설계되었습니다. 관리 UI의 API 프록시 페이지에서 '+ API 프록시'를 클릭하면 새 마법사가 API 프록시 생성 프로세스를 안내합니다. 이전 API 프록시 마법사와 동일한 모든 설정을 사용할 수 있습니다. (MGMT-1376)

OpenAPI (Swagger) 문서로 API 프록시 만들기 (Cloud 2016년 1월 20일)

새 API 프록시 마법사 재설계의 일환으로 이제 OpenAPI(Swagger) 문서에서 API 프록시를 만들 수 있습니다. API 프록시 마법사의 첫 번째 페이지에서 역방향 프록시, Node.js 앱 또는 대상 없음을 선택할 때 OpenAPI 사용을 클릭합니다. 표시되는 필드에 OpenAPI 문서의 URL을 입력합니다. 자세한 내용은 간단한 API 프록시 빌드를 참고하세요. (MGMT-1376)

SOAP 프록시용 WSDL 1.2 지원 (Cloud 16.01.20)

Apigee Edge는 SOAP 서비스를 호출하는 API 프록시를 만들 때 WSDL 1.2를 지원합니다. (MGMT-2835)

TargetEndpoint 구성의 SSLInfo 변수 (Cloud 16.01.20)

API 프록시 TargetEndpoint에서 SSL/TLS 세부정보를 동적으로 설정하여 유연한 런타임 요구사항을 지원할 수 있습니다. TargetEndpoint 구성에서 SSLInfo가 설정되는 방식에 대한 다음 예시에서는 Java Callout, JavaScript 정책 또는 Assign Message 정책으로 런타임 시에 값을 제공할 수 있습니다. 설정하려는 값이 포함된 메시지 변수를 사용하세요.

<TargetEndpoint>
...
  <SSLInfo>
    <Enabled>{myvars.ssl.enabled}</Enabled>
    <ClientAuthEnabled>{myvars.ssl.client.auth.enabled}</ClientAuthEnabled>
    <KeyStore>{myvars.ssl.keystore}</KeyStore>
    <KeyAlias>{myvars.ssl.keyAlias}</KeyAlias>
    <TrustStore>{myvars.ssl.trustStore}</TrustStore>
  </SSLInfo>
...
</TargetEndpoint>

이 기능은 다음 문서에서 다룹니다.

(APIRT-1475)

SAML 어설션 정책에 대한 RSA_SHA256 알고리즘 지원 (Cloud 16.01.20)

이제 SAML 어설션 정책에서 RSA_SHA1 외에 RSA_SHA256 알고리즘도 지원합니다. (APIRT-1779)

인증서 업로드 시 유효성 검사 (Cloud 2016년 1월 20일)

만료되었거나 유효하지 않은 인증서가 키 저장소 및 신뢰 저장소에 업로드되지 않도록 관리 API는 업로드 시 인증서를 검사합니다. 인증서는 파일 크기가 50KB를 초과하지 않고 형식이 PEM 또는 DER인지 확인하기 위해 검증됩니다. 인증서 만료도 검증됩니다. 기본 만료 유효성 검사를 재정의하여 업로드 시 인증서 만료를 검사하지 않으려면 다음 쿼리 매개변수를 사용하세요. ?ignoreExpiryValidation=true

자세한 내용은 키 저장소에 JAR 파일 업로드 트러스트 저장소에 인증서 업로드를 참고하세요. (SECENG-516) 및 (APIRT-2213)

Node.js 로그 페이지의 자동 폴링 (Cloud 2020년 1월 16일)

프록시 편집기에서 Node.js 로그를 볼 때 사용 가능한 새 로그를 나열하기 위해 Node.js 로그 페이지가 주기적으로 자동으로 새로고침됩니다. '자동 새로고침 중지'를 클릭하여 자동 새로고침을 사용 중지합니다. (MGMT-1692)

X-Forwarded-For HTTP 헤더 (Cloud 15.09.30)

보안 강화를 위해 Edge는 기본적으로 하나 이상의 IP 주소를 포함할 수 있는 X-Forwarded-For HTTP 요청 헤더를 삭제합니다. 새 기본 동작은 Edge가 수신한 클라이언트 IP 주소가 마지막 외부 TCP 핸드셰이크에서 수신한 IP 주소이며 액세스 제어 정책을 우회하기 위해 스푸핑될 수 있는 주소가 아님을 의미합니다.

이 기본 동작을 변경하고 X-Forwarded-For 주소가 API 프록시에 도달하도록 허용하려면 조직에서 feature.enableMultipleXForwardCheckForACL=true 속성을 설정해야 합니다.

정책 속성에 대한 JavaScript 액세스 (클라우드 15.07.08)

API 프록시 흐름에서 JavaScript를 사용하는 경우 JavaScript 정책에 정의된 속성에 액세스할 수 있습니다. 이는 JavaScript 코드에서 잘 알려진 변수를 사용하려는 경우에 특히 유용합니다. 예를 들어 JavaScript 정책에 다음 속성 정의가 포함되어 있다고 가정해 보겠습니다.

<Properties>
    <Property name='source'>response.content</Property>
</Properties>

JavaScript에서 다음과 같이 'source' 속성을 참조하여 메시지 응답에 액세스할 수 있습니다.
var source = properties.get('source'); // returns: response.content
또는
var source = properties.source
또는
var source = properties['source']

자세한 내용은 JavaScript 정책을 참고하세요. (APIRT-1460)

조직 수준 감사 (클라우드 15.07.08)

조직 관리자는 조직 수준에서 취해진 조치의 기록을 감사할 수 있습니다. 관리 UI에서 관리 > 조직 기록을 선택합니다. 자세한 내용은 감사: API, 제품, 조직 기록을 참고하세요. (MGMT-2232)

역할에서 조직 관리자 자체 삭제 (Cloud 15.07.08)

조직 관리자는 관리 UI에서 관리 > 조직 사용자로 이동하여 이름 옆에 있는 삭제를 클릭하여 조직 관리자 역할에서 자신을 삭제할 수 있습니다. (MGMT-934)

API 프록시 번들 가져오기 진행률 표시기 (Cloud 15.07.08)

관리 UI에서 대규모 API 프록시 번들을 업로드할 때 가져오기가 아직 진행 중임을 나타내는 '작업 중' 애니메이션이 표시되므로 가져오기가 완료될 때까지 관리 UI와 상호작용할 수 없습니다. (MGMT-1285)

캐시 동작 및 구성 (Cloud 2015년 7월 22일)

인메모리 캐시 관리 및 활용을 개선하기 위해 환경 캐시 리소스의 '메모리의 최대 요소' 설정이 Edge 클라우드 출시 15.06.10부터 지원 중단되었습니다. Edge Cloud 버전 15.07.22에서는 이 설정이 Apigee Edge 관리 UI의 환경 구성 부분에 있는 캐시 만들기 UI에서 삭제되었습니다.

모든 캐시 리소스 (기본 캐시 포함)에 있는 총 요소는 캐시에 할당된 총 메모리에 따라 달라집니다. 기본적으로 지정된 메시지 프로세서의 인메모리 캐싱에 할당된 총 메모리는 사용 가능한 총 메모리의 40% 입니다. 요소는 캐시 메모리가 부족하거나 요소가 만료된 경우에만 메모리 내 캐시에서 삭제됩니다. (MGMT-2413, APIRT-1140)

관리 UI의 대상 서버 구성 (Cloud 15.07.22)

이제 관리 UI의 API > 환경 구성 페이지에서 대상 서버를 추가, 수정, 삭제할 수 있습니다.

또한 새 페이지로 이동하지 않고 인라인으로 캐시를 생성, 추가, 삭제할 수 있도록 페이지가 재설계되었습니다. '메모리의 최대 요소 수'를 비롯한 여러 캐시 속성은 더 이상 UI에서 사용할 수 없습니다. 이러한 속성을 설정해도 런타임 캐시 동작에 영향을 주지 않기 때문입니다. (MGMT-280)

syslog에 메시지 로깅이 있는 SSL (Cloud 15.07.22)

메시지 로깅 정책은 SSL/TLS를 통해 서드 파티 로그 관리 제공업체에 syslog를 전송하는 것을 지원합니다. 정책 구성에서 다음을 상위 요소의 직접 하위 요소로 사용합니다.

<SSLInfo>
    <Enabled>true</Enabled>
</SSLInfo>

자세한 내용은 메시지 로깅 정책을 참고하세요. (APIRT-942)

관리 UI (클라우드 2022년 7월 15일)

Apigee 엔지니어링팀에서 관리 UI의 다양한 작은 버그를 수정하고 사용 편의성을 개선했습니다.

Trace의 cURL (클라우드 15.09.02)

대상 서버에 요청을 보내는 API 프록시 호출을 추적할 때 대상 서버에 대한 요청을 cURL 명령어로 볼 수 있습니다. 트랜잭션 지도 다이어그램에서 '타겟 서버에 전송된 요청' 단계를 선택한 다음 단계 세부정보 창의 '타겟 서버에 전송된 요청' 열에서 'Curl 표시' 버튼을 클릭합니다. (MGMT-2589)

데이터 마스킹 특수 문자 (Cloud 15.09.02)

데이터 마스킹을 사용하여 JSON 페이로드의 민감한 데이터를 마스킹할 때 이제 $, *, {와 같은 특수 문자를 마스킹할 수 있습니다. (APIRT-1727)

관리 UI의 키-값 맵 (Cloud 15.09.30)

이제 Edge 관리 UI에서 환경 범위의 키-값 맵 (KVM)을 만들고 관리할 수 있습니다. 환경 범위 KVM에는 테스트 또는 프로덕션과 같은 환경의 모든 API 프록시가 액세스할 수 있는 키/값 쌍이 포함됩니다. 관리 UI 메뉴에서 API > 환경 구성 > 원하는 환경 선택 > 키-값 맵 탭으로 이동합니다. 자세한 내용은 환경 키 값 맵 만들기 및 수정을 참고하세요. (MGMT-1393)

관리 UI의 PopulateCache 정책 기본 만료 (Cloud 15.09.30)

API 프록시 편집기로 PopulateCache 정책을 추가하면 캐시 만료의 <TimeoutInSec> 요소가 3, 600초 (1시간) 값으로 미리 채워집니다. 이전 기본값은 300초 (5분)였습니다. (MGMT-2622)

개발자 서비스

API 제품 페이지 성능, 개발자 앱이 나열되지 않음 (Cloud 2016년 1월 20일)

관리 UI에서 API 제품을 보면 해당 제품과 연결된 개발자 앱이 나열됩니다. UI 성능을 개선하기 위해 API 제품을 수정할 때는 개발자 앱 목록이 표시되지 않습니다. (MGMT-2869)

개발자 앱 페이지의 키 열 (Cloud 15.08.05)

개발자 앱이 많은 (수천 개) 조직에서는 개발자 앱 페이지에 키 열을 표시하면 (앱당 키 수를 표시) 표시 성능이 저하될 수 있습니다. 이 경우 표시 성능을 개선하려면 Apigee 지원팀에 문의하여 조직 수준 속성 features.appsNoCredentialsEnabled = true를 설정하세요. 이 속성은 키 열을 삭제합니다. 하지만 키 열을 삭제하면 고객 키와 보안 비밀로 검색하는 기능도 삭제됩니다. (MGMT-2486)

개발자 세부정보 페이지 진행률 스피너 (Cloud 15.09.30)

관리 UI에서 개발자 세부정보 페이지가 로드되면 앱이 아직 로드 중인 경우 페이지의 앱 섹션에 진행률 스피너가 표시됩니다. 이렇게 하면 앱을 로드하는 동안 앱 섹션이 비어 있던 이전 동작이 개선됩니다. (MGMT-2667)

수익 창출

API 패키지 이름 수정 (Cloud 16.01.20)

API 패키지에 게시된 요금제가 포함된 경우에도 수익 창출 수명 주기 중 언제든지 API 패키지의 이름을 업데이트할 수 있습니다. (DEVRT-2177)

맞춤 속성에 허용되는 소수점 (클라우드 2016년 1월 20일)

'맞춤 속성이 있는 요금 카드' 요금제를 사용하는 경우 이제 거래의 승수로 사용되는 메시지 헤더의 맞춤 속성이 최대 소수점 이하 4자리까지의 십진수 값이 될 수 있습니다. 이 유형의 요금제에 대한 자세한 내용은 요율표 맞춤 속성 세부정보 지정 (DEVRT-2191)을 참고하세요.

요약 보고서의 요금제 이름 및 ID (Cloud 15.09.02)

관리 API로 요약 수익 보고서를 생성할 때 보고서에 '요금제' 이름 및 요금 '요금제 ID' 열을 추가할 수 있습니다. 이렇게 하려면 보고서 만들기에 설명된 대로 API 호출에 'RATEPLAN'을 groupBy 속성으로 추가하세요. (이 기능은 아직 수익 창출 보고서 UI에서 사용할 수 없습니다.) 세부정보 보고서에서 기존 요금제 이름 및 ID 열이 이제 다른 그룹화 열과 함께 보고서 앞쪽에 있습니다. (DEVRT-1740)

분석 서비스

응답 시간 측정항목의 sum( ) 함수 (Cloud 2016년 1월 20일)

이제 분석 맞춤 보고서 및 API 호출에서 타겟 응답 시간, 총 응답 시간, end_point_response_time에 '합계' 집계 함수를 사용할 수 있습니다. 예를 들어 /stats API(http://docs.apigee.com/management/apis/get/organizations/%7Borg_name%7D/environments/%7Benv_name%7D/stats/%7Bdimension_name%7D-0)에서 이제 ?select=sum(total_response_time)과 같은 'select' 쿼리 매개변수를 사용할 수 있습니다. (AXAPP-2006)

지연 시간 분석 보고서: API 프록시 이름 정렬 (Cloud 2016년 1월 20일)

지연 시간 분석 보고서 UI (Apigee Edge 엔터프라이즈 요금제만 해당)에서 API 프록시는 프록시 드롭다운 목록에 알파벳순으로 나열됩니다. (MGMT-2858)

표시 이름으로 표시되는 대시보드의 개발자 앱 (Cloud 2016년 1월 20일)

관리 UI 대시보드에서 개발자 앱 막대 그래프는 내부 이름이 아닌 표시 이름으로 개발자 앱을 나열합니다. (MGMT-2853)

맞춤 보고서의 새로운 날짜/시간 위젯 (클라우드 16.01.20)

관리 UI의 맞춤 보고서 페이지에 있는 날짜/시간 선택 도구 위젯이 개선되었습니다. (MGMT-2881)

GeoMap의 도시 드릴다운 (Cloud 2022년 7월 15일)

애널리틱스 지역 지도에는 미국과 캐나다의 '도시' 드릴다운이 포함됩니다. 지도에서 주 또는 도를 클릭하면 통화가 시작된 도시 목록이 표시됩니다. (MGMT-2282)

분석 맞춤 보고서의 | (파이프) 및 = 문자 (Cloud 15.09.02)

애널리틱스 맞춤 보고서 정의는 | (파이프) 및 = 기호의 사용을 지원합니다. 이전에는 이러한 기호에 %7C 및 %3D 인코딩을 사용해야 했습니다. (MGMT-2504)

프록시 경로 서픽스 측정기준 (클라우드 2015년 9월 30일)

분석 맞춤 보고서 및 API 호출에서 새로운 프록시 경로 접미사 (proxy_pathsuffix) 측정기준을 사용할 수 있습니다. 프록시 경로 접미사는 기본 경로 뒤에 오는 API 프록시 URL의 일부입니다(예: 조건부 흐름에 대해 생성된 경로). (AXAPP-1902)

보고서에 개발자 ID가 표시 이름이 아닌 개발자 ID로 표시됨 (Cloud 2015년 9월 30일)

개발자를 반환하는 /stats API를 사용하여 Edge 분석 API 호출을 수행하면 개발자 ID와 함께 개발자 표시 이름이 반환됩니다. 이전에는 개발자 ID만 반환되었습니다. (AXAPP-1759)

수정된 버그

다음은 이번 출시 버전에서 수정된 버그입니다.

프라이빗 클라우드 4.16.01

다음 표에는 Edge for Private Cloud 4.16.01 출시 이후 수정된 버그가 나와 있습니다. 이러한 수정사항을 적용하려면 Apigee Edge 4.16.01.x를 최신 4.16.01 출시로 업데이트에 설명된 대로 4.16.01 설치를 최신 RPM 및 지원 파일로 업데이트하는 안내를 따르세요.

문제 ID 설명 빌드 번호
PRC-736

apigee-lib에 더 이상 GCC가 필요하지 않음

apigee-lib-4.16.01-0.0.901
PRC-735

Yahoo Weather API에 OAuth가 필요하므로 더 이상 apigee-validate가 실패하지 않음

apigee-validate-4.16.01-0.0.910
PRC-739

사용자가 모든 파일 시스템 폴더에서 미러를 추출하도록 허용

apigee-mirror-4.16.01-0.0.904
PRC-756

BaaS Usergrid check_cassandra_availability.sh가 더 이상 nc 명령어를 사용하지 않음

baas-usergrid-2.1.0-0.0.112
PRC-778

업그레이드 후 Zookeeper 클러스터 정보가 더 이상 손실되지 않음

apigee-migrate-4.16.01-0.0.873
PRC-787

API BaaS에서 이제 Cassandra 인증 지원

baas-usergrid-2.1.1-0.0.122
PRC-804

이제 로그 파일의 위치를 지정할 수 있음

apigee-service-4.16.05-0.0.435
PRC-840

Edge 구성요소의 심볼릭 링크가 손상됨

edge-gateway-4.16.01-0.0.538

EDGEUI-538
EDGEUI-524

WSDL 가져오기 시 SOAP 프록시 생성 중단/ WSDL에서 API 프록시 생성 문제

edge-ui-4.16.01-0.0.3650
EDGEUI-543

URL이 로컬 주소인 경우 URL에서 WSDL을 가져올 수 없음 옵션

edge-ui-4.16.01-0.0.3650
APIRT-2719
APIRT-2918

이제 타겟 호출 시 target.url이 설정됨

edge-gateway-4.16.01-0.0.538

Cloud 16.01.20

문제 ID 설명
MGMT-2964 새 프록시 편집기에서 Flows 태그 내의 댓글을 허용하지 않음
MGMT-2957 조직에 새 포드를 추가하면 새 포드의 라우터에 번들의 배포 상태가 오류로 반환됨
MGMT-2937 맞춤 역할의 권한 부족 오류
MGMT-2875 WSDL SOAP 생성에 SOAP 1.2의 헤더가 잘못됨
MGMT-2739 개발자 앱 보고서, 분석 탭에 이상치 그래프가 표시되지 않음
MGMT-2735 Node.js 로그 새로고침이 완료되거나 중지되지 않음
MGMT-2734 배포된 번들을 저장하려고 할 때 오류가 발생한 후 저장 버튼이 사용 설정되지 않음
MGMT-2729 UI에서 TargetServer의 포트를 업데이트하면 SSLInfo가 삭제됨
MGMT-2702 Firefox 및 IE의 교차 사이트 보안 취약점
교차 사이트 요청을 부적절하게 허용하는 Firefox 및 IE 취약점으로 인해 발생할 수 있는 보안 취약점이 수정되었습니다.
MGMT-2681 프록시 편집기: 조건에서 정규식 일치를 사용하는 경우 흐름 탐색기에 동사가 표시되지 않음
MGMT-2361 RPCException: Call timed out(RPCException: 호출 시간 초과) 오류와 함께 프록시 배포가 실패함
MGMT-1662 Apigee 퍼블릭 클라우드 출시 중에 API 프록시 배포가 실패함
DEVRT-2286 sync-organization 수익 창출 API가 작동하지 않음
Apigee Edge 데이터를 수익 창출과 동기화하는 데 사용되는 API가 16.01.20 출시의 최신 새로고침으로 수정되었습니다.
DEVRT-2173 패키지 이름을 변경해야 하지만 활성 요금제로 인해 수정할 수 없음
DEVRT-1661 요금제 시작일 전에 API 요청을 실행하여 개발자가 차단되었지만 차단이 해제되지 않음
API 개발자가 향후 시작되는 월별 고정, 볼륨 기반 또는 번들 요금제를 수락한 후 지정된 시작일 전에 API 요청을 전송하면 API 개발자가 추가 요청을 실행할 수 없게 됩니다. 요금제 시작일에 도달하면 차단이 해제됩니다.
DEVRT-1643 저장 후 요금제 초안이 손상됨
AXAPP-1991 Apigee 애널리틱스 요약 및 이메일 수신 거부를 선택해도 중지되지 않음
AXAPP-1946 애널리틱스 정리로 디스크 공간이 확보되지 않음
AXAPP-1708 질문 방식에 따라 동일한 통계에 대해 애널리틱스 API에서 다른 숫자가 표시되는 것 같습니다
AXAPP-1293 애널리틱스 요약 이메일에 존재하지 않는 개발자 앱 이름이 표시됨
APIRT-2518 JavaScript 정책으로 https 백엔드에 연결하는 데 문제가 있음
APIRT-2398 잘못되었거나 만료된 승인 코드가 Apigee 오류로 집계됨
APIRT-2397 steps.assignmessage.SetVariableFailed가 Apigee 오류로 계산됨
APIRT-2396 OAuth의 IllegalArgumentException, ArrayIndexOutofBoundsException이 Apigee 오류로 집계됨
APIRT-2362 JavaScript 컴파일 오류
APIRT-2322 잘못된 클라이언트 ID가 Apigee 오류로 잘못 보고됨
APIRT-2159 로깅 접두사에 message_id 추가
APIRT-2145 Facebook API의 거래 실패율이 높음
':'로 시작하는 헤더 값의 유효성 검사가 삭제되었습니다.
APIRT-2137 MP: 청크 전송 인코딩 및 콘텐츠 길이 0인 205
APIRT-2124 Nginx 라우터가 새로 추가된 MP의 MP 풀을 업데이트하지 않음
APIRT-2117 메일 로깅 정책이 DNS 업데이트를 따르지 않음
APIRT-2110 라우터에서 하나의 X-Forwarded-For 헤더만 전달
APIRT-2062 SkipCacheLookup 조건이 충족되면 응답 캐시가 올바르게 작동하지 않음
APIRT-2061 메시지 프로세서가 QPID에 메시지를 푸시하지 않음
APIRT-2052 관리 포트가 응답하지 않아 CLOSE_WAIT 수가 많음
APIRT-2024 부하 분산기가 없는 Nginx가 X-Forwarded-For HTTP 헤더를 올바르게 채우지 않음
150930 출시 노트와 액세스 제어 정책에 X-Forwarded-For 지원 중단 알림이 추가되었습니다.
APIRT-1933 프록시 관련 클래스 로더가 여전히 MP 클래스 로더에 위임됨
APIRT-1877 네임스페이스가 있는 XML 응답을 마스킹할 수 없음
APIRT-1838 Apigee-127: 제품이 여러 개 있는 경우 VerifyAPIKey에서 API 제품 하나만 반환됨
APIRT-1827 동시 스트리밍 제한이 낮게 관찰됨
APIRT-1820 4.15.04 프라이빗 클라우드 환경에서 간헐적 지연 시간 (> 1%)
APIRT-707 <GenerateResponse> 요소가 VerifyAccessToken 정책에 있는 경우 런타임 중 NPE

Cloud 15.07.08

문제 ID 설명
MGMT-2381 새 프록시 편집기를 사용하여 프록시를 배포할 수 없음
MGMT-2374 ProxyEndpoint를 저장하기 전에 BasePath 요소의 공백을 잘라야 함
MGMT-2355 역할 중 하나가 orgadmin인 경우 UI에서 여러 역할의 권한을 올바르게 계산하지 않음
MGMT-2324 Swagger 모델을 가져오면 잘못된 SmartDocs 노드가 생성됨
MGMT-1518 MP에서 배포가 실패했지만 UI에 프록시가 배포된 것으로 표시됨
MGMT-1489 API 제품에서 올바른 리소스가 생성되지 않음
DOC-1246 액세스 토큰에 관한 문서의 모순된 설명
DEVRT-1661

개발자가 기능 요금제를 수락할 때 NextRecurringFeeDate가 비어 있음
개발자가 미래 날짜에 시작하는 월간 고정, 볼륨 구간 또는 번들 요금제를 수락하고 시작일 전에 요금제에 대해 API 호출을 몇 번 실행한 후 호출이 차단된 경우 (예상 동작) 요금제가 적용될 때 개발자의 차단이 자동으로 해제되지 않았습니다. 이 문제는 해결되었습니다.

Cloud 15.07.22

문제 ID 설명
TBD-73 Apigee로 향하는 인바운드 트래픽의 고정 IP
MGMT-2422 회사 앱을 수정할 수 없음
MGMT-2419 '사용자' 역할에 속한 사용자가 로그인 시 권한 오류를 수신함
MGMT-2341 맞춤 보고서 필터에서 쿼리를 잘못 빌드함
MGMT-2207 JSONThreatProtection - 포함된 요소가 기본이 아닌 경우 ArrayElementCount가 작동하지 않음
JSON 위협 보호 정책에서 ArrayElementCount 요소가 배열에 허용되는 항목 수를 정확하게 제한하지 않았습니다. 이 문제는 해결되었습니다.
MGMT-2158 출력이 유형이 없는 부분을 참조하는 경우 WSDL을 가져올 수 없음

클라우드 15.08.05

문제 ID 설명
여러 리전 API 프록시 편집기에서 여러 가지 작은 버그가 수정되었습니다.

클라우드 15.09.02

문제 ID 설명
여러 리전 API 프록시 편집기에서 여러 가지 작은 버그가 수정되었습니다.
MGMT-2618 자주 발생하는 배포 문제
MGMT-2588 개발자 기록 페이지에서 html/코드 실행 - XSS 지속성 취약점
MGMT-2543 새 프록시 편집기가 AssignMessage 정책의 <Payload>에서 XML을 수정하여 기존 API 프록시가 중단됨
MGMT-2521 Trace 세션이 때때로 멈춤
MGMT-2519 환경 구성 UI가 작동하지 않음
AXAPP-1814 zk curator가 사용 설정된 경우 프로덕션에서 커스텀 변수 (Statistics Collector 정책)가 생성되지 않음
APIRT-1927 가상 호스트가 잘못되어 라우터가 환경의 구성을 로드하지 않음
APIRT-1863 번들에 공백이 있어 배포 실패
APIRT-1823 & (앰퍼샌드) 문자가 포함된 POST 본문이 있는 API 호출이 중단됨
APIRT-1789 메모리 부족 오류가 발생하는 특정 조직의 메시지 프로세서
APIRT-1776 JavaScript 정책에서 'print'를 호출하면 로깅이 과도하게 발생함
APIRT-1766 WebSocket의 타임아웃
APIRT-1600 라우터의 ConcurrentModificationException
라우터 로그에 정기적으로 로그에 ConcurrentModification이 여러 번 표시되었습니다. 이러한 현상은 리퍼가 이전 연결을 삭제하는 동안 연결이 리퍼 목록에 추가되었기 때문에 발생했습니다. 이 문제는 해결되었습니다.
APIRT-1491 503 서비스를 사용할 수 없음 예외
APIRT-1421 JavaCallout 정책의 처리 시간이 간헐적으로 오래 걸림
DEVRT-1843 Mint UI에서 TRP의 맞춤 속성을 더 잘 업데이트할 수 있어야 함
DEVRT-1472 개발자 업데이트로 인해 500 서버 오류가 발생함

Cloud 15.09.30

문제 ID 설명
MGMT-2687 맞춤 보고서에서 측정기준 요소가 14,000개를 초과하면 브라우저가 멈춤
MGMT-2677 수익 창출: 수천 명의 개발자가 있는 관리 UI의 개발자 페이지가 멈추고 조직에서 페이지로 나누기가 사용 설정되지 않음
MGMT-2674 Edge UI가 사용자 로그인 시 인터넷에서 다운로드하려고 함
MGMT-2658 API 프록시 버전을 업그레이드할 때 OPDK 버전에 따라 달라지는 관리 서버 UI 문제
MGMT-2616 새 API 프록시 편집기에서 XML 엔티티를 올바르게 처리하지 않음
MGMT-2541 비밀번호에 +가 있는 외부 인증 시스템 ID가 sysadmin으로 추가되면 작동하지 않음
MGMT-2510 드롭다운에 조직에 속한 모든 개발자가 표시되지 않음
MGMT-2508 정책에 잘못 표시된 깨진 링크 아이콘
MGMT-2334 두 번째 프록시 엔드포인트에서 리소스에 액세스할 수 없음
MGMT-1967 표시 이름이 동일한 개발자 앱의 트래픽이 분석에 동일하게 표시됨
DEVRT-1839 수익 창출: 관리 UI의 국가 선택 목록이 잘못 정렬됨
AXAPP-1887 필터 조건이 문서에 따라 작동하지 않음
AXAPP-1869 조직에서 사용자를 삭제하면 분석 이메일이 수신 거부되어야 함
AXAPP-1533 애널리틱스 Geomap에 '잘못된 API 호출' 오류가 표시됨
APIRT-2061 메시지 프로세서가 QPID에 메시지를 푸시하지 않음
APIRT-2052 관리 포트가 응답하지 않아 CLOSE_WAIT 수가 많음
APIRT-2024 로드 밸런서가 없는 Nginx가 X-Forwarded-For HTTP 헤더를 올바르게 채우지 않음
APIRT-1838 Apigee-127: 제품이 여러 개 있는 경우 VerifyAPIKey에서 API 제품 하나만 반환됨

프라이빗 클라우드 4.15.07.03

문제 ID 설명
APIRT-1600 라우터 로그의 ConcurrentModificationException
APIRT-1734 조직/환경 수준에서 다운타임 없는 리소스 파일 업데이트
APIRT-1820 4.15.04 프라이빗 클라우드 환경에서 간헐적 지연 시간 (> 1%)
APIRT-2159 로깅 접두사에 message_id 추가
APIRT-2160 분석 데이터에서 request_processing_latency에서 SSL 핸드셰이크 제외
AXAPP-1882 활성/활성 배포에서 소비자 감시자 스레드가 잘못된 대기열에 연결됨
AXAPP-1946 UTC 이외의 시간대에 있을 때 데이터가 하위 팩트 테이블 대신 상위 팩트 테이블로 이동함
MGMT-1590 보안 취약점 수정
MGMT-1662 출시 중에 배포가 실패함
MGMT-2361 RPCException: Call timed out(RPCException: 호출 시간 초과) 오류와 함께 프록시 배포가 실패함
MGMT-2397 코드 보기에서 줄 끝 문자를 올바르게 파싱하지 않음
MGMT-2466 메시지 프로세서에 대한 클러스터 확인에서 연결할 수 없는 라우터가 연결된 구성원으로 표시됨
OPDK-1981 backup-cassandra.sh가 시스템 키스페이스를 백업하지 않음
OPDK-1982 업그레이드 전에 apigee-upgrade.sh에서 Cassandra SSTable 버전을 확인해야 함

프라이빗 클라우드 4.15.07.01

문제 ID 설명
OPDK-1927 수익 창출 업그레이드에 테이블이 누락되어 중복 색인이 생성됨
OPDK-1878 설정에서 게이트웨이 POD 이름을 변경하면 문제가 발생함
OPDK-1886 노드가 192.168.x.y와 같은 로컬 IP 주소에 액세스할 수 없음
MGMT-2521 Trace 세션이 때때로 멈춤
MGMT-2543 새 프록시 편집기가 AssignMessage 정책의 <Payload>에서 XML을 수정하여 기존 API 프록시가 중단됨
MGMT-2599 새 프록시 편집기에서 네임스페이스 접두사를 삭제한 후 복원됨
MGMT-2702 Firefox 및 IE의 교차 사이트 보안 취약점
APIRT-1074 Content-Length 또는 Transfer-Encoding 헤더 없이 Connection: Close 헤더가 전송될 때 gzip 콘텐츠가 제대로 처리되지 않음

알려진 문제

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

문제 ID 설명
APIRT-2742 Netty 라우터를 대체하는 Nginx 서버가 도입된 프라이빗 클라우드용 Edge 4.16.01에서는 Edge JMX 통합을 사용할 수 없습니다.
APIRT-2978

라우터가 Nginx를 시작하지 못함 또는 라우터가 시작되지 않음

/opt/apigee/var/log/edge-router/logs/system.log 파일에 표시된 대로 Edge 라우터가 Nginx를 시작하지 못하거나 전혀 시작하지 못하는 경우 /opt/nginx/conf.d 디렉터리의 모든 파일을 삭제하고 라우터를 다시 시작합니다.

> rm -f /opt/nginx/conf.d/*
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart
DOC-1687 알려진 패키지 종속성 충돌로 인해 Satellite Server 6에서 사용되는 Katello 에이전트가 Qpid 데몬을 실행하는 Apigee Edge 호스트에 올바르게 설치되지 않습니다.
PRC-1118

'apigee-service apigee-postgresql pg-data-purge' 명령어를 실행할 때 오류 발생

'apigee-service apigee-postgresql pg-data-purge' 명령어를 실행할 때 다음 형식의 오류가 표시될 수 있습니다.

오류: 관계의 소유자여야 함

/opt/apigee/apigee-postgresql-4.16.05-0.0.894/lib/actions/pg-data-purge를 수정하고 다음 속성을 'apigee'로 설정합니다.

POSTGRES_USER=apigee