4.17.05 - Private Cloud용 Edge 출시 노트

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

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

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

출시 개요

이 출시에는 다음과 같은 API를 더 효과적으로 제어하고 보호하는 데 도움이 되는 몇 가지 주목할 만한 기능이 포함되어 있습니다.

• 공유 흐름은 제로 다운타임 배포를 지원합니다.
• 이제 조직의 수익 창출 데이터 삭제가 지원됩니다.
• 아래에 설명된 추가 새로운 기능

지원 중단과 관련해서는 보관함이 지원 중단되었습니다.

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

지원 중단 및 중단

이번 출시에서 지원 중단되거나 사용 중지된 기능은 다음과 같습니다. 자세한 내용은 Edge 지원 중단 정책을 참고하세요.

지원 중단: API 프록시 성능 탭에 경로 추가

이 출시 이전에는 관리 UI에서 API 프록시로 이동하여 성능 탭으로 이동하고 프록시의 성능 탭과 비즈니스 트랜잭션 대시보드에서 차트 기반 비교를 위한 다양한 경로를 만들 수 있었습니다. 이 기능은 지원 중단되었으며 더 이상 UI에서 사용할 수 없습니다. 이 기능의 대안은 다음 Apigee 커뮤니티 도움말을 참고하세요. 비즈니스 트랜잭션 API의 대안 (EDGEUI-902)

지원 중단됨: 개발자 서비스 포털의 buildInfo URL

이전 버전의 포털에서는 포털 버전을 확인하기 위해 브라우저에서 다음 URL을 열었습니다.

http://yourportal.com/buildInfo

4.17.05에서 이 링크가 삭제되었습니다. 버전을 확인하려면 Drupal에서 Reports > Status report 메뉴 항목을 엽니다. 포털 버전은 설치 프로필이라는 행의 표에 표시됩니다.

Apigee 보안 저장소 (보관소) 지원 중단

Apigee 보안 저장소('볼트'라고도 함)가 지원 중단되며 지원 중단 및 서비스 종료 페이지에 표시된 지원 중단 발표일로부터 1년 후에 서비스가 종료됩니다. 키-값 쌍의 암호화된 스토리지를 제공하는 볼트는 관리 API로 생성되며 apigee-access Node.js 모듈의 함수를 사용하여 런타임에 액세스합니다.

보안 저장소를 사용하는 대신 키-값 맵 사용에 설명된 대로 암호화된 키-값 맵 (KVM)을 사용하세요. 암호화된 KVM은 보관소만큼 안전하며 생성 및 검색을 위한 더 많은 옵션을 제공합니다. (MGMT-3848)

새로운 기능 및 업데이트

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

프라이빗 클라우드

설치에 새로운 필수 SMTP 구성 매개변수 추가

이제 Edge 설치 구성 파일에서 SMTPMAILFROM 매개변수를 사용해야 합니다. 이 매개변수는 사용자가 비밀번호 재설정을 요청하는 경우와 같이 Edge에서 자동 이메일을 전송할 때 사용되는 이메일 주소를 지정합니다. 자세한 내용은 노드에 Edge 구성요소 설치를 참고하세요.

(EDGEUI-1020)

이제 Edge API 관리 호출에 Edge UI에서 사용하는 제한 시간을 설정할 수 있습니다.

이제 Edge UI에서 API 관리 호출이 반환될 때까지 UI가 대기하는 시간을 제어하는 데 사용되는 API 제한 시간 기간을 지정할 수 있습니다. 다음 속성은 제한 시간을 정의합니다.

• conf_apigee_apigee.feature.apitimeout은 UI가 백엔드 호출이 반환될 때까지 기다리는 시간(초)을 설정합니다. 이는 UI의 활동과 관계없습니다. 이 시간 내에 호출이 완료되지 않으면 UI에서 제한 시간 오류가 발생합니다. 기본값은 180초 (3분)입니다.
• conf_apigee_play.ws.timeout.idle은 UI가 서버의 활동을 기다리는 시간(밀리초)을 설정합니다. conf_apigee_apigee_apitimeout과 동일한 값으로 설정하거나 더 작은 값으로 설정할 수 있습니다. 더 큰 값으로 설정해도 효과가 없습니다. 기본값은 180,000밀리초 (3분)입니다.
• conf_apigee_play.ws.timeout.connection은 UI가 연결이 설정되기를 기다리는 시간을 설정합니다. conf_apigee_apigee_apitimeout과 동일한 값으로 설정하거나 더 작은 값으로 설정할 수 있습니다. 더 큰 값으로 설정해도 효과가 없습니다. 기본값은 120,000밀리초 (2분)입니다.

