Instalace Azure SDK for Go
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.
- Nasazení virtuálního počítače ze šablony
- Přenos objektů do Azure Blob Storage s využitím sady Azure Blob SDK for Go
- Připojení k Azure Database for PostgreSQL
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.
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro