Installieren des Azure SDK für Go
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.
- Bereitstellen eines virtuellen Azure-Computers über eine Vorlage mit dem Azure SDK für Go
- Übertragen von Objekten nach/aus Azure Blob Storage mit Go
- Herstellen einer Verbindung mit Azure Database for PostgreSQL
Wenn Sie sofort mit anderen Diensten im Go SDK starten möchten, ist es ratsam, sich den verfügbaren Beispielcode anzusehen.
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für