De Azure SDK voor Go installeren

  • Artikel

Welkom bij de Azure SDK voor Go. Met de SDK kunt u Azure-services beheren en ermee communiceren vanuit uw Go-toepassingen.

De Azure SDK voor Go ophalen

De Azure SDK voor Go is compatibel met Go-versie 1.8 en hoger. Voor omgevingen die gebruikmaken van Azure Stack-profielen is Go-versie 1.9 de minimale vereiste. Volg de installatie-instructies voor Go als u Go moet installeren.

U downloadt de Azure SDK voor Go en de afhankelijkheden ervan via go get.

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

Waarschuwing

Zorg ervoor dat u Azure in de URL in hoofdletters schrijft. Als u dit niet doet, kan dit importproblemen opleveren wanneer u aan het werk bent met de SDK. U moet Azure ook in uw importinstructies in hoofdletters schrijven.

Sommige Azure-services hebben hun eigen SDK voor Go en zijn niet opgenomen in het basispakket Azure SDK voor Go. De volgende tabel toont de services met hun eigen SDK's en hun pakketnamen. Deze pakketten worden allemaal beschouwd als Preview-versie.

Service Pakket
Blob Storage github.com/Azure/azure-storage-blob-go
File Storage github.com/Azure/azure-storage-file-go
Opslagwachtrij github.com/Azure/azure-storage-queue-go
Event Hub github.com/Azure/azure-event-hubs-go
Service Bus github.com/Azure/azure-service-bus-go

De Azure SDK voor Go bewaren in Vendor

Het is mogelijk om de Azure SDK voor Go in de map Vendor te bewaren via dep. Ten behoeve van de stabiliteit is het aanbevolen om Vendor te gebruiken. Gebruik dep in uw eigen project, voeg github.com/Azure/azure-sdk-for-go toe aan een sectie [[constraint]] van uw Gopkg.toml. Als u bijvoorbeeld gebruik wilt maken van Vendor op versie 14.0.0, voegt u de volgende vermelding toe:

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

De Azure SDK voor Go opnemen in uw project

Als u Azure-services vanuit uw Go-code wilt gebruiken, importeert u de services waarmee u communiceert en de vereiste autorest-modules. U krijgt een volledige lijst te zien van de beschikbare modules van GoDoc voor beschikbare services en AutoRest-pakketten. De meestvoorkomende pakketten die u van go-autorest nodig hebt, zijn:

Pakket Beschrijving
github.com/Azure/go-autorest/autorest Objecten om de service-clientverificatie te verwerken
github.com/Azure/go-autorest/autorest/azure Constanten voor interactie met Azure-services
github.com/Azure/go-autorest/autorest/adal Verificatiemechanismen voor toegang tot Azure-services
github.com/Azure/go-autorest/autorest/to Type assertiehulpprogramma's om met Azure SDK-gegevensstructuren te werken

Go-pakketten en Azure-services krijgen onafhankelijk van elkaar een versienummer. De serviceversies zijn deel van het importpad van de module, onder de module services. Het volledige pad voor de module is de naam van de service, gevolgd door de versie in de indeling YYYY-MM-DD en weer gevolgd door de naam van de service. Als u bijvoorbeeld de versie van 2017-03-30 wilt importeren in de Compute-service, gebruikt u:

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

Het wordt aanbevolen dat u de nieuwste versie van een service gebruikt wanneer u begint te ontwikkelen en dat u die behoudt. Servicevereisten kunnen verschillen tussen versies en dat kan uw code breken, zelfs als er op dat moment geen updates van de Go SDK zijn.

U kunt ook één profielversie selecteren als u een collectieve momentopname van de services nodig hebt. Het enige vergrendelde profiel is momenteel 2017-03-09, dat wellicht niet over de nieuwste functies of services beschikt. Profielen bevinden zich in de module profiles met de versie in de indeling YYYY-MM-DD. Services worden op basis van hun profielversie gegroepeerd. Als u bijvoorbeeld de Azure Resources-beheermodule wilt importeren uit het profiel 2017-03-09, gebruikt u:

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

Waarschuwing

De profielen preview en latest zijn ook beschikbaar. Het gebruik ervan is niet aanbevolen. Deze profielen zijn doorlopende versies en het servicegedrag kan op elk moment veranderen.

Volgende stappen

Gebruik een snelstartgids om aan de slag te gaan met de Azure SDK voor Go.

Als u onmiddellijk aan de slag wilt gaan met andere services in de Go SDK, kunt u een aantal van de beschikbare voorbeeldcodes bekijken.