Azure Extensions client library for JavaScript - version 1.0.0

이 패키지에는 확장 클라이언트용 동형(isomorphic SDK)이 포함되어 있으며(Node.js와 브라우저 모두에서 실행Azure 지원합니다.

이 API를 사용해 ARM을 통해 Kubernetes 클러스터용 확장 자원을 생성하세요.

키 링크:

시작하기

현재 지원되는 환경

자세한 내용은 저희 support 정책을 참조하세요.

사전 요구 사항

@azure/arm-kubernetesconfiguration-extensions 패키지 설치

npm로 JavaScript용 Azure 확장 클라이언트 라이브러리를 설치하세요:

npm install @azure/arm-kubernetesconfiguration-extensions

ExtensionsClient를 만들고 인증하기

Azure 확장 API에 접근하기 위해 클라이언트 객체를 생성하려면 Azure 확장 리소스의 endpoint와 credential가 필요합니다. Azure Extensions 클라이언트는 Azure Active Directory 자격 증명을 사용해 인증할 수 있습니다. Azure 확장 리소스의 엔드포인트는 Azure Portal에서 찾을 수 있습니다.

@azure/identity 라이브러리의 자격 증명이나 기존 AAD 토큰을 사용해 Azure Active Directory으로 인증할 수 있습니다.

아래에 표시된 DefaultAzureCredential 제공자 또는 Azure SDK에 포함된 다른 자격 증명 제공자를 사용하려면 @azure/identity 패키지를 설치해 주세요:

npm install @azure/identity

또한 새 AAD 신청서를 등록하고 적절한 역할을 서비스 책임자에게 할당하여 Azure Extensions 접근 권한을 부여해야 합니다(참고: "Owner"와 같은 역할은 필요한 권한을 부여하지 않습니다).

Azure AD 애플리케이션 만드는 방법에 대한 자세한 내용은 this guide를 참고하세요.

Node.js 및 노드와 유사한 환경을 사용하여 DefaultAzureCredential 클래스를 사용하여 클라이언트를 인증할 수 있습니다.

import { ExtensionsClient } from "@azure/arm-kubernetesconfiguration-extensions";
import { DefaultAzureCredential } from "@azure/identity";

const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new ExtensionsClient(new DefaultAzureCredential(), subscriptionId);

브라우저 환경의 경우 InteractiveBrowserCredential 패키지의 @azure/identity 사용하여 인증합니다.

import { InteractiveBrowserCredential } from "@azure/identity";
import { ExtensionsClient } from "@azure/arm-kubernetesconfiguration-extensions";

const credential = new InteractiveBrowserCredential({
  tenantId: "<YOUR_TENANT_ID>",
  clientId: "<YOUR_CLIENT_ID>",
});
const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new ExtensionsClient(credential, subscriptionId);

JavaScript 번들

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

주요 개념

확장클라이언트

ExtensionsClient는 Azure 확장 클라이언트 라이브러리를 사용하는 개발자들의 주요 인터페이스입니다. 이 클라이언트 객체의 메서드를 탐색하여 접근할 수 있는 Azure 확장 서비스의 다양한 기능을 이해하세요.

Troubleshooting

로깅

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

import { setLogLevel } from "@azure/logger";

setLogLevel("info");

로그 활성화에 대한 더 자세한 지침은 @azure/logger 패키지 문서를 참고하시면 됩니다.

다음 단계

이 라이브러리 사용 방법에 대한 자세한 예시는 samples 디렉토리를 참고해 주세요.

Contributing

이 라이브러리에 기여하고 싶으시다면, 코드 빌드 및 테스트 방법에 대해 더 알고 싶다면 기여 가이드를 읽어보시기 바랍니다.

  • Last updated on