Установка пакета Azure SDK для GoInstall the Azure SDK for Go

Добро пожаловать в пакет Azure SDK для Go!Welcome to the Azure SDK for Go! Этот пакет SDK позволяет взаимодействовать со службами Azure и управлять ими из приложений Go.The SDK allows you to manage and interact with Azure services from your Go applications.

Получение пакета Azure SDK для GoGet the Azure SDK for Go

Пакет Azure SDK для Go совместим с Go версии 1.8 и выше.The Azure SDK for Go is compatible with Go versions 1.8 and higher. Для окружений, в которых используются профили Azure Stack, требуется Go версии не ниже 1.9.For environments using Azure Stack Profiles, Go version 1.9 is the minimum requirement. Чтобы установить Go, следуйте соответствующим инструкциям.If you need to install Go, follow the Go installation instructions.

Вы можете скачать пакет Azure SDK для Go и его зависимости с помощью команды 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/...

Предупреждение

Убедитесь, что в URL-адресе слово Azure написано с прописной буквы.Make sure that you capitalize Azure in the URL. В противном случае при работе с пакетом SDK могут возникнуть проблемы импорта, связанные с регистром.Doing otherwise can cause case-related import problems when working with the SDK. Azure также нужно указывать с прописной буквы в операторах импорта.You also need to capitalize Azure in your import statements.

Некоторые службы Azure содержат собственные пакеты SDK Go, которые не включены в основной пакет Azure SDK для Go.Some Azure services have their own Go SDK and aren't included in the core Azure SDK for Go package. В следующей таблице перечислены службы, содержащие собственные пакеты SDK, с указанием имен пакетов.The following table lists the services with their own SDKs and their package names. Все эти пакеты доступны в режиме предварительной версии.These packages are all considered to be in preview.

ServiceService PackagePackage
Хранилище BLOB-объектовBlob Storage github.com/Azure/azure-storage-blob-gogithub.com/Azure/azure-storage-blob-go
Хранилище файловFile Storage github.com/Azure/azure-storage-file-gogithub.com/Azure/azure-storage-file-go
Очередь службы хранилищаStorage Queue github.com/Azure/azure-storage-queue-gogithub.com/Azure/azure-storage-queue-go
Концентратор событийEvent Hub github.com/Azure/azure-event-hubs-gogithub.com/Azure/azure-event-hubs-go
Служебная шина AzureService 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

Вендоринг пакета Azure SDK для GoVendor the Azure SDK for Go

Выполнить вендоринг пакета Azure SDK для Go можно с помощью средства dep.The Azure SDK for Go may be vendored through dep. Чтобы обеспечить стабильность, мы рекомендуем использовать вендоринг.For stability reasons, vendoring is recommended. Для использования dep в проекте добавьте github.com/Azure/azure-sdk-for-go в раздел [[constraint]] файла 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. Например, чтобы выполнить вендоринг для версии 14.0.0, добавьте следующую запись: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"

Добавление пакета Azure SDK для Go в проектInclude the Azure SDK for Go in your project

Чтобы использовать службы Azure из кода Go, импортируйте все службы, с которыми вы взаимодействуете, и необходимые модули autorest.To use Azure services from your Go code, import any services you interact with and the required autorest modules. Получить полный список доступных модулей для доступных служб и пакетов AutoRest можно на сайте GoDoc.You get a complete list of the available modules from GoDoc for available services and AutoRest packages. Ниже приводятся наиболее распространенные пакеты, которые нужно скачать в репозитории go-autorest:The most common packages you need from go-autorest are:

PackagePackage ОПИСАНИЕDescription
github.com/Azure/go-autorest/autorestgithub.com/Azure/go-autorest/autorest Объекты для обработки аутентификации клиента службыObjects for handling service client authentication
github.com/Azure/go-autorest/autorest/azuregithub.com/Azure/go-autorest/autorest/azure Константы для взаимодействия со службами AzureConstants for interactions with Azure services
github.com/Azure/go-autorest/autorest/adalgithub.com/Azure/go-autorest/autorest/adal Механизмы аутентификации для доступа к службам AzureAuthentication mechanisms for accessing Azure services
github.com/Azure/go-autorest/autorest/togithub.com/Azure/go-autorest/autorest/to Вспомогательные приложения утверждения типа для работы со структурами данных пакета Azure SDKType assertion helpers for working with Azure SDK data structures

Версии пакетов Go и служб Azure управляются независимо друг от друга.Go packages and Azure services are versioned independently. Версии службы входят в путь импорта модуля (под модулем services).The service versions are part of the module import path, underneath the services module. Полный путь к модулю состоит из имени службы, за которым следует версия в формате YYYY-MM-DD и снова имя службы.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. Например, чтобы импортировать версию 2017-03-30 службы вычислений, выполните следующий код: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"

При запуске разработки рекомендуется использовать и поддерживать последнюю версию службы.It's recommended that you use the latest version of a service when starting development and keep it consistent. Требования службы могут изменяться в разных версиях. Это может привести к ошибкам кода, даже если в это время обновления пакета SDK для Go не выполняются.Service requirements may change between versions that could break your code, even if there are no Go SDK updates during that time.

Если требуется общий моментальный снимок служб, вы также можете выбрать одну версию профиля.If you need a collective snapshot of services, you can also select a single profile version. В нашем случае версия 2017-03-09 относится только к заблокированному профилю, который может не содержать последние версии служб и функций.Right now, the only locked profile is version 2017-03-09, which may not have the latest features of services. Профили находятся в папке модуля profiles вместе с версиями в формате YYYY-MM-DD.Profiles are located under the profiles module, with their version in the YYYY-MM-DD format. Службы группируются по версиям профиля.Services are grouped under their profile version. Например, чтобы импортировать модуль управления ресурсами Azure из профиля 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"

Предупреждение

Существуют также профили preview и latest.There are also preview and latest profiles available. Мы не рекомендуем использовать их.Using them is not recommended. Это профили промежуточных версий, и поведение службы может измениться в любое время.These profiles are rolling versions and service behavior may change at any time.

Дополнительная информацияNext steps

Чтобы начать работу с пакетом Azure SDK для Go, используйте код быстрого запуска.To begin using the Azure SDK for Go, try out a quickstart.

Чтобы сразу приступить к работе с другими службами с помощью пакета SDK для Go, ознакомьтесь с доступными примерами кода.If you want to get started with other services in the Go SDK immediately, take a look at some of the available sample code.