Azure Stack Hub에서 Go와 함께 API 버전 프로필 사용

Go 및 버전 프로필

프로필은 서로 다른 서비스와 다른 버전이 있는 다양한 리소스 유형의 조합입니다. 프로필을 사용하면 다양한 리소스 유형을 혼합하고 일치시킬 수 있습니다. 프로필은 다음과 같은 이점을 제공할 수 있습니다.

  • 특정 API 버전에 잠금을 적용하여 앱의 안정성을 확인합니다.
  • Azure Stack Hub 및 지역 Azure 데이터 센터와의 앱 호환성

Go SDK에서 프로필 경로 아래에서 프로필을 사용할 수 있습니다. 프로필 버전 번호는 YYYY-MM-DD 형식으로 레이블이 지정됩니다. 예를 들어 Azure Stack Hub API 프로필 버전 2020-09-01 은 Azure Stack Hub 버전 2102 이상에 해당합니다. 프로필에서 지정된 서비스를 가져오려면 프로필에서 해당 모듈을 가져옵니다. 예를 들어 2020-09-01 프로필에서 Compute 서비스를 가져오려면 다음 코드를 사용합니다.

import "github.com/Azure/azure-sdk-for-go/profiles/2020-09-01/compute/mgmt/compute"

Azure SDK for Go 설치

  1. Git을 설치합니다. 시작 - Git 설치를 참조하세요.
  2. Go를 설치합니다. Azure용 API 프로필에는 Go 버전 1.9 이상이 필요합니다. Go 프로그래밍 언어를 참조하세요.

Profiles

다른 SDK 프로필 또는 버전을 사용하려면 import 문의 날짜(예: .)로 github.com/Azure/azure-sdk-for-go/profiles/<date>/storage/mgmt/storage바꿔야 합니다. For example, for the 2008 version, the profile is 2019-03-01, and the string becomes github.com/Azure/azure-sdk-for-go/profiles/2019-03-01/storage/mgmt/storage. 경우에 따라 SDK 팀은 패키지의 이름을 변경하므로 문자열의 날짜를 다른 날짜로 바꾸는 것만으로는 작동하지 않을 수 있습니다. 프로필 및 Azure Stack 버전의 연결은 다음 표를 참조하세요.

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

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

Go SDK 프로필을 참조하세요.

구독

아직 구독이 없는 경우 구독을 만들고 나중에 사용할 구독 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/같습니다.
  • 통합 시스템의 ResourceManagerEndpointUrlhttps://management.region.<fqdn>/정규화된 도메인 이름입니다 <fqdn> .
  • 필요한 메타데이터를 검색하려면 : <ResourceManagerUrl>/metadata/endpoints?api-version=1.0. 사용 가능한 API 버전은 Azure rest API 사양을 참조하세요. 예를 들어 프로필 버전에서 2020-09-01 리소스 공급자microsoft.resourcesapi-version2019-10-01 변경할 수 있습니다.

샘플 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 프로필에 대해 자세히 알아보세요.