Instale o SDK do Azure para linguagem Go

  • Artigo

Bem-vindo ao SDK do Azure para linguagem Go! O SDK permite gerenciar e interagir com os serviços do Azure em seus aplicativos Go.

Obtenha o SDK do Azure para linguagem Go

O SDK do Azure para linguagem Go é compatível com as versões 1.8 e mais recentes da linguagem Go. Para ambientes usando Perfis do Azure Stack, a versão 1.9 do Go é o requisito mínimo. Se você precisar instalar a linguagem Go, siga as instruções de instalação da linguagem Go.

Você pode obter o SDK do Azure para linguagem Go e suas dependências via go get.

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

Aviso

Certifique-se de que você coloca Azure em letra maiúscula na URL. Fazer o contrário pode causar problemas de importação relacionadas a caso ao trabalhar com o SDK. Você também precisa colocar Azure em maiúscula em suas instruções de importação.

Alguns serviços do Azure têm seu próprio SDK do Go e não estão incluídos no pacote base de SDK do Azure para linguagem Go. A tabela a seguir lista os serviços com seus próprios SDKs e os nomes de pacote. Esses pacotes são considerados em versão prévia.

Serviço Pacote
Armazenamento de Blobs github.com/Azure/azure-storage-blob-go
Armazenamento de Arquivos github.com/Azure/azure-storage-file-go
Fila de Armazenamento github.com/Azure/azure-storage-queue-go
Hub de Evento github.com/Azure/azure-event-hubs-go
Barramento de Serviço github.com/Azure/azure-service-bus-go

Fornecimento do SDK do Azure para linguagem Go

O SDK do Azure para linguagem Go pode usar a funcionalidade de vendoring pelo dep. Por motivos de estabilidade, é recomendado usar vendoring. Para usar dep em seu próprio projeto, adicione github.com/Azure/azure-sdk-for-go a uma seção [[constraint]] do seu Gopkg.toml. Por exemplo, para o vendor na versão 14.0.0, adicione a seguinte entrada:

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

Incluir o SDK do Azure para linguagem Go em seu projeto

Para usar os serviços do Azure a partir de seu código Go, importe todos os serviços com os quais você interage e os módulos autorest necessários. Você obterá uma lista completa dos módulos disponíveis do GoDoc para os serviços disponíveis e pacotes AutoRest. Os pacotes mais comuns do go-autorest de que você precisa são:

Pacote Descrição
github.com/Azure/go-autorest/autorest Objetos para lidar com a autenticação de cliente de serviço
github.com/Azure/go-autorest/autorest/azure Constantes para interações com os serviços do Azure
github.com/Azure/go-autorest/autorest/adal Mecanismos de autenticação para acessar os serviços do Azure
github.com/Azure/go-autorest/autorest/to Digite os auxiliares de asserção para trabalhar com as estruturas de dados do SDK do Azure

Os pacotes da linguagem Go e os serviços do Azure possuem controle de versão independente. As versões de serviço fazem parte do caminho de importação do módulo, sob o módulo services. O caminho completo para o módulo é o nome do serviço, seguido da versão no formato YYYY-MM-DD, seguido do nome do serviço novamente. Por exemplo, para importar a versão 2017-03-30 do serviço de computação:

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

É recomendável que você use a versão mais recente de um serviço ao iniciar o desenvolvimento e mantenha-os consistentes. Os requisitos de serviço podem ser alterados entre as versões o que poderia interromper o seu código, mesmo se não existem atualizações do SDK da linguagem Go durante esse período.

Se você precisar de um instantâneo coletivo dos serviços, você também pode selecionar uma versão de perfil. Agora, o único perfil bloqueado é a versão 2017-03-09, que pode não ter os recursos mais recentes dos serviços. Os perfis estão localizados no módulo profiles, com a versão no formato YYYY-MM-DD. Os serviços são agrupados em sua versão de perfil. Por exemplo, para importar o módulo de gerenciamento de recursos do Azure a partir do perfil 2017-03-09:

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

Aviso

Os perfis preview e latest também estão disponíveis. Porém, não é recomendado usá-los. Esses perfis são versões progressivas, e o comportamento do serviço poderá mudar a qualquer momento.

Próximas etapas

Para começar a usar o SDK do Azure para linguagem Go, experimente um início rápido.

Se você quiser começar com outros serviços no SDK Go imediatamente, dê uma olhada em alguns códigos de exemplo disponíveis.