4.16.01 - Private Cloud용 Edge 출시 노트

현재 Apigee Edge 문서가 표시되고 있습니다.
Apigee X 문서로 이동
정보

2016년 3월 24일 목요일에 새 버전의 프라이빗 클라우드용 Apigee Edge가 출시되었습니다.

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

사용 중인 Private Cloud용 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) 맞춤 보고서의 다른 모든 기능은 계속 사용할 수 있습니다.

Private Cloud에서는 조직 이름 길이를 재정의할 수 없습니다.

다음을 설정하여 더 이상 조직 이름 길이 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 Edge 작업 가이드(Apigee ftp 사이트 ftp://ftp.apigee.com/)를 참조하세요.

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

이전 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 작업 가이드를 참조하세요.

새로운 에지 라우터

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

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

자세한 내용은 Apigee ftp 사이트 ftp://ftp.apigee.com/에 있는 에지 설치 가이드 의 부록 A: Nginx 라우터 정보를 참조하세요.

BaaS 부하 분산기 삭제됨

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

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

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

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

조직 도구 삭제됨

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

설치 dir

/<inst_dir>/apigee4 /opt/apigee

dir 로그

/<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

Comp 시작, 중지, 다시 시작, 상태, 버전

/<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 백업

/<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

Migrate

/<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용 대시보드의 알파 버전이 포함되어 있습니다. 이 도구를 사용하면 다양한 구성요소 (라우터, 메시지 프로세서, 동물원키퍼, Cassandra)의 상태와 배포 내 다양한 조직 및 환경에 대한 http 오류 코드를 파악할 수 있습니다. 또한 대시보드 데이터의 스냅샷을 만들고 Apigee와 공유하여 지원 이슈를 해결할 수 있습니다.

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

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

에지 플랫폼

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

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

API 서비스

재설계된 API 프록시 마법사 (Cloud 16.01.20)

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

OpenAPI (Swagger) 문서로 API 프록시 만들기 (Cloud 16.01.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 콜아웃, 자바스크립트 정책 또는 메시지 할당 정책을 통해 값을 제공할 수 있습니다. 설정하려는 값이 포함된 메시지 변수를 사용합니다.

<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 16.01.20)

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

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

Node.js 로그 페이지 (Cloud 16.01.20)의 자동 폴링

프록시 편집기에서 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 액세스 (Cloud 15.07.08)

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

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

자바스크립트에서 다음과 같이 'source' 속성에 대한 참조를 사용하여 메시지 응답에 액세스할 수 있습니다.
var source = properties.get('source'); // returns: response.content
또는
var source = properties.source
또는
var source = properties['source']

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

조직 수준 감사 (Cloud 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 15.07.22)

인메모리 캐시 관리 및 사용률을 개선하기 위해 환경 캐시 리소스의 '메모리의 최대 요소' 설정이 Edge Cloud 출시 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)

SSL과 syslog에 메시지 로깅 (Cloud 15.07.22)

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

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

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

관리 UI (Cloud 15.07.22)

Apigee 엔지니어링팀에서 관리 UI의 여러 가지 소규모 버그를 수정하고 사용성을 개선했습니다.

Trace의 cURL (Cloud 15.09.02)

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

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

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

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

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

관리 UI에서 정책 기본 만료 채우기 (Cloud 15.09.30)

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

개발자 서비스

API 제품 페이지 성능, 등록된 개발자 앱 없음 (Cloud 16.01.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)

커스텀 속성에 허용되는 소수점 수 (Cloud 16.01.20)

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

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

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

분석 서비스

응답 시간 측정항목의 sum( ) 함수 (Cloud 16.01.20)

