Installieren des Azure SDK für Go

  • Artikel

Willkommen beim Azure SDK für Go! Mit diesem SDK können Sie Azure-Dienste über Ihre Go-Anwendungen verwalten und mit ihnen interagieren.

Abrufen des Azure SDK für Go

Das Azure SDK für Go ist mit Go-Version 1.8 und höheren Versionen kompatibel. Bei Umgebungen mit Azure Stack-Profilen ist mindestens Go-Version 1.9 erforderlich. Falls Sie Go installieren müssen, befolgen Sie die Installationsanweisungen für Go.

Sie können das Azure SDK für Go und seine Abhängigkeiten über go get herunterladen.

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

Warnung

Schreiben Sie Azure in der URL unbedingt groß. Andernfalls können bei der Verwendung des SDK Importprobleme aufgrund der Groß-/Kleinschreibung auftreten. Azure muss außerdem in den Importanweisungen großgeschrieben werden.

Einige Azure-Dienste verfügen über ein eigenes Go SDK und sind nicht im Kernpaket von Azure SDK für Go enthalten. In der folgenden Tabelle sind die Dienste mit eigenen SDKs und deren Paketnamen aufgeführt. Alle diese Pakete gelten als Vorschauversion.

Service Paket
Blob Storage github.com/Azure/azure-storage-blob-go
File Storage github.com/Azure/azure-storage-file-go
Speicherwarteschlange github.com/Azure/azure-storage-queue-go
Event Hub github.com/Azure/azure-event-hubs-go
Service Bus github.com/Azure/azure-service-bus-go

Durchführen des Vendorings für das Azure SDK für Go

Das Vendoring für das Azure SDK für Go kann mit dep durchgeführt werden. Das Vendoring wird aus Stabilitätsgründen empfohlen. Fügen Sie zur Verwendung von dep in Ihrem eigenen Projekt github.com/Azure/azure-sdk-for-go zum Abschnitt [[constraint]] in Gopkg.toml hinzu. Fügen Sie beispielsweise den folgenden Eintrag hinzu, um das Vendoring für Version 14.0.0 durchzuführen:

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

Integrieren des Azure SDK für Go in Ihr Projekt

Importieren Sie beliebige Dienste, mit denen Sie interagieren, und die erforderlichen autorest-Module, um Azure-Dienste in Ihrem Go-Code zu nutzen. Sie erhalten eine vollständige Liste mit den verfügbaren Modulen von GoDoc für verfügbare Dienste und AutoRest-Pakete. Die am häufigsten verwendeten Pakete, die Sie für go-autorest benötigen, sind:

Paket Beschreibung
github.com/Azure/go-autorest/autorest Objekte zur Verarbeitung der Dienstclientauthentifizierung
github.com/Azure/go-autorest/autorest/azure Konstanten für Interaktionen mit Azure-Diensten
github.com/Azure/go-autorest/autorest/adal Authentifizierungsmechanismen für den Zugriff auf Azure-Dienste
github.com/Azure/go-autorest/autorest/to Hilfsprogramme für die Typassertion für die Arbeit mit Azure SDK-Datenstrukturen

Die Versionsangaben von Go-Paketen und Azure-Diensten sind voneinander unabhängig. Die Dienstversionen sind Teil des Modulimportpfads im Modul services. Der vollständige Pfad für das Modul ist der Name des Diensts, gefolgt von der Version im Format YYYY-MM-DD, worauf erneut der Dienstname folgt. Beispiel für den Import der Version 2017-03-30 des Computediensts:

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

Es wird empfohlen, die aktuelle Version eines Diensts zu verwenden, wenn Sie mit der Entwicklung beginnen, und die Versionen konsistent zu halten. Dienstanforderungen können sich zwischen Versionen ändern und zu Codefehlern führen, obwohl das Go SDK gar nicht aktualisiert wurde.

Wenn Sie eine gemeinsame Momentaufnahme aller Dienste benötigen, können Sie auch eine einzelne Profilversion wählen. Das einzige gesperrte Profil ist derzeit Version 2017-03-09, die unter Umständen nicht über die aktuellen Features der Dienste verfügt. Profile befinden sich unter dem Modul profiles, und die Version wird im Format YYYY-MM-DD angegeben. Dienste werden unter ihrer Profilversion gruppiert. Beispiel für den Import des Verwaltungsmoduls für Azure-Ressourcen aus dem Profil 2017-03-09:

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

Warnung

Außerdem sind die Profile preview und latest verfügbar. Ihre Verwendung ist nicht empfehlenswert. Diese Profile sind fortlaufende Versionen, und das Dienstverhalten kann sich im Laufe der Zeit ändern.

Nächste Schritte

Probieren Sie einen Schnellstart aus, um mit der Verwendung des Azure SDK für Go zu beginnen.

Wenn Sie sofort mit anderen Diensten im Go SDK starten möchten, ist es ratsam, sich den verfügbaren Beispielcode anzusehen.