15.05.27.00 - Apigee 개발자 서비스 포털 출시 노트

Apigee Edge 문서입니다.
Apigee X 문서로 이동 정보

2015년 6월 2일 화요일에 Apigee 개발자 서비스 포털의 새로운 클라우드 버전이 출시되었습니다.

궁금한 점이 있으면 Apigee 고객 지원팀으로 이동하세요.

모든 Apigee Edge 출시 노트 목록은 Apigee 출시 노트를 참고하세요.

새로운 기능

SmartDocs 정식 버전

SmartDocs가 베타 버전에서 정식 버전으로 전환됩니다. 업데이트 및 새로운 기능은 다음과 같습니다.

  • 맞춤 이름이 지정된 보안 객체 지원을 비롯하여 파일 또는 URL을 통한 가져오기를 비롯한 Swagger 2.0 지원
  • SmartDocs를 생성하는 템플릿의 시각적 디자인이 개선되었습니다.
  • Drupal의 콘텐츠 > SmartDocs 메뉴를 통해 사용할 수 있는 개발자 포털의 사용성 및 워크플로 개선사항
  • '맞춤 토큰' 인증이라고 했던 것을 이제 'API 키'라고 합니다.
  • 버전 수준에서 정의된 인증 '보안' 객체입니다.
  • 템플릿 수준에서 클라이언트 인증을 구성합니다. 새 버전은 더 이상 사전 구성된 SmartDocs 클라이언트 사용자 인증 정보를 재설정하지 않습니다.

기능에 관한 자세한 설명은 이 블로그 게시물을 참고하세요.

SmartDocs 문서는 SmartDocs를 사용하여 API 문서화를 참고하세요.

SmartDocs 업그레이드 절차

베타 기간 동안 이미 SmartDocs를 사용하고 있다면 정식 버전의 새로운 기능과 기능을 사용하려면 개발자 포털에서 SmartDocs를 업그레이드해야 합니다.

개발자 포털에 이미 게시된 SmartDocs 페이지는 계속 작동하지만 기존 페이지 또는 새 페이지의 변경사항을 수정하거나 게시하기 전에 업데이트 절차를 따라야 합니다.

개발자 포털 내에서 SmartDocs를 렌더링하고 게시할 수는 있지만, SmartDocs는 Apigee의 Edge API 관리 서비스 내에 있는 API 모델에서 생성됩니다. Edge에서 API 모델을 변경하면 모든 Pantheon 환경에서 동일하게 변경됩니다 (Pantheon 환경 전반에 개발자가 존재하는 방식과 유사).

SmartDocs 베타에서 정식 버전으로 업그레이드하기

  1. Pantheon의 dev 또는 test 환경에서 15.05.27 출시를 업데이트하고 테스트합니다.
  2. 기존에 사용하고 있는 기존 API 모델을 대체할 새 모델을 만듭니다.
    • Swagger 또는 WADL 문서를 가져오고 있다면 새 버전으로 다시 가져옵니다.
    • SmartDocs 모듈을 통해 API 모델을 유지 관리해 왔다면 SmartDocs JSON으로 내보낸 후 파일 첨부파일을 사용하여 새 모델로 가져옵니다.
  3. 모델 버전의 보안 속성을 설정합니다. 콘텐츠 > SmartDocs > 모델 페이지에서 보안 설정을 선택합니다.
  4. 모델 설정 페이지 (콘텐츠 > SmartDocs)에서 작업 열의 설정을 클릭하여 사전 구성된 인증을 확인합니다.
  5. CSS 및 JS 애셋의 v6을 사용하도록 맞춤 템플릿을 업데이트하고 authSchemes 및 apiSchema와 같은 새 객체 이름을 반영하도록 변경합니다. SmartDocs 템플릿을 업데이트하는 방법에 관한 자세한 내용은 SmartDocs를 사용하여 API 문서화를 참고하세요.
  6. 모델 수정사항을 다시 렌더링하고 게시합니다.
  7. 새 문서를 검증한 후 프로덕션 포털을 15.05.27 버전으로 업데이트합니다.

Edge Enterprise 고객이 업그레이드 프로세스에 관해 질문이나 우려사항이 있는 경우 marsh@apigee.com 및 cnovak@apigee.com으로 이메일을 보내주세요. 그 외의 경우 Apigee 커뮤니티를 사용하여 최선의 답변을 받으시기 바랍니다.

수정된 버그

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

