현재 Apigee Edge 문서가 표시되고 있습니다.
Apigee X 문서로 이동 정보
2016년 5월 31일 화요일에 프라이빗 클라우드용 Apigee Edge의 새 버전이 출시되었습니다.
이전 Edge for Private Cloud 기능 출시 (4.16.01) 이후 다음 출시 버전이 발생했으며 이 기능 출시에 포함되었습니다.
사용 중인 Private Cloud용 Edge 버전에 특정 클라우드 출시 버전이 포함되어 있는지 확인하는 방법은 출시 번호 지정 정보를 참조하세요.
새로운 기능 및 개선사항
다음은 이번 버전의 새로운 기능 및 개선사항입니다. 다음과 같은 개선사항 외에도 이 출시에는 여러 사용성, 성능, 보안 및 안정성 개선사항이 포함되어 있습니다.
자세한 내용 및 안내는 프라이빗 클라우드용 Edge 문서를 참조하세요.
설치 및 운영 가이드가 온라인으로 이전됨
이제 버전 4.18.01에서 Edge for Private Cloud 설치 및 운영 가이드에 액세스할 수 있습니다.
소프트웨어 업데이트
이 버전에는 다음과 같은 소프트웨어 업데이트가 포함되어 있습니다.
- 자바 JDK 1.8 - 최신 자바 기능을 활용하기 위해 이 버전은 자바 1.8과 호환됩니다. 사용자 환경에 Oracle JDK 1.8 또는 OpenJDK 8이 필요합니다.
자바 8 업데이트의 일환으로 일부 TLS 암호화를 더 이상 Oracle JDK 1.8에서 사용할 수 없습니다. 전체 목록은 '기본적으로 사용 중지된 Cipher Suites'(http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html) 섹션을 참고하세요. - Cassandra 2.1.13 - Cassandra 2.0.15에서 업데이트되었습니다.
설치, 업그레이드, 롤백
다음은 설치, 업그레이드 및 관련 스크립트에 대한 변경사항 목록입니다. 사용에 대한 자세한 내용은 프라이빗 클라우드용 Edge 문서를 참조하세요.
- 4.16.01에서 업데이트하는 새로운 프로세스 - 이 버전에서는
apigee-migrate
유틸리티를update.sh
유틸리티로 대체하여 4.16.01에서 4.16.05로 설치를 업데이트합니다. Apigee Edge 4.16.01을 4.16.05로 업데이트를 참조하세요. -
부트스트랩
bootstrap.sh
(4.16.01 버전)은 이제 4.16.05에서bootstrap_4.16.05.sh
입니다.- 이제
bootstrap_4.16.05.sh
를 다운로드하기 위해uname:pword
를 지정할 필요가 없습니다.
- 롤백 - 업데이트를 4.16.05로 롤백하려면 구성요소의 4.16.05 버전을 제거하고 이전 버전을 재설치합니다. 이전
rollback.sh
유틸리티는 삭제되었습니다. 4.16.05 롤백 프로세스를 참조하세요. setup.sh
및update.sh
가 로그 파일을/tmp
에 쓸 수 있습니다. - 기본적으로setup.sh
및update.sh
유틸리티는/opt/apigee/var/log/apigee-setup
에 로그 정보를 씁니다. 유틸리티를 실행하는 사용자에게 해당 디렉터리에 대한 액세스 권한이 없으면 로그를/tmp
디렉터리에 씁니다. 사용자가/tmp
에 액세스할 수 없으면 유틸리티가 실패합니다.- API BaaS 업데이트 절차 - 4.16.01 출시에서는 마이그레이션하기 위해 API BaaS를 재설치해야 했습니다. 새
update.sh
유틸리티는 API BaaS 업데이트를 지원합니다. Apigee Edge 4.16.01을 4.16.05로 업데이트를 참조하세요.
관리
다음은 프라이빗 클라우드 관리 및 구성을 위한 새로운 기능입니다.
- 설치 유효성 검사 - 이제 Edge Private Cloud 설치를 테스트하는 데 사용되는
apigee-validate
유틸리티를 관리 서버에서 실행할 수 있습니다. 이전에는 스크립트를 메시지 프로세서에서 실행해야 했습니다. 설치 테스트를 참고하세요. - 리전 이름 - 리전은 원하는 이름일 수 있습니다. 이전 출시 버전에서는 이름이 'dc-#' 형식(#은 정수 값)이었습니다.
- 게이트웨이 포드 - 게이트웨이 포드에는 임의의 이름이 있을 수 있습니다. 이전 출시 버전에서는 포드 이름을 '게이트웨이'로 지정해야 했습니다.
- 스크립트 기반 관리 - 새로운
apigee-adminapi.sh
명령줄 유틸리티를 사용하면 Edge 관리 API를 호출하여 수행하는 것과 동일한 Edge 구성 태스크를 수행할 수 있습니다. apigee-adminapi.sh 유틸리티 사용을 참조하세요. - 가상 호스트 SSL 자동 구성 - 이제 조직이나 환경을 만들 때 속성을 전달하여 가상 호스트에서 SSL을 구성할 수 있습니다. 조직 온보딩을 참고하세요.
API 서비스
다음은 이전 클라우드 버전의 제품에서 제공된 Edge API 서비스의 새로운 기능입니다.
syslog 메시지 로깅을 위한 고정 길이 프리픽스 (Cloud 16.03.30)
메시지 로깅 정책에는 Syslog 구성에 새로운 <FormatMessage>
요소가 있습니다. <FormatMessage>true</FormatMessage>
를 설정하면 Syslog 메시지가 고정된 문자 수로 시작되므로 Apigee에서 삽입한 데이터를 필터링할 수 있습니다. 자세한 내용은 메시지 로깅 정책을 참조하세요. (APIRT-1398)
API 프록시 기본 경로의 와일드 카드 (Cloud 16.03.09 UI)
관리 UI는 API 프록시 기본 경로에 하나 이상의 /*/
와일드 카드를 사용할 수 있도록 지원합니다. 예를 들어 /team/*/members
의 기본 경로를 사용하면 새 팀을 지원하기 위해 새 프록시를 만들지 않고도 클라이언트가 https://[host]/team/blue/members
또는 https://[host]/team/green/members
로 프록시를 호출할 수 있습니다. /**/
는 허용되지 않습니다. (MGMT-3154)
API 프록시 체이닝 (Cloud 16.03.02, Cloud 16.03.09 UI)
Edge는 로컬 API 프록시 체이닝을 지원하므로 추가 네트워크 오버헤드 없이 한 API 프록시가 Edge 조직에 배포된 다른 API 프록시를 호출할 수 있습니다. 이전에는 API 프록시 체이닝 시 다른 API 프록시에 대한 http(s) 호출이 필요하여 부하 분산기, 라우터, 메시지 프로세서를 통해 요청을 전달했습니다.
새로운 LocalTargetConnection
요소를 API 프록시의 TargetEndpoint에서 사용할 수 있으므로 API 프록시 이름, API 프록시 내 특정 ProxyEndpoint의 이름 또는 단순히 로컬 API 프록시 리소스 (예: /v1/myresource)의 기본 경로도 지정할 수 있습니다. 프록시 편집기 UI는 TargetEndpoint를 추가하거나 업데이트할 때도 이러한 옵션을 제공합니다.
프록시 체이닝은 서비스 콜아웃 정책에서도 사용할 수 있습니다.
자세한 내용은 API 프록시 함께 체이닝을 참조하세요. 새 LocalTargetConnection
요소는 XML 스키마(https://github.com/apigee/api-platform-samples/blob/master/schemas/configuration/configuration_schemas.xsd)에도 나열됩니다.
(MGMT-3049, MGMT-3050)
수정된 버그
다음은 이번 출시 버전에서 수정된 버그입니다. 이 목록은 주로 지원 티켓이 수정되었는지 확인하는 사용자를 위한 것입니다. 모든 사용자에게 자세한 정보를 제공하도록 설계되지 않았습니다.
프라이빗 클라우드용 Edge 4.16.05
문제 ID | 설명 |
---|---|
PRC-770 | 16.01 설치 프로그램이 axgroup에서 Postgres 대기 서버를 등록하지 못함 |
PRC-758 | 사용자 역할이 있는 사용자는 맞춤 보고서를 수정할 수 있습니다. |
PRC-883 | 마스터 대기 구성이 있는 Postgres 서버에서 업데이트 실패 |
Cloud 16.03.30
문제 ID | 설명 |
---|---|
SECENG-584 | 인증서 체인의 인증서 간 줄바꿈 유효성 검사로 인해 프로덕션의 일부 인증서에 문제가 발생함 |
MGMT-3217 | KVMap 이름이 '키'로 끝나면 Management API 호출이 실패함 |
MGMT-3214 | Java콜아웃 중에 클래스 충돌이 발생하여 고객의 자바 코드가 실패할 수 있습니다. |
MGMT-3185 | 조직에 조직 관리자를 추가하는 중에 오류가 발생했습니다. |
EDGEUI-127 | 새 프록시 편집기로 권한 부족 |
EDGEUI-119 | UI 세션 시간 제한 문제 |
CORESERV-671 | '구성된 링이 없습니다. cps 서비스를 초기화할 수 없습니다.' 오류가 표시됨 |
AXAPP-2345 | CPS 고객이 아닌 고객의 AX 맞춤 보고서 등록정보 문제 |
AXAPP-2302 | 일일 Apigee 분석 요약에서 개발자 채택 현황에 0으로 표시됨 |
APIRT-2750 | 특정 조직에서 트래픽 실패가 높음 |
APIRT-2516 | 자바스크립트 콜아웃의 런타임 오류가 잘못된 행 번호를 지정함 |
APIRT-2508 | Vault 콜백 내에서 익스프레스 리슨을 호출할 때 종료 오류 발생 |
APIRT-2336 | Node.js의 Gzip 문제 |
APIRT-1975 | message.content의 마스크 구성이 작동하지 않음 |
Cloud 16.03.16 UI
문제 ID | 설명 |
---|---|
MGMT-3142 | 오류 분석 대시보드에 그래프가 로드되지 않음 (수정사항 업데이트됨) |
Cloud 16.03.09 UI
문제 ID | 설명 |
---|---|
MGMT-3158 | API를 통해 개별 프록시의 RBAC가 설정된 경우 UI의 권한 부족 |
MGMT-3142 | 오류 분석 대시보드에 그래프가 로드되지 않음 |
MGMT-3118 | UI에 'clientAuthEnabled' 매개변수에 잘못된 SSL 가상 호스트 구성이 표시됨 |
DEVRT-2344 | 1일 보고서 정의가 UI에 거래가 로드되지 않음 |
Cloud 16.03.02
문제 ID | 설명 |
---|---|
MGMT-3083 | 로그 메시지에서 Node.js 로그 자동 새로고침이 너무 상세함 |
DEVRT-2275 | 맞춤 속성 요금제에 허용된 10개가 아닌 5개의 속성만 표시됨 |
DEVRT-1275 | 요금제 드롭다운 메뉴에 일부 개발자가 표시되지 않음 |
DEVRT-1074 | 크레딧 적용 시 잔액이 0인 선불 개발자가 NullpointerException을 발생시킴 |
Cloud 16.02.17
문제 ID | 설명 |
---|---|
MGMT-3083 | 로그 메시지에서 Node.js 로그 자동 새로고침이 너무 상세함 |
MGMT-3077 | UI가 기본 네임스페이스를 사용하는 WSDL에서 잘못된 프록시 번들을 생성함 |
MGMT-1642 | 맞춤 사용자 역할에 개발자 앱의 '가져오기' 권한이 없음 |
알려진 문제
이 버전에는 다음과 같은 알려진 문제가 있습니다.
문제 ID | 설명 |
---|---|
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 |
APIRT-3364 |
메시지 프로세서가 IPv4 및 IPv6에서 DNS 조회 NSCD (Name Service Cache Daemon)를 설치하고 사용 설정한 경우 메시지 프로세서가 IPv4와 IPv6에 대해 각각 하나씩 DNS 조회를 두 번 하는 것을 확인할 수 있습니다. IPv6에서 DNS 조회를 사용 중지하려면 다음 단계를 따르세요.
|
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 |
DOC-1687 | 알려진 패키지 종속 항목 충돌로 인해 위성 서버 6에서 사용된 Katello 에이전트가 Qpid 데몬을 실행하는 Apigee Edge 호스트에 제대로 설치되지 않습니다. |
메시지 할당, Java 콜아웃, 오류 발생 정책의 JSON 페이로드
메시지 할당, 자바 콜아웃, 오류 발생 정책을 사용하면 <Set><Payload>
요소를 통해 메시지 콘텐츠를 생성할 수 있습니다. 이러한 메시지의 일부로 런타임 시 값이 자동으로 입력되는 변수를 포함할 수 있습니다. 예를 들어 HTTP 헤더의 날짜를 출력하려면 메시지에 {message.header.date}
를 삽입하면 됩니다.
메시지 형식이 JSON인 경우 다음과 같이 표시됩니다.
{"The date is: " : "{message.header.date}"}
그러나 잘못된 형식의 JSON을 확인할 수 있습니다. 이 문제를 해결하려면 다음 두 가지 옵션이 있습니다.
- 여는 중괄호는 백슬래시로 이스케이프 처리합니다.
\{"The date is: " : "{message.header.date}"}
- 페이로드 요소 구성에서
variablePrefix
및variableSuffix
속성을 사용하여 JSON 페이로드의 변수를 나타냅니다. 예를 들면 다음과 같습니다.
<Payload contentType="application/json" variablePrefix="#" variableSuffix="%">{"The date is: " : "#message.header.date%"}</Payload>
다음 Edge for Private Cloud 기능 출시에서는 문제없이 JSON 메시지의 변수에 중괄호를 사용할 수 있습니다. (APIRT-1160)
라우터에서 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