4.16.05 - Private Cloud용 Edge 출시 노트

현재 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 조회를 사용 중지하려면 다음 단계를 따르세요.

  1. 모든 메시지 프로세서 노드에서 /etc/nscd.conf를 수정합니다.
  2. 다음 속성을 설정합니다.

    enable-cache host no
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
이전
4.16.05.01
다음
4.16.01.08