문제 ID 설명
DEVSOL-487 관리자가 수익 창출에서 일 형식을 구성할 수 있어야 함
이제 수익 창출의 수익 창출 설정에서 유럽 및 미국 날짜 형식의 날짜 형식을 구성할 수 있습니다.
DEVSOL-603 중복 요금제 페이지 형식이 잘못됨
기존 요금제와 중복되는 요금제를 구매할 때 표시되는 페이지의 형식이 사용자에게 잘 표시됩니다.
DEVSOL-642 보안 설정에서 템플릿 설정으로 고객 수준 구성 이동
DEVSOL-709 SmartDocs: 빈 값으로 요청을 전송한 후 URL 템플릿 매개변수를 수정할 수 없음
메서드 문서에서 템플릿 매개변수를 삭제한 후 SmartDocs에서 요청을 전송하면 템플릿 매개변수를 수정할 수 없게 되는 문제를 수정합니다.
DEVSOL-1013 Dev Portal 사용자 이메일 주소 수정 가능
프로필 수정 페이지의 이메일 주소 입력란이 더 이상 사용 중지되지 않으며 개발자가 이메일 주소를 변경할 수 있습니다.
DEVSOL-1273 'DevConnect Mint'가 모듈 목록에 두 번 표시됨
'모듈' 아래에 'Dev Connect Mint'가 두 번 표시되었습니다. 이제 이 문제가 해결되었습니다.
DEVSOL-1313 Swagger 및 WADL 모두에 JSON/YAML 파일 또는 URL 가져오기 지원
이제 WADL 파일을 URL을 통해 가져오고 Swagger 파일을 업로드할 수 있습니다.
DEVSOL-1339 SmartDocs 관리 메뉴 위치 변경
이제 SmartDocs가 콘텐츠 메뉴 아래에 있고 SmartDocs 설정은 설정 관리 메뉴 아래에 있습니다.
DEVSOL-1340 GA로 전환 시 베타 삭제
이제 SmartDocs가 콘텐츠 메뉴 아래에 있고 SmartDocs 설정은 설정 관리 메뉴 아래에 있습니다.
DEVSOL-1390 __toString() 호출 문제를 해결하기 위해 PHP SDK Edge 라이브러리가 업데이트됨
DeveloperRatePlan 객체에서 __toString()을 호출할 때 발생하는 문제를 해결하기 위해 PHP SDK Edge 라이브러리가 업데이트되었습니다. 이 문제로 인해 다음과 같은 오류가 발생합니다. {quote} 심각한 오류: /Applications/MAMP/htdocs/ordnance/docroot/profiles/apigee/libraries/mgmt-api-php-sdk/Apigee/Mint/DeveloperRatePlan.php 221번 줄에서 객체가 아닌 항목의 구성원 함수 format() 호출 {quote} 이 버그는 toString() 메서드를 호출하는 맞춤 코드가 있는 수익 창출 고객에게만 영향을 미칩니다.
DEVSOL-1398 사용자에게 메시지를 표시하지 않고 설치 시 SmartDocs Petstore 모델 가져오기
이제 SmartDocs는 사이트 설치 중에 날씨 모델 대신 petstore swagger 예시(http://petstore.swagger.io/v2/swagger.json)를 가져와 SmartDocs 사용에 관한 더 포괄적인 예시를 제공합니다.
DEVSOL-1407 개발자가 많으면 Cron이 실패함
Drupal cron을 실행할 때 개발자가 많으면 시간 초과 문제가 발생했습니다. 이제 조직에 200명 이상의 사용자가 있는 경우 일괄 프로세스가 사용됩니다.
DEVSOL-1470 'API' 메뉴 링크 및 해당 뷰 만들기
이제 Dev Portal SmartDocs에는 기본적으로 'API'라는 기본 메뉴에 렌더링된 SmartDocs 문서 링크가 제공되며, 이 링크는 게시된 메서드가 있는 모든 모델로 연결됩니다.

알려진 문제

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

문제 ID 설명
DEVSOL-1558
새 설치에서 Petstore 예시 SmartDocs 메서드 페이지가 올바르게 렌더링되지 않음
SmartDocs의 Petstore 메서드 예시 페이지가 새 설치에서 올바르게 렌더링되지 않습니다. 문제 해결 방법
  1. Drupal 메뉴에서 콘텐츠 > SmartDocs를 선택합니다.
  2. 'Petstore 예시' 모델을 선택합니다.
  3. 업데이트 옵션에서 노드 렌더링 및 게시를 선택합니다.
  4. 모두 선택 / 선택 해제 체크박스를 클릭하여 모든 노드를 선택합니다.
  5. 업데이트를 클릭합니다.

이제 노드가 제대로 렌더링됩니다.