Azure Stack Hub에서 Node.js SDK(소프트웨어 개발 키트)와 함께 API 버전 프로필 사용

아티클
10/30/2024

Node.js 및 API 버전 프로필

Node.js SDK를 사용하여 앱의 인프라를 빌드하고 관리할 수 있습니다. Node.js SDK의 API 프로필은 글로벌 Azure 리소스와 Azure Stack Hub 리소스 간에 전환할 수 있도록 하여 하이브리드 클라우드 솔루션에 도움이 됩니다. 한 번 코딩한 다음 글로벌 Azure 및 Azure Stack Hub를 모두 대상으로 지정할 수 있습니다.

이 문서에서는 Visual Studio Code 개발 도구로 사용할 수 있습니다. Visual Studio Code Node.js SDK를 디버그할 수 있으며 앱을 실행하고 Azure Stack Hub instance 앱을 푸시할 수 있습니다. Visual Studio Code 또는 명령을 node <nodefile.js>실행하는 터미널 창을 통해 디버그할 수 있습니다.

The Node.js SDK

Node.js SDK는 Azure Stack Hub Resource Manager 도구를 제공합니다. SDK의 리소스 공급자에는 컴퓨팅, 네트워킹, 스토리지, 앱 서비스 및 KeyVault가 포함됩니다. node.js 애플리케이션에 설치할 수 있는 10개 리소스 공급자 클라이언트 라이브러리가 있습니다. 애플리케이션의 메모리를 최적화하기 위해 2020-09-01-profile 에 사용할 리소스 공급자 지정을 다운로드할 수도 있습니다. 각 모듈은 리소스 공급자, 해당 API 버전 및 API 프로필로 구성됩니다.

API 프로필은 리소스 공급자와 API 버전의 조합입니다. API 프로필을 사용하여 리소스 공급자 패키지에서 각 리소스 유형의 가장 안정적인 최신 버전을 가져올 수 있습니다.

모든 서비스의 최신 버전을 사용하려면 패키지의 최신 프로필을 사용합니다.
Azure Stack Hub와 호환되는 서비스를 사용하려면 @azure/arm-resources-profile-hybrid-2020-09-01 또는 @azure/arm-storage-profile-2020-09-01-hybrid를 사용합니다.

NPM 패키지

각 리소스 공급자에는 자체 패키지가 있습니다. npm 레지스트리에서 패키지를 가져올 수 있습니다.

다음 패키지를 찾을 수 있습니다.

리소스 공급자	패키지
App Service	@azure/arm-resources-profile-2020-09-01-hybrid
Azure Resource Manager 구독	@azure/arm-subscriptions-profile-hybrid-2020-09-01
Azure Resource Manager Policy	@azure/arm-policy-profile-hybrid-2020-09-01
Azure Resource Manager DNS	@azure/arm-dns-profile-2020-09-01-hybrid
권한 부여	@azure/arm-authorization-profile-2020-09-01-hybrid
컴퓨팅	@azure/arm-compute-profile-2020-09-01-hybrid
스토리지	@azure/arm-storage-profile-2020-09-01-hybrid
Network	@azure/arm-network-profile-2020-09-01-hybrid
리소스	@azure/arm-resources-profile-hybrid-2020-09-01
Keyvault	@azure/arm-keyvault-profile-2020-09-01-hybrid

서비스의 최신 API 버전을 사용하려면 특정 클라이언트 라이브러리의 최신 프로필을 사용합니다. 예를 들어 최신 API 버전의 리소스 서비스만 사용하려면 리소스 관리 클라이언트 라이브러리의 프로필을 사용합니다azure-arm-resource. 패키지.

리소스 공급자의 특정 API 버전에 대해 패키지 내에 정의된 특정 API 버전을 사용합니다.

@azure/arm-resourceprovider-profile-2020-09-01-hybrid

Azure Stack Hub용으로 빌드된 최신 프로필입니다. 1808 스탬프 이상에 있는 한 서비스가 Azure Stack Hub와 가장 호환되도록 하려면 이 프로필을 사용합니다.
@azure-arm-resource

프로필은 모든 서비스의 최신 버전으로 구성됩니다. Azure의 모든 서비스의 최신 버전을 사용합니다.

Profiles

날짜가 포함된 프로필의 경우 다른 SDK 프로필 또는 버전을 사용하려면 에서 @azure/arm-keyvault-profile-<date>-hybrid날짜를 대체할 수 있습니다. 예를 들어 2008 버전의 경우 프로필은 2019-03-01이고 문자열은 가 됩니다 @azure/arm-keyvault-profile-2019-03-01-hybrid. 경우에 따라 SDK 팀은 패키지의 이름을 변경하므로 문자열 날짜를 다른 날짜로 바꾸는 것만으로는 작동하지 않을 수 있습니다. 프로필 및 Azure Stack 버전의 연결은 다음 표를 참조하세요.

