Instale o SDK do Azure para linguagem Go
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.
- Implantar uma máquina virtual no Azure a partir de um modelo
- Transferir objetos para o Armazenamento de Blobs do Azure usando o SDK de Blobs do Azure para linguagem Go
- Conectar-se ao Banco de Dados do Azure para PostgreSQL
Se você quiser começar com outros serviços no SDK Go imediatamente, dê uma olhada em alguns códigos de exemplo disponíveis.
- Autenticar com os serviços do Azure
- Implantar novas máquinas virtuais com autenticação SSH
- Implantar uma imagem de contêiner nas Instâncias de Contêiner do Azure
- Criar um cluster no Serviço Kubernetes do Azure
- Trabalhar com serviços de Armazenamento do Azure
- Todos os exemplos do SDK do Azure para linguagem Go
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de