Instale o Azure SDK para Go

  • Artigo

Bem-vindo ao SDK do Azure para Go! O SDK permite-lhe gerir e interagir com os serviços do Azure a partir das suas aplicações Go.

Obter o SDK do Azure para Go

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

Pode transferir o SDK do Azure para Go e as respetivas dependências através de go get.

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

Aviso

Certifique-se de que capitaliza Azure no URL. Caso contrário, pode causar problemas na importação de maiúsculas e minúsculas ao trabalhar com o SDK. Também terá de capitalizar Azure nas suas declarações de importação.

Alguns serviços do Azure têm o seu próprio SDK do Go e não estão incluídos no pacote principal de SDK do Azure para Go. A seguinte tabela lista os serviços com os seus próprios SDKs e os nomes dos pacotes. Estes pacotes consideram-se todos em pré-visualização.

Service Pacote
Armazenamento de Blobs github.com/Azure/azure-storage-blob-go
Armazenamento de Ficheiros github.com/Azure/azure-storage-file-go
Fila de Armazenamento github.com/Azure/azure-storage-queue-go
Hub de Eventos github.com/Azure/azure-event-hubs-go
Service Bus github.com/Azure/azure-service-bus-go

Fornecedor do SDK do Azure para Go

O vendoring do SDK do Azure para Go pode ser realizado através do dep. Por motivos de estabilidade, recomenda-se o vendoring. Para utilizar dep no seu próprio projeto, adicione github.com/Azure/azure-sdk-for-go a uma secção [[constraint]] do seu Gopkg.toml. Por exemplo, para realizar o vendoring na versão 14.0.0, adicione a entrada seguinte:

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

Inclua o SDK do Azure para Go no seu projeto

Para utilizar os serviços do Azure a partir do código Go, importe quaisquer serviços com que interage e os módulos autorest necessários. Obtém uma lista completa dos módulos disponíveis do GoDoc para serviços disponíveis e pacotes do AutoRest. Os pacotes mais comuns que precisa do go-autorest são:

Pacote Description
github.com/Azure/go-autorest/autorest Objetos para processar a autenticação de cliente do 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 aceder aos serviços do Azure
github.com/Azure/go-autorest/autorest/to Escreva os programas auxiliares de asserção para trabalhar com estruturas de dados do SDK do Azure

Os pacotes do Go e os serviços do Azure têm versões independentes. As versões dos serviços fazem parte do caminho de importação do módulo, abaixo do 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 novamente do nome do serviço. 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"

Recomenda-se que utilize a versão mais recente de um serviço quando iniciar o desenvolvimento e que seja consistente nessa utilização. Os requisitos dos serviços podem mudar entre versões, o que pode quebrar o seu código, mesmo que não haja atualizações do SDK para Go durante esse período.

Se precisar de um instantâneo coletivo dos serviços, também pode selecionar uma versão de perfil único. Neste momento, o único perfil bloqueado é a versão 2017-03-09, que pode não ter as funcionalidades mais recentes dos serviços. Os perfis encontram-se sob o módulo profiles, com a respetiva versão no formato YYYY-MM-DD. Os serviços são agrupados sob a respetiva versão de perfil. Por exemplo, para importar o módulo de gestão dos Recursos do Azure do perfil 2017-03-09:

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

Aviso

Também estão disponíveis os perfis preview e latest. Não é recomendável utilizá-los. Estes perfis são versões contínuas e podem alterar o comportamento do serviço em qualquer altura.

Próximos passos

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

Se pretender começar a utilizar outros serviços no SDK Go imediatamente, veja alguns códigos de exemplo disponíveis.