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 출시 버전으로 업데이트합니다.

에지 엔터프라이즈 고객이며 업그레이드 프로세스에 대해 궁금한 점이나 우려사항이 있으면 marsh@apigee.com 및 cnovak@apigee.com으로 이메일을 보내 주십시오. 그렇지 않다면 Apigee 커뮤니티를 이용하면 최선의 답변을 받으실 수 있습니다.

수정된 버그

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

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

알려진 문제

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

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

이제 노드가 올바르게 렌더링됩니다.