다음을 통해 공유

JavaScript용 Azure 템플릿 클라이언트 라이브러리 - 버전 1.0.0-beta.1

  • 아티클

이 프로젝트는 JavaScript용 Azure SDK의 템플릿 패키지로 사용됩니다. Azure SDK 개발자가 새 패키지를 부트스트랩하는 데 도움이 되며, Azure 서비스에 대한 클라이언트 라이브러리의 코드 및 설명서를 구성하는 방법의 예제를 제공합니다.

시작

현재 지원되는 환경

자세한 내용은 지원 정책을 참조하세요.

사전 요구 사항

일반적으로 여기에 필요한 Azure 서비스를 프로비전하기 위한 셸 명령을 배치합니다.

@azure/template 패키지를 설치합니다.

를 사용하여 JavaScript용 템플릿 클라이언트 라이브러리를 npm설치합니다.

npm install @azure/template

브라우저 지원

JavaScript 번들

브라우저에서 이 클라이언트 라이브러리를 사용하려면 먼저 번들러를 사용해야 합니다. 이 작업을 수행하는 방법에 대한 자세한 내용은 번들링 설명서를 참조하세요.

CORS

브라우저용으로 개발해야 하는 경우 스토리지 계정에 대해 CORS(원본 간 리소스 공유) 규칙을 설정해야 합니다. Azure Portal 이동하여 Azure Storage Explorer 스토리지 계정을 찾고 Blob/큐/파일/테이블 서비스에 대한 새 CORS 규칙을 만듭니다.

예를 들어 디버깅을 위해 다음 CORS 설정을 만들 수 있습니다. 하지만 프로덕션 환경의 요구 사항에 따라 설정을 신중하게 사용자 지정하세요.

  • 허용된 원본: *
  • 허용되는 동사: DELETE, GET,HEAD,MERGE,POST,OPTIONS,PUT
  • 허용되는 헤더: *
  • 노출된 헤더: *
  • 최대 연령(초): 86400

추가 예제

최상위 예제에는 일반적으로 기본 클라이언트 만들기 및 인증과 같은 항목이 포함됩니다. 서비스에서 여러 인증 방법(예: 키 기반 및 Azure Active Directory)을 지원하는 경우 각각에 대한 별도의 예를 제공할 수 있습니다.

주요 개념

ConfigurationClient

여기에서 기본 클라이언트를 설명합니다. 수행할 수 있는 작업과 개발자가 언제 사용하려고 하는지에 대해 설명합니다.

추가 예

설명하려는 각 최상위 서비스 개념에 대한 섹션을 만듭니다.

예제

첫 번째 예제

다른 사용자가 라이브러리를 사용하여 서비스와 공통 작업을 수행하는 방법에 대한 몇 가지 코드 예제를 만듭니다.

문제 해결

로깅

로깅을 사용하도록 설정하면 실패에 대한 유용한 정보를 파악하는 데 도움이 될 수 있습니다. HTTP 요청 및 응답 로그를 보려면 AZURE_LOG_LEVEL 환경 변수를 info로 설정합니다. 또는 @azure/logger에서 setLogLevel을 호출하여 런타임에 로깅을 사용하도록 설정할 수 있습니다.

const { setLogLevel } = require("@azure/logger");

setLogLevel("info");

로그를 사용하는 방법에 대한 자세한 내용은 @azure/logger package docs를 참조하세요.

다음 단계

클라이언트 라이브러리를 사용하는 방법을 보여 주는 자세한 예제는 샘플 디렉터리를 참조하세요.

참여

이 라이브러리에 기여하려면 기여 가이드 를 참조하여 코드를 빌드하고 테스트하는 방법에 대해 자세히 알아보세요.

Impressions