Go용 Azure SDK 설치

  • 아티클

Go용 Azure SDK에 오신 것을 환영합니다! SDK를 사용하면 Go 애플리케이션에서 Azure 서비스를 관리하고 상호 작용할 수 있습니다.

Go용 Azure SDK 가져오기

Go용 Azure SDK는 Go 버전 1.8 이상과 호환됩니다. Azure Stack Profiles를 사용하는 환경의 경우 Go 버전 1.9가 최소 요구 사항입니다. Go를 설치해야 할 경우 Go 설치 지침을 따릅니다.

Go용 Azure SDK 및 해당 종속성은 go get을 통해 다운로드할 수 있습니다.

go get -u -d github.com/Azure/azure-sdk-for-go/...

Warning

URL에서 Azure은(는) 대문자로 표시해야 합니다. 그렇지 않으면 SDK로 작업할 때 대/소문자 관련 가져오기 문제가 발생할 수 있습니다. 또한 import 문에서 대문 Azure 자로 표시해야 합니다.

일부 Azure 서비스에는 자체 Go SDK가 있으며 핵심 Azure SDK for Go 패키지에 포함되지 않습니다. 다음 표에서는 자체 SDK 및 해당 패키지 이름을 가진 서비스를 나열합니다. 이러한 패키지는 모두 미리 보기로 간주됩니다.

서비스 Package(패키지)
Blob Storage github.com/Azure/azure-storage-blob-go
File Storage github.com/Azure/azure-storage-file-go
Storage 큐 github.com/Azure/azure-storage-queue-go
이벤트 허브 github.com/Azure/azure-event-hubs-go
Service Bus github.com/Azure/azure-service-bus-go

Go용 Azure SDK 공급업체

Azure SDK for Go는 dep를 통해 공급할 수 있습니다. 안정성을 위해 공급업체를 사용하는 것이 좋습니다. 사용자 고유의 프로젝트에서 github.com/Azure/azure-sdk-for-go[[constraint]]Gopkg.toml사용 dep 하려면 . 예를 들어 버전 14.0.0에서 공급업체에 다음 항목을 추가합니다.

[[constraint]]
name = "github.com/Azure/azure-sdk-for-go"
version = "14.0.0"

프로젝트에 Go용 Azure SDK 포함

Go 코드에서 Azure 서비스를 사용하려면 상호 작용하는 모든 서비스와 필요한 autorest 모듈을 가져옵니다. GoDoc에서 사용 가능한 서비스 및 AutoRest 패키지에 사용할 수 있는 모듈의 전체 목록을 가져옵니다. 필요한 go-autorest 가장 일반적인 패키지는 다음과 같습니다.

패키지 설명
github.com/Azure/go-autorest/autorest 서비스 클라이언트 인증을 처리하기 위한 개체
github.com/Azure/go-autorest/autorest/azure Azure 서비스와의 상호 작용에 대한 상수
github.com/Azure/go-autorest/autorest/adal Azure 서비스에 액세스하기 위한 인증 메커니즘
github.com/Azure/go-autorest/autorest/to Azure SDK 데이터 구조 작업을 위한 형식 어설션 도우미

Go 패키지 및 Azure 서비스는 독립적으로 버전이 지정됩니다. 서비스 버전은 services 모듈 아래의 모듈 가져오기 경로의 일부입니다. 모듈의 전체 경로는 서비스 이름, 버전 YYYY-MM-DD 형식, 서비스 이름 뒤에 다시 잇습니다. 예를 들어 Compute 서비스의 버전을 가져오 2017-03-30 려면 다음을 수행합니다.

import "github.com/Azure/azure-sdk-for-go/services/compute/mgmt/2017-03-30/compute"

개발을 시작할 때 최신 버전의 서비스를 사용하고 일관성을 유지하는 것이 좋습니다. 서비스 요구 사항은 해당 시간 동안 Go SDK 업데이트가 없더라도 코드를 중단시킬 수 있는 버전 간에 변경될 수 있습니다.

서비스의 집합적 스냅샷 필요한 경우 단일 프로필 버전을 선택할 수도 있습니다. 현재 잠긴 프로필은 최신 서비스 기능이 없을 수 있는 버전 2017-03-09뿐입니다. 프로필은 모듈 아래에 profiles 있으며 해당 버전은 형식입니다 YYYY-MM-DD . 서비스는 해당 프로필 버전 아래에 그룹화되어 있습니다. 예를 들어 2017-03-09 프로필에서 Azure 리소스 관리 모듈을 가져오려면:

import "github.com/Azure/azure-sdk-for-go/profiles/2017-03-09/resources/mgmt/resources"

Warning

또한 preview 및 latest 프로필도 사용할 수 있습니다. 사용하지 않는 것이 좋습니다. 이러한 프로필은 롤링 버전이며 서비스 동작은 언제든지 변경 될 수 있습니다.

다음 단계

Azure SDK for Go 사용을 시작하려면 빠른 시작을 참조하십시오.

Go SDK에서 다른 서비스를 즉시 시작하려면 사용 가능한 샘플 코드 중 일부를 살펴보세요.