애널리틱스 커스텀 보고서 및 API 호출에서 이제 목표 응답 시간, 총 응답 시간, end_point_response_time에 'sum' 집계 함수를 사용할 수 있습니다. 예를 들어 /stats API(http://docs.apigee.com/management/apis/get/organizations/%7Borg_name%7D/environments/%7Benv_name%7D/stats/%7Bdimension_name%7D-0)에서 이제 'select' 쿼리 매개변수 ?select=sum(total_response_time)을 사용할 수 있습니다. (AXAPP-2006)

지연 시간 분석 보고서: API 프록시 이름 정렬 (Cloud 16.01.20)

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

대시보드의 개발자 앱 표시 이름 (Cloud 16.01.20)

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

맞춤 보고서의 새로운 날짜/시간 위젯 (Cloud 16.01.20)

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

GeoMap의 도시 드릴다운 (Cloud 15.07.22)

GeoMap 분석에는 미국과 캐나다에 대한 '도시' 드릴다운이 포함되어 있습니다. 지도에서 주 또는 도를 클릭하면 통화가 발생한 도시 목록이 표시됩니다. (MGMT-2282)

애널리틱스 커스텀 보고서 (Cloud 15.09.02)의 | (파이프) 및 = 문자

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

프록시 경로 접미사 측정기준 (Cloud 15.09.30)

새로운 프록시 경로 접미사 (proxy_pathsuffix) 측정기준을 애널리틱스 맞춤 보고서 및 API 호출에서 사용할 수 있습니다. 프록시 경로 서픽스는 조건부 흐름을 위해 만든 경로와 같이 기본 경로 뒤에 오는 API 프록시 URL의 일부입니다. (AXAPP-1902)

보고서에 표시 이름이 아닌 개발자 ID가 표시됨 (Cloud 15.09.30)

개발자를 반환하는 /stats API로 Edge analytics 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 프록시 편집기: 조건에서 정규식 일치를 사용할 때 Flow Navigator가 동사를 표시하지 않음
MGMT-2361 RPCException과 함께 프록시 배포 실패: 호출 타임아웃
MGMT-1662 Apigee 퍼블릭 Cloud 출시 중에 API 프록시 배포가 실패함
DEVRT-2286 sync-organization Monetization API가 손상됨
Apigee Edge 데이터를 수익 창출과 동기화하는 데 사용된 API가 16.01.20 출시 버전의 최신 업데이트로 수정되었습니다.
DEVRT-2173 패키지 이름을 변경해야 하지만 활성 요금제로 인해 수정할 수 없음
DEVRT-1661 개발자가 요금제 시작일 전에 API 요청을 할 수 없지만 차단이 해제되지 않음
API 개발자가 미래 날짜에 시작되는 월간 정액제, 볼륨 밴드 또는 번들 요율표를 수락한 다음 지정된 시작일 전에 API 요청을 전송하면 API 개발자는 더 이상 요청을 할 수 없습니다. 요금제 시작일에 도달하면 차단이 해제됩니다.
DEVRT-1643 초안 요금제가 저장된 후 손상되었습니다
AXAPP-1991 Apigee 애널리틱스 요약 및 이메일 수신 거부가 중단되지 않음
AXAPP-1946 애널리틱스 정리로 인해 디스크 공간이 확보되지 않음
AXAPP-1708 Analytics API가 요청하는 방식에 따라 동일한 통계에 대해 다른 수치를 생성하는 것 같음
AXAPP-1293 애널리틱스 요약 이메일에 존재하지 않는 개발자 앱 이름
APIRT-2518 JavaScript 정책으로 https 백엔드에 연결할 때 발생하는 문제
APIRT-2398 무효/만료된 승인 코드가 Apigee 오류로 집계됨
APIRT-2397 steps.assignmessage.SetVariableFailed가 Apigee 오류로 집계됨
APIRT-2396 IllegalArgumentException, OAuth의 ArrayIndexOutofBoundsException이 Apigee 오류로 집계됨
APIRT-2362 JavaScript 컴파일 오류
APIRT-2322 Apigee 오류로 잘못 보고된 클라이언트 ID
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 헤더를 제대로 채우지 않음
X-Forwarded-For 지원 중단 알림이 150930 출시 노트와 액세스 제어 정책에 추가되었습니다.
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 2022년 7월 15일

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

Cloud 15.08.05

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

Cloud 15.09.02

문제 ID 설명
여러 개 API 프록시 편집기에서 몇 가지 작은 버그가 수정되었습니다.
MGMT-2618 빈번한 배포 문제
MGMT-2588 개발자 기록 페이지에서 html/코드 실행 -- XSS 지속성 취약점
MGMT-2543 AssignMessage 정책의 <페이로드>에서 XML이 수정되는 새 프록시 편집기로 인해 기존 API 프록시가 손상됨
MGMT-2521 간혹 추적 세션 중단
MGMT-2519 환경 구성 UI가 작동하지 않음
AXAPP-1814 zk 큐레이터가 사용 설정되어 있으면 프로덕션에 맞춤 변수 (통계 수집기 정책)가 생성되지 않음
APIRT-1927 잘못된 가상 호스트로 인해 라우터가 환경 구성을 로드하지 않음
APIRT-1863 번들에 공백이 있어 배포 실패
APIRT-1823 & (앰퍼샌드) 문자가 포함된 POST 본문을 사용한 API 호출이 중단됨
APIRT-1789 메모리 부족 오류가 발생하는 특정 조직의 메시지 프로세서
APIRT-1776 자바스크립트 정책에서 'print'를 호출하면 과도한 로깅이 발생함
APIRT-1766 WebSocket의 제한 시간
APIRT-1600 라우터의 ConcurrentModificationException
라우터 로그에 정기적으로 여러 ConcurrentModification 인스턴스가 표시되었습니다. 그 이유는 사신이 이전 연결을 삭제하는 동안 연결이 사신 목록에 추가되었기 때문입니다. 이 문제는 해결되었습니다.
APIRT-1491 503 서비스를 사용할 수 없음 예외
APIRT-1421 JavaCall 정책 처리 시간이 간헐적으로 오래 걸림
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가 손상됨
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과 함께 프록시 배포 실패: 호출 타임아웃
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 설정에서 게이트웨이 포드 이름을 변경하면 문제가 발생함
OPDK-1886 노드가 192.168.x.y와 같은 로컬 IP 주소에 액세스할 수 없음
MGMT-2521 간혹 추적 세션 중단
MGMT-2543 AssignMessage 정책의 <페이로드>에서 XML이 수정되는 새 프록시 편집기로 인해 기존 API 프록시가 손상됨
MGMT-2599 네임스페이스를 삭제하면 새 프록시 편집기에서 네임스페이스 접두사가 복원됨
MGMT-2702 FireFox 및 IE의 크로스 사이트 보안 취약점
APIRT-1074 Connection: Close 헤더에 Content-Length 또는 Transfer-Encoding 헤더 없이 전송되었을 때 Gzip으로 압축된 콘텐츠가 제대로 처리되지 않음

알려진 문제

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

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

라우터가 Nginx를 시작하지 못하거나 라우터가 시작되지 않음

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

> rm -f /opt/nginx/conf.d/*
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart
DOC-1687 알려진 패키지 종속 항목 충돌로 인해 위성 서버 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