Instalace Azure SDK for Go

  • Článek

Vítá vás Azure SDK for Go! Sada SDK umožňuje spravovat služby Azure a pracovat s nimi z aplikací Go.

Získání sady Azure SDK for Go

Sada Azure SDK pro Go je kompatibilní s Go verze 1.8 a novější. Pro prostředí využívající profily Azure Stack Profiles se vyžaduje minimálně Go verze 1.9. Pokud potřebujete Go nainstalovat, postupujte podle pokynů pro instalaci Go.

Sadu Azure SDK pro Go a její závislosti můžete stáhnout prostřednictvím go get.

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

Upozorňující

Nezapomeňte pro Azure v adrese URL použít velká písmena. Pokud to neuděláte, při práci s touto sadou SDK mohou nastat problémy při importu, které souvisejí s použitím velkých a malých písmen. Velká písmena musíte použít také pro Azure v příkazech pro import.

Některé služby Azure mají vlastní sady Go SDK a nejsou zahrnuté v základním balíčku Azure SDK for Go. Následující tabulka uvádí služby s vlastními sadami SDK a názvy jejich balíčků. Všechny tyto balíčky se považují za verze Preview.

Service Balíček
Blob Storage github.com/Azure/azure-storage-blob-go
File Storage github.com/Azure/azure-storage-file-go
Fronta úložiště github.com/Azure/azure-storage-queue-go
Centrum událostí github.com/Azure/azure-event-hubs-go
Service Bus github.com/Azure/azure-service-bus-go

Vendorizace sady Azure SDK for Go

K vendorizaci sady Azure SDK for Go je možné použít dep. Z důvodů stability se doporučuje vendoring. Pokud chcete dep použít ve vašem vlastním projektu, přidejte github.com/Azure/azure-sdk-for-go do oddílu [[constraint]] ve vašem souboru Gopkg.toml. Pokud například chcete vendorizovat verzi 14.0.0, přidejte následující položku:

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

Zahrnutí sady Azure SDK for Go do vašeho projektu

Pokud chcete používat služby Azure z kódu Go, naimportujte všechny služby, s nimiž interagujete, a požadované moduly autorest. Získáte úplný seznam dostupných modulů z GoDoc pro dostupné služby a balíčky AutoRest. Nejběžnější balíčky, které potřebujete z go-autorest:

Balíček Popis
github.com/Azure/go-autorest/autorest Objekty pro zpracování ověřování klientů služby
github.com/Azure/go-autorest/autorest/azure Konstanty pro interakci se službami Azure
github.com/Azure/go-autorest/autorest/adal Mechanismy ověřování pro přístup ke službám Azure
github.com/Azure/go-autorest/autorest/to Pomocné rutiny potvrzení typu pro práci s datovými strukturami Azure SDK

Balíčky Go a služby Azure mají verze nezávislé na sobě. Verze služeb jsou součástí cesty pro import modulu (pod modulem services). Úplnou cestu pro modul tvoří název příslušné služby, za kterým následuje verze ve formátu YYYY-MM-DD a potom znovu název služby. Pokud například chcete importovat verzi 2017-03-30 služby Compute:

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

Při zahájení vývoje doporučujeme používat nejnovější verzi služby a zachovat její konzistenci. Mezi jednotlivými verzemi může dojít ke změně požadavků na službu, které by mohly způsobit narušení vašeho kódu, a to i když během této doby nejsou žádné aktualizace sady Go SDK.

Pokud potřebujete souhrnný snímek služeb, můžete také vybrat jednu verzi profilu. Jediným uzamčeným profilem momentálně je verze 2017-03-09, která nemusí mít nejnovější funkce služeb. Profily jsou umístěné v modulu profiles a jejich verze má formát YYYY-MM-DD. Služby jsou seskupené v příslušné verzi profilu. Pokud chcete například naimportovat modul správy prostředků Azure z profilu 2017-03-09:

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

Upozorňující

K dispozici jsou také profily preview a latest. Jejich použití se nedoporučuje. Tyto profily představují klouzavé verze a chování služeb se může kdykoli změnit.

Další kroky

Pokud chcete začít používat sadu Azure SDK for Go, vyzkoušejte si rychlý start.

Pokud chcete okamžitě začít pracovat s jinými službami v sadě Go SDK, prohlédněte si dostupný ukázkový kód.