Installare Azure SDK per Go

  • Articolo

Introduzione ad Azure SDK per Go L'SDK consente di gestire i servizi di Azure dalle applicazioni Go e interagire con essi.

Ottenere Azure SDK per Go

Azure SDK per Go è compatibile con Go 1.8 e versioni successive. Per gli ambienti che usano profili di Azure Stack il requisito minimo è Go versione 1.9. Se è necessario installare Go, seguire le istruzioni di installazione di Go.

È possibile scaricare Azure SDK per Go e le rispettive dipendenze tramite go get.

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

Avviso

Assicurarsi di scrivere Azure in lettere maiuscole nell'URL. In caso contrario, è possibile che si verifichino problemi di importazione correlati alla distinzione tra maiuscole/minuscole durante l'uso dell'SDK. È anche necessario scrivere Azure in lettere maiuscole nelle istruzioni di importazione.

Alcuni servizi di Azure includono un proprio SDK per Go e non sono compresi nel pacchetto Azure SDK per Go di base. La tabella seguente elenca i servizi con SDK propri e i relativi nomi di pacchetto. Questi pacchetti vengono tutti considerati in anteprima.

Service Pacchetto
Archiviazione BLOB github.com/Azure/azure-storage-blob-go
Archiviazione file github.com/Azure/azure-storage-file-go
Archiviazione - Coda github.com/Azure/azure-storage-queue-go
Hub eventi github.com/Azure/azure-event-hubs-go
Bus di servizio github.com/Azure/azure-service-bus-go

Eseguire il vendoring di Azure SDK per Go

È possibile eseguire il vendoring di Azure SDK per Go tramite dep. Per motivi di stabilità è consigliabile eseguire il vendoring. Per usare dep nel proprio progetto, aggiungere github.com/Azure/azure-sdk-for-go a una sezione [[constraint]] di Gopkg.toml. Per eseguire ad esempio il vendoring sulla versione 14.0.0, aggiungere la voce seguente:

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

Includere Azure SDK per Go nel progetto

Per usare i servizi di Azure dal codice di Go, importare eventuali servizi con cui si interagisce e i moduli autorest necessari. Si ottiene un elenco completo dei moduli disponibili da GoDoc per i servizi disponibili e per i pacchetti AutoRest. I pacchetti più comuni necessari da go-autorest sono:

Pacchetto Descrizione
github.com/Azure/go-autorest/autorest Oggetti per la gestione dell'autenticazione del client del servizio
github.com/Azure/go-autorest/autorest/azure Costanti per le interazioni con i servizi di Azure
github.com/Azure/go-autorest/autorest/adal Meccanismi di autenticazione per l'accesso ai servizi di Azure
github.com/Azure/go-autorest/autorest/to Helper di asserzione tipi per l'uso di strutture dei dati di Azure SDK

Il controllo delle versioni dei pacchetti Go e dei servizi di Azure viene eseguito in modo indipendente. Le versioni del servizio sono parte del percorso di importazione del modulo, disponibile nel modulo services. Il percorso completo per il modulo è il nome del servizio, seguito dalla versione in formato YYYY-MM-DD e quindi seguito nuovamente dal nome del servizio. Per importare ad esempio la versione 2017-03-30 del servizio di calcolo:

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

È consigliabile usare la versione più recente di un servizio all'inizio dello sviluppo e mantenere la coerenza a livello di versione. È possibile che le diverse versioni presentino modifiche ai requisiti del servizio che potrebbero provocare interruzioni del codice, anche se non vengono applicati aggiornamenti a Go SDK in tale intervallo di tempo.

Se è necessario uno snapshot collettivo dei servizi, è anche possibile selezionare una singola versione del profilo. La versione dell'unico profilo bloccato è ora 2017-03-09, che potrebbe non includere le funzionalità più recenti dei servizi. I profili sono disponibili nel modulo profiles, con la rispettiva versione in formato YYYY-MM-DD. I servizi vengono raggruppati sotto la rispettiva versione del profilo. Per importare ad esempio il modulo di gestione delle risorse di Azure dal profilo 2017-03-09:

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

Avviso

Sono disponibili anche profili preview e latest. L'uso di questi profili non è consigliato. Questi profili sono versioni incrementali ed è possibile che il comportamento dei servizi cambi in qualsiasi momento.

Passaggi successivi

Per iniziare a usare Azure SDK per Go, provare a seguire una guida introduttiva.

Per iniziare immediatamente a usare altri servizi in Go SDK, vedere il codice di esempio disponibile.