Installera Azure SDK för Go

  • Artikel

Välkommen till Azure SDK för Go! Med detta SDK kan du hantera och interagera med Azure-tjänster från Go-program.

Hämta Azure SDK för Go

Azure SDK för Go är kompatibel med Go-version 1.8 och senare. För miljöer med Azure Stack-profiler är Go-versionen 1.9 minimikravet. Följ installationsanvisningarna om du behöver installera Go.

Du kan hämta Azure SDK för Go och dess beroenden via go get.

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

Varning

Kontrollera att du använder versaler för Azure i webbadressen. Om du inte gör det kan det orsaka importproblem när du arbetar med SDK. Du måste även använda versaler för Azure i importinstruktioner.

Vissa Azure-tjänster har sitt eget Go-SDK och ingår inte i Azure SDK for Go-grundpaketet. Följande tabell innehåller en lista över tjänsterna med egna SDK:er och deras paketnamn. Alla dessa paket anses utgöra en förhandsversion.

Tjänst Paket
Blob Storage github.com/Azure/azure-storage-blob-go
File Storage github.com/Azure/azure-storage-file-go
Lagringskö github.com/Azure/azure-storage-queue-go
Händelsehubben github.com/Azure/azure-event-hubs-go
Service Bus github.com/Azure/azure-service-bus-go

Vendoring i Azure SDK för Go

Du kan utföra vendoring för Azure SDK för Go via dep. Vendoring rekommenderas av stabilitetsskäl. Om du vill använda dep i ditt projekt lägger du till github.com/Azure/azure-sdk-for-go i ett [[constraint]]-avsnitt i din Gopkg.toml. Om du till exempel vill utföra vendoring för version 14.0.0 lägger du till följande post:

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

Ta med Azure SDK för Go i ditt projekt

Om du vill använda Azure-tjänster från din Go-kod importerar du alla tjänster som du interagerar med samt de nödvändiga autorest-modulerna. Du får en fullständig lista över tillgängliga moduler från GoDoc för tillgängliga tjänster och AutoRest-paket. De vanligaste paketen som du behöver från go-autorest är:

Paket beskrivning
github.com/Azure/go-autorest/autorest Objekt för hantering av tjänstklientautentisering
github.com/Azure/go-autorest/autorest/azure Konstanter för interaktioner med Azure-tjänster
github.com/Azure/go-autorest/autorest/adal Autentiseringsmekanismer för åtkomst till Azure-tjänster
github.com/Azure/go-autorest/autorest/to Ange kontrollhjälp för att arbeta med Azure SDK-datastrukturer

Versioner av Go-paket och Azure-tjänster är oberoende av varandra. Tjänstversionerna är en del av importsökvägen för modulen nedanför modulen services. Den fullständiga sökvägen för modulen är namnet på tjänsten, följt av versionen i formatet YYYY-MM-DD, följt av namnet på tjänsten igen. Så här importerar du till exempel versionen 2017-03-30 av beräkningstjänsten:

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

Vi rekommenderar att du använder den senaste versionen av en tjänst när du börjar utveckla och är konsekvent. Tjänstekrav kan ändras från en version till nästa och det kan bryta din kod, även om det inte förekommer Go SDK-uppdateringar under den tiden.

Du kan även välja en enskild profilversion om du behöver en kollektiv ögonblicksbild av tjänsterna. Just nu är den enda låsta profilen version 2017-03-09, som kanske inte har de senaste funktionerna för tjänsterna. Profilerna finns under modulen profiles med versionerna i formatet YYYY-MM-DD. Tjänsterna är grupperade under profilversionerna. Så här importerar du till exempel hanteringsmodulen för Azure-resurser från profilen 2017-03-09:

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

Varning

Även profilerna preview och latest är tillgängliga. Vi rekommenderar inte att du använder dem. De här profilerna är löpande versioner och tjänstbeteendet kan därför ändras när som helst.

Nästa steg

Testa att använda en snabbstart om du vill börja använda Azure SDK för Go.

Om du vill komma igång med andra tjänster i Go SDK direkt så kan du ta en titt på några av de tillgängliga exempelkoderna.