자세한 내용은 Edge API 관리 호출에 Edge UI에서 사용하는 제한 시간 설정을 참고하세요.

(EDGEUI-816)

라우터에 메시지 프로세서 재시도 제한 시간 추가

라우터가 메시지 프로세서에 대한 요청을 재시도하지 않고 오류 메시지를 반환하도록 제한 시간을 추가했습니다.

자세한 내용은 메시지 프로세서에 대한 연결을 재시도하도록 라우터 구성을 참고하세요.

(APIRT-2912)

기본 시스템 관리자를 변경하는 절차 추가

이제 기본 시스템 관리자를 변경하는 문서가 포함됩니다.

자세한 내용은 사용자, 역할, 권한 관리를 참고하세요.

(DOS-4895)

루트 사용자와 비루트 사용자 간에 Edge 설치 작업을 분리하는 방법에 관한 문서 추가

새 문서에서는 루트 사용자와 비루트 사용자 간에 Edge 설치 작업을 분리하는 단계를 설명합니다.

자세한 내용은 Edge 설치 개요를 참고하세요.

(DOS-4573)

생성된 이메일의 링크에 호스트 이름을 설정하는 속성 추가

Edge는 사용자가 조직에 추가되는 경우와 같은 특정 이벤트에 대한 응답으로 이메일을 자동으로 전송합니다. 이러한 이메일에는 링크가 포함되어 있는 경우가 많습니다. 예를 들어 새 사용자가 조직에 추가되면 Edge UI는 다음과 같은 형식의 로그인 URL이 포함된 이메일을 사용자에게 보냅니다.

https://domain/login

도메인은 Edge에서 자동으로 결정되며 일반적으로 조직에 적합합니다. 하지만 Edge UI가 부하 분산기 뒤에 있는 경우 자동으로 생성된 도메인 이름이 잘못될 수 있습니다. 이 경우 conf_apigee_apigee.emails.hosturl 속성을 사용하여 생성된 URL의 도메인 이름 부분을 명시적으로 설정할 수 있습니다.

자세한 내용은 생성된 이메일의 링크에 호스트 이름 설정을 참고하세요.

(EDGEUI-1044)

API 프록시에 대해 Edge UI에 표시되는 기본 URL 설정

Edge UI는 프록시가 배포된 위치에 해당하는 가상 호스트의 설정을 기반으로 API 프록시의 URL을 표시합니다. 이 디스플레이에는 가상 호스트의 라우터 포트 번호가 포함될 수 있습니다.

대부분의 경우 Edge UI에 표시되는 URL은 프록시에 대한 외부 요청을 수행하는 데 올바른 URL입니다. 하지만 일부 구성에서는 표시된 URL이 올바르지 않습니다. 예를 들어 다음 구성 중 하나로 인해 표시된 URL이 프록시에 대한 외부 요청을 만드는 데 사용된 실제 URL과 일치하지 않을 수 있습니다.

• SSL 종료는 부하 분산기에서 발생합니다.
• 포트 매핑은 부하 분산기와 Apigee 라우터 간에 발생합니다.
• 경로 재작성으로 구성된 부하 분산기

비공개 클라우드용 Edge 4.17.05 이상에서는 Edge UI에 표시되는 URL을 재정의할 수 있는 <BaseUrl>이라는 가상 호스트의 속성을 지원합니다. 다음은 새 <BaseURL> 속성이 있는 가상 호스트 객체를 보여주는 예입니다. 이 예시에서는 'http://myCo.com' 값이 Edge UI에 표시됩니다.

<VirtualHost name="myVHost">
   <HostAliases>
     <HostAlias>DNS_name_or_IP:9005</HostAlias>
   </HostAliases>
   <BaseUrl>http://myCo.com</BaseUrl>
   <Interfaces/>
   <Port>9005</Port>
</VirtualHost>

<BaseUrl>이 설정되지 않은 경우(기본값) Edge UI에서 렌더링된 기본 URL은 'http://DNS_name_or_IP:9005/'로 표시되지만 실제 호스트 별칭 설정은 'http://myCo.com'입니다.

apigee-provision 유틸리티와 함께 VHOST_BASEURL 속성을 사용하여 조직을 만들 때 기본 URL을 설정할 수도 있습니다.

자세한 내용은 프라이빗 클라우드 API에 대한 TLS 액세스 구성을 참고하세요.

(EDGEUI-5008)

디버그 로깅 사용 설정에 관한 문서 추가

