Instalowanie zestawu Azure SDK dla języka GoInstall the Azure SDK for Go

Zestaw Azure SDK dla języka Go — Zapraszamy!Welcome to the Azure SDK for Go! Zestaw SDK umożliwia zarządzanie usługami platformy Azure z poziomu aplikacji w języku Go, a także interakcje z tymi usługami.The SDK allows you to manage and interact with Azure services from your Go applications.

Pobieranie zestawu Azure SDK dla języka GoGet the Azure SDK for Go

Zestaw Azure SDK dla języka Go jest zgodny z językiem Go w wersji 1.8 lub nowszej.The Azure SDK for Go is compatible with Go versions 1.8 and higher. W przypadku środowisk korzystających z profilów Azure Stack wymagana jest wersja 1.9 lub nowsza.For environments using Azure Stack Profiles, Go version 1.9 is the minimum requirement. Jeśli chcesz zainstalować język Go, wykonaj instrukcje instalacji języka Go.If you need to install Go, follow the Go installation instructions.

Zestaw Azure SDK dla języka Go i jego zależności można pobrać za pomocą polecenia go get.You can download the Azure SDK for Go and its dependencies via go get.

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

Ostrzeżenie

Ciąg Azure w adresie URL musi zaczynać się wielką literą.Make sure that you capitalize Azure in the URL. W przeciwnym razie podczas pracy z zestawem SDK mogą wystąpić problemy związane z wielkością liter.Doing otherwise can cause case-related import problems when working with the SDK. Ciąg Azure musi zaczynać się wielką literą także w Twoich instrukcjach importu.You also need to capitalize Azure in your import statements.

Niektóre usługi platformy Azure mają własne zestawy SDK dla języka Go, których nie ma w podstawowym pakiecie zestawu Azure SDK dla języka Go.Some Azure services have their own Go SDK and aren't included in the core Azure SDK for Go package. W poniższej tabeli wymieniono usługi z własnymi zestawami SDK i ich nazwy pakietów.The following table lists the services with their own SDKs and their package names. Wszystkie te pakiety są uważane za będące w wersji zapoznawczej.These packages are all considered to be in preview.

UsługaService PakietPackage
Blob StorageBlob Storage github.com/Azure/azure-storage-blob-gogithub.com/Azure/azure-storage-blob-go
File StorageFile Storage github.com/Azure/azure-storage-file-gogithub.com/Azure/azure-storage-file-go
Kolejka magazynuStorage Queue github.com/Azure/azure-storage-queue-gogithub.com/Azure/azure-storage-queue-go
Centrum zdarzeńEvent Hub github.com/Azure/azure-event-hubs-gogithub.com/Azure/azure-event-hubs-go
Service BusService Bus github.com/Azure/azure-service-bus-gogithub.com/Azure/azure-service-bus-go
Application InsightsApplication Insights github.com/Microsoft/ApplicationInsights-gogithub.com/Microsoft/ApplicationInsights-go

Zapewnianie zasobów zestawu Azure SDK dla języka GoVendor the Azure SDK for Go

Zestaw Azure SDK dla języka Go umożliwia zapewnianie zasobów za pośrednictwem narzędzia dep.The Azure SDK for Go may be vendored through dep. Ze względu na stabilność zapewnianie zasobów jest zalecane.For stability reasons, vendoring is recommended. Aby użyć narzędzia dep we własnym projekcie, dodaj element github.com/Azure/azure-sdk-for-go do sekcji [[constraint]] Twojego pliku Gopkg.toml.To use dep in your own project, add github.com/Azure/azure-sdk-for-go to a [[constraint]] section of your Gopkg.toml. Aby na przykład zapewnić zasoby z wersji 14.0.0, dodaj następujący wpis:For example, to vendor on version 14.0.0, add the following entry:

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

Uwzględnianie w projekcie zestawu Azure SDK dla języka GoInclude the Azure SDK for Go in your project