Azure Stack 버전	프로필
2311	2020_09_01
2301	2020_09_01
2206	2020_09_01
2108	2020-09-01
2102	2020-09-01
2008	2019-03-01

Azure Stack Hub 및 API 프로필에 대한 자세한 내용은 API 프로필 요약을 참조하세요.

Node.js SDK 설치

Git를 설치합니다. 자세한 내용은 시작 - Git 설치를 참조하세요.
Node.js 의 현재 버전을 설치하거나 업그레이드합니다. Node.js npm JavaScript 패키지 관리자도 포함합니다.
Visual Studio Code 설치 또는 업그레이드하고 Visual Studio Code 대한Node.js 확장을 설치합니다.
Azure Stack Hub 리소스 관리자용 클라이언트 패키지를 설치합니다. 자세한 내용은 클라이언트 라이브러리를 설치하는 방법을 참조하세요.
설치해야 하는 패키지는 사용하려는 프로필 버전에 따라 달라집니다. npm의 패키지 섹션에서 리소스 공급자 목록을 찾을 수 있습니다.

아직 구독이 없는 경우 구독을 만들고 나중에 사용할 구독 ID를 저장합니다. 구독을 만드는 방법에 대한 자세한 내용은 이 문서를 참조하세요.

서비스 사용자

서비스 주체 및 관련 환경 정보를 만들고 어딘가에 저장해야 합니다. 역할이 있는 owner 서비스 주체가 권장되지만 샘플에 따라 역할로 contributor 충분할 수 있습니다. 필요한 값은 샘플 리포지토리 의 README를 참조하세요. 이러한 값은 JSON 파일(샘플에서 사용)과 같이 SDK 언어에서 지원하는 모든 형식으로 읽을 수 있습니다. 실행 중인 샘플에 따라 이러한 값을 모두 사용할 수 있는 것은 아닙니다. 업데이트된 샘플 코드 또는 자세한 내용은 샘플 리포지토리 를 참조하세요.

테넌트 ID

Azure Stack Hub의 디렉터리 또는 테넌트 ID를 찾으려면 이 문서의 지침을 따릅니다.

리소스 공급자 등록

이 문서에 따라 필수 리소스 공급자를 등록 합니다. 이러한 리소스 공급자는 실행하려는 샘플에 따라 필요합니다. 예를 들어 VM 샘플을 Microsoft.Compute 실행하려면 리소스 공급자 등록이 필요합니다.

Azure Stack 리소스 관리자 엔드포인트

ARM(Azure Resource Manager)은 관리자가 Azure 리소스를 배포, 관리 및 모니터링할 수 있는 관리 프레임워크입니다. Azure Resource Manager 이러한 작업을 단일 작업에서 개별적으로 처리하지 않고 그룹으로 처리할 수 있습니다. Resource Manager 엔드포인트에서 메타데이터 정보를 가져올 수 있습니다. 엔드포인트는 코드를 실행하는 데 필요한 정보가 포함된 JSON 파일을 반환합니다.

다음을 살펴보세요.

ASDK(Azure Stack Development Kit)의 ResourceManagerEndpointUrl 은 입니다 https://management.local.azurestack.external/.
통합 시스템의 ResourceManagerEndpointUrl 은 입니다 https://management.region.<fqdn>/. 여기서 <fqdn> 는 정규화된 도메인 이름입니다.
필요한 메타데이터를 검색하려면 다음을 수행합니다. <ResourceManagerUrl>/metadata/endpoints?api-version=1.0

JSON 샘플:

{
   "galleryEndpoint": "https://portal.local.azurestack.external:30015/",
   "graphEndpoint": "https://graph.windows.net/",
   "portal Endpoint": "https://portal.local.azurestack.external/",
   "authentication": 
      {
         "loginEndpoint": "https://login.windows.net/",
         "audiences": ["https://management.yourtenant.onmicrosoft.com/3cc5febd-e4b7-4a85-a2ed-1d730e2f5928"]
      }
}

샘플

업데이트 날짜 샘플 코드는 샘플 리포지토리 를 참조하세요. 루트 README.md 는 일반적인 요구 사항을 설명하고 각 하위 디렉터리에는 해당 샘플을 실행하는 방법에 대한 고유한 README.md 특정 샘플이 포함되어 있습니다.

Azure Stack 버전 2008 또는 프로필 2019-03-01 에 적용되는 샘플은 여기를 참조하세요.

다음 단계

API 프로필에 대해 자세히 알아보세요.

다음을 통해 공유