Edge 구성요소의 디버그 로깅을 사용 설정/중지하는 방법을 설명하는 문서가 추가되었습니다.

자세한 내용은 디버그 로깅 사용 설정을 참고하세요.

(APIRT-4018)

apigee-analytics-collector 유틸리티의 새로운 설치 프로그램 및 명령어 구문

모든 Edge for Private Cloud 고객은 apigee-analytics-collector 명령줄 유틸리티의 베타 버전을 사용하여 API 프록시 트래픽에 관한 통계를 Apigee에 제출해야 합니다. 이 유틸리티는 API 호출량 보고서를 Apigee에 다시 전송합니다.

이 Edge 버전에는 apigee-analytics-collector 유틸리티의 새로운 설치 안내와 명령 구문이 포함되어 있습니다. 이 출시에서는 이제 npm 대신 apigee-service를 사용하여 apigee-analytics-collector 유틸리티를 설치하고 독립형 명령어가 아닌 apigee-service를 통해 apigee-analytics-collector 유틸리티를 호출합니다.

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

새 4.17.01 설치에서 Nginx/Postgres의 개발자 서비스 포털 업데이트 후의 새 기본 설치 디렉터리

Nginx/Postgres를 사용하는 4.17.01의 새 설치를 업데이트한 후 루트 디렉터리가 다음에서

/opt/apigee/apigee-drupal

다음과 같이 변경합니다.

/opt/apigee/apigee-drupal/wwwroot

API 서비스

항목에 대한 입력 유효성 검사 강화

Apigee Edge 조직의 모든 항목에 더 엄격한 입력 유효성 검사가 적용되었습니다. 허용되는 문자는 일반적으로 알파벳 (모든 경우), 숫자, 밑줄입니다.

영향을 받는 항목은 다음과 같습니다.

• 조직
• 환경
• API 프록시
• API 프록시 버전
• API 프록시의 정책 이름
• 디버그 추적 마스크 구성 ID
• 리소스 이름 (Java 콜아웃, xsl, 모든 리소스)
• 키 저장소
• CRLstores
• 리소스 참조
• 대상 서버

(MGMT-3840)

공유 흐름 제로 다운타임 배포

공유 흐름을 배포하고 배포 중에 수신 트래픽이 거부되지 않도록 하려면 이제 무중단 배포 관리 API를 사용하면 됩니다. 이 프로세스는 관리 API를 사용하여 API 프록시의 무중단 배포와 거의 동일합니다. 유일한 차이점은 관리 API 리소스입니다.

다음 호출은 URI에 표시된 공유 흐름 버전을 배포한 다음 이전에 배포된 버전을 배포 취소합니다 (override=true 쿼리 매개변수가 이를 지원함).

curl -X POST -H "Content-type:application/x-www-form-urlencoded" \
https://api.enterprise.apigee.com/v1/o/{org_name}/environments/{env-name}/sharedflows/{shared_flow_name}/revisions/{revision_number}/deployments?"override=true" \
-u email:password

(MGMT-3485)

수익 창출

조직의 수익 창출 데이터 삭제

다음과 같은 경우 조직의 수익 창출 데이터를 삭제할 수 있습니다.

• 조직을 삭제합니다. 이 경우 조직을 삭제하려면 먼저 수익 창출 데이터를 삭제해야 합니다.
• 재사용하려는 테스트 조직에서 수익 창출 데이터를 삭제합니다. 이 경우 수익 창출 데이터를 삭제한 후 Apigee Edge 데이터를 동기화해야 합니다.

자세한 내용은 조직에서 수익 창출 데이터 삭제하기를 참고하세요. (DEVRT-2581)

조직의 수익 창출을 사용 설정하는 API가 추가됨

이제 API를 사용하여 조직의 수익 창출을 사용 설정할 수 있습니다.

자세한 내용은 조직의 수익 창출 사용 설정하기를 참고하세요.

(DEVRT-2383)

수정된 버그

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

프라이빗 클라우드 4.17.05

Cloud 17.04.12 (UI)

Cloud 17.04.05 (UI)

Cloud 17.03.29 (UI)

Cloud 17.03.15.01 (UI)

Cloud 17.03.15 (UI)

클라우드 17.03.13.02 (수익 창출)

클라우드 17.03.13.01 (수익 창출)

Cloud 17.03.13 (API 관리)

Cloud 17.03.1 (UI)

Cloud 17.02.15 (UI)

Cloud 17.02.13 (API 런타임)

Cloud 17.02.13 (API 관리)

Cloud 17.01.18 (UI)

Cloud 17.01.16 (API 관리)

Cloud 17.01.16 (수익 창출)