Aby zapewnić możliwość korzystania z usług platformy Azure z poziomu kodu Go, zaimportuj wszystkie usługi, z którymi wchodzisz w interakcje, a także wymagane moduły autorest.To use Azure services from your Go code, import any services you interact with and the required autorest modules. Pełną listę dostępnych modułów można uzyskać w dokumentacji GoDoc dotyczącej dostępnych usług i pakietów AutoRest.You get a complete list of the available modules from GoDoc for available services and AutoRest packages. Najpopularniejsze pakiety z elementu go-autorest, których potrzebujesz, to:The most common packages you need from go-autorest are:

PakietPackage OpisDescription
github.com/Azure/go-autorest/autorestgithub.com/Azure/go-autorest/autorest Obiekty zapewniające obsługę uwierzytelniania klientów w usłudzeObjects for handling service client authentication
github.com/Azure/go-autorest/autorest/azuregithub.com/Azure/go-autorest/autorest/azure Stałe zapewniające interakcje z usługami platformy AzureConstants for interactions with Azure services
github.com/Azure/go-autorest/autorest/adalgithub.com/Azure/go-autorest/autorest/adal Mechanizmy uwierzytelniania dostępu do usług platformy AzureAuthentication mechanisms for accessing Azure services
github.com/Azure/go-autorest/autorest/togithub.com/Azure/go-autorest/autorest/to Pomocnicy asercji typów ułatwiający pracę ze strukturami danych zestawu Azure SDKType assertion helpers for working with Azure SDK data structures

Wersje pakietów języka Go i usług platformy Azure są określane niezależnie.Go packages and Azure services are versioned independently. Wersje usługi są częścią ścieżki importu modułu — za modułem services.The service versions are part of the module import path, underneath the services module. Pełna ścieżka modułu obejmuje kolejno nazwę usługi, wersję w formacie YYYY-MM-DD i ponownie nazwę usługi.The full path for the module is the name of the service, followed by the version in YYYY-MM-DD format, followed by the service name again. Przykład importu wersji 2017-03-30 usługi Compute:For example, to import the 2017-03-30 version of the Compute service:

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

Zaleca się użycie najnowszej wersji usługi w momencie rozpoczęcia programowania i stosowanie jej spójnie.It's recommended that you use the latest version of a service when starting development and keep it consistent. Wymagania dotyczące usług mogą zmieniać się w zależności od wersji, co może uszkodzić kod, nawet jeśli nie zostaną zainstalowane żadne aktualizacje zestawu SDK dla języka Go w tym czasie.Service requirements may change between versions that could break your code, even if there are no Go SDK updates during that time.

Jeśli jest potrzebna zbiorcza migawka usług, możesz również wybrać jedną wersję profilu.If you need a collective snapshot of services, you can also select a single profile version. Obecnie jedynym zablokowanym profilem jest wersja 2017-03-09, która może nie obejmować najnowszych funkcji usługi.Right now, the only locked profile is version 2017-03-09, which may not have the latest features of services. Profile znajdują się w module profiles i mają wersję w formacie YYYY-MM-DD.Profiles are located under the profiles module, with their version in the YYYY-MM-DD format. Usługi są podzielone na grupy według wersji profilu.Services are grouped under their profile version. Aby na przykład zaimportować moduł zarządzania zasobami platformy Azure z profilu 2017-03-09:For example, to import the Azure Resources management module from the 2017-03-09 profile:

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

Ostrzeżenie

Dostępne są także profile preview i latest.There are also preview and latest profiles available. Ich użycie nie jest zalecane.Using them is not recommended. Te profile są wersjami ruchomymi, co znaczy, że zachowanie usługi może w dowolnym momencie ulec zmianie.These profiles are rolling versions and service behavior may change at any time.

Następne krokiNext steps

Aby rozpocząć korzystanie z zestawu Azure SDK dla języka Go, wypróbuj szybki start.To begin using the Azure SDK for Go, try out a quickstart.

Jeśli chcesz od razu rozpocząć pracę z innymi usługami w zestawie SDK dla języka Go, przyjrzyj się udostępnionym przykładom kodu.If you want to get started with other services in the Go SDK immediately, take a look at some of the available sample code.