다음을 통해 공유

개발자 포털 배포 자동화

  • 아티클

적용 대상: 개발자 | 기본 | 기본 v2 | 표준 | 표준 v2 | 프리미엄 | 프리미엄 v2

API Management 개발자 포털은 콘텐츠에 대한 프로그래밍 방식 액세스를 지원합니다. 콘텐츠 관리 REST API를 통해 API Management 서비스로 데이터를 가져오거나 API Management 서비스로 데이터를 내보낼 수 있습니다. REST API 액세스는 관리형 포털과 자체 호스팅 포털 양쪽에 대해 사용할 수 있습니다.

자동 마이그레이션 스크립트

API를 사용하여 두 API Management 서비스(예: 테스트 환경에 있는 서비스와 프로덕션 환경에 있는 서비스) 간에 콘텐츠 마이그레이션을 자동화할 수 있습니다. API Management 개발자 포털 GitHub 리포지토리에 있는 scripts.v3/migrate.js 스크립트를 사용하면 자동화 프로세스가 간소화됩니다.

Warning

스크립트는 대상 API Management 서비스에서 개발자 포털의 콘텐츠를 제거합니다. 이 작업이 우려가 된다면 백업을 만들어 두세요.

참고 항목

명시적으로 정의된 사용자 지정 스토리지 계정으로 자체 호스팅 포털을 사용하여 미디어 파일을 호스트하는 경우(즉, 구성 파일에서 설정을 정의하는 blobStorageUrl 경우) 원래 scripts/migrate.js 스크립트를 사용해야 config.design.json 합니다. 원본 스크립트는 관리형 포털이나 API Management에 의해 관리되는 미디어 스토리지 계정을 갖는 자체 호스팅 포털에 대해서는 작동하지 않습니다. 이 경우에는 대신 /scripts.v3 폴더에 있는 스크립트를 사용하세요.

스크립트에서 수행하는 단계는 다음과 같습니다.

  1. 원본 API Management 서비스에서 포털 콘텐츠 및 미디어를 캡처합니다.
  2. 대상 API Management 서비스에서 포털 콘텐츠 및 미디어를 제거합니다.
  3. 대상 API Management 서비스로 포털 콘텐츠 및 미디어를 업로드합니다.
  4. 선택적으로, 관리형 포털에 대해서만 자동으로 포털을 게시합니다.

스크립트가 성공적으로 실행되면 대상 API Management 서비스에 원본 서비스와 동일한 포털 콘텐츠가 있게 되며 해당 콘텐츠를 관리자 권한으로 볼 수 있습니다.

  • 관리형 포털을 사용하는 경우 스크립트가 대상 포털을 자동으로 게시하도록 설정하여 방문자가 자동으로 마이그레이션된 버전을 사용할 수 있도록 할 수 있습니다.
  • 자체 호스팅 포털을 사용하는 경우 대상 포털을 수동으로 게시해야 합니다. 자습서의 게시 및 호스팅 지침에 따라 자체 호스팅 개발자 포털을 설정하세요.

다음 단계

다음 문서를 통해 개발자 포털에 대해 자세히 알아봅니다.