A Góhoz készült Azure SDK telepítése

  • Cikk

Üdvözöli Önt a Góhoz készült Azure SDK! Az SDK lehetővé teszi, hogy Go-alkalmazásokból kezelhesse és használhassa az Azure-szolgáltatásokat.

A Góhoz készült Azure SDK beszerzése

A Góhoz készült Azure SDK a Go 1.8-as és újabb verzióival kompatibilis. Az Azure Stack-profilokat használó környezetekben a Go 1.9-es verziója a minimális követelmény. Ha telepítenie kell a Gót, kövesse a Go telepítési utasításait.

A Góhoz készült Azure SDK-t és annak függőségeit a következőn keresztül töltheti le: go get.

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

Figyelmeztetés

Győződjön meg arról, hogy az Azure nagybetűvel szerepeljen az URL-címben. Ellenkező esetben az írásmóddal kapcsolatos importálási hibák fordulhatnak elő az SDK használatakor. Az Azure szót az importálási utasításokban is nagybetűvel kell megadni.

Bizonyos Azure-szolgáltatások saját Go SDK-val rendelkeznek, ezért a Góhoz készült Azure SDK főcsomagok nem tartalmazzák őket. A következő táblázatban láthatók a saját SDK-val rendelkező szolgáltatások és a csomagneveik. Ezek a csomagok előzetes verziójú csomagoknak minősülnek.

Service Csomag
Blob Storage github.com/Azure/azure-storage-blob-go
File Storage github.com/Azure/azure-storage-file-go
Tárolási üzenetsor github.com/Azure/azure-storage-queue-go
Esemény központja github.com/Azure/azure-event-hubs-go
Service Bus github.com/Azure/azure-service-bus-go

A Góhoz készült Azure SDK bemásolása

A Góhoz készült Azure SDK a dep eszközön keresztül másolható be. A stabilitás miatt ajánlott a bemásolás elvégzése. A dep a saját projektjében való használatához adja a github.com/Azure/azure-sdk-for-go elemet a Gopkg.toml egyik [[constraint]] szakaszához. A 14.0.0 verzió bemásolásához például adja hozzá a következő bejegyzést:

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

A Góhoz készült Azure SDK projektbe foglalása

Ha a Go-kódból szeretné használni az Azure-szolgáltatásokat, importálja az összes használt szolgáltatást és a szükséges autorest modulokat. A GoDocról beszerezheti az elérhető szolgáltatások és az AutoRest csomagok elérhető moduljainak teljes listáját. A go-autorest leggyakrabban igényelt csomagjai a következők:

Csomag Leírás
github.com/Azure/go-autorest/autorest A szolgáltatásügyfél-hitelesítés kezelésének objektumai
github.com/Azure/go-autorest/autorest/azure Az Azure-szolgáltatások használatának állandói
github.com/Azure/go-autorest/autorest/adal Az Azure-szolgáltatások elérésének hitelesítési mechanizmusai
github.com/Azure/go-autorest/autorest/to Az Azure SDK adatstruktúrákon működő típuskijelentési segítők

A Go-csomagok és az Azure-szolgáltatások egymástól függetlenül vannak ellátva verzióval. A szolgáltatás verziói a modul importálási útvonalának részei a services modul alatt. A modul teljes elérési útja a szolgáltatás neve, amelyet a verzió követ YYYY-MM-DD formátumban, amelyet ismét a szolgáltatás neve követ. A számítási szolgáltatás 2017-03-30 verziójának importálásához például:

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

A fejlesztés megkezdésekor ajánlott a szolgáltatás legújabb verzióját használni és annál is maradni. A szolgáltatás követelményei megváltozhatnak az egyes verziók között, ami miatt a kódja működésképtelenné válhat, még akkor is, ha az alatt az idő alatt a Go SDK nem frissült.

Ha a szolgáltatások együttes pillanatképére van szüksége, kiválaszthat egyetlen profilverziót is. Jelenleg az egyetlen zárolt profil a 2017-03-09 verzió, amelyben elképzelhető, hogy nem a legújabb szolgáltatásfunkciók szerepelnek. A profilok a profiles modul alatt találhatók, a verziójuk YYYY-MM-DD formátumban van. A szolgáltatások a profilverzióik alatt vannak csoportosítva. Ha például az Azure-erőforrások felügyeleti modult szeretné importálni a 2017-03-09 profilból:

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

Figyelmeztetés

A preview és latest profilok is elérhetők. Ezek használata nem ajánlott. Ezek a profilok működés közbeni verziók, és a szolgáltatás működése bármikor megváltozhat.

További lépések

A Góhoz készült Azure SDK használatának megkezdéséhez próbáljon ki egy rövid útmutatót.

Ha most azonnal el szeretné kezdeni a Go SDK más szolgáltatásainak használatát, tekintsen meg néhány rendelkezésre álló mintakódot.