Instalowanie zestawu Azure SDK dla języka Go

  • Artykuł

Zestaw Azure SDK dla języka Go — Zapraszamy! Zestaw SDK umożliwia zarządzanie usługami platformy Azure z poziomu aplikacji w języku Go, a także interakcje z tymi usługami.

Pobieranie zestawu Azure SDK dla języka Go

Zestaw Azure SDK dla języka Go jest zgodny z językiem Go w wersji 1.8 lub nowszej. W przypadku środowisk korzystających z profilów Azure Stack wymagana jest wersja 1.9 lub nowsza. Jeśli chcesz zainstalować język Go, wykonaj instrukcje instalacji języka Go.

Zestaw Azure SDK dla języka Go i jego zależności można pobrać za pomocą polecenia go get.

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

Ostrzeżenie

Ciąg Azure w adresie URL musi zaczynać się wielką literą. W przeciwnym razie podczas pracy z zestawem SDK mogą wystąpić problemy związane z wielkością liter. Ciąg Azure musi zaczynać się wielką literą także w Twoich instrukcjach importu.

Niektóre usługi platformy Azure mają własne zestawy SDK dla języka Go, których nie ma w podstawowym pakiecie zestawu Azure SDK dla języka Go. W poniższej tabeli wymieniono usługi z własnymi zestawami SDK i ich nazwy pakietów. Wszystkie te pakiety są uważane za będące w wersji zapoznawczej.

Service Pakiet
Blob Storage github.com/Azure/azure-storage-blob-go
File Storage github.com/Azure/azure-storage-file-go
Kolejka magazynu github.com/Azure/azure-storage-queue-go
Centrum zdarzeń usługi Event Hubs github.com/Azure/azure-event-hubs-go
Service Bus github.com/Azure/azure-service-bus-go

Zapewnianie zasobów zestawu Azure SDK dla języka Go

Zestaw Azure SDK dla języka Go umożliwia zapewnianie zasobów za pośrednictwem narzędzia dep. Ze względu na stabilność zapewnianie zasobów jest zalecane. Aby użyć narzędzia dep we własnym projekcie, dodaj element github.com/Azure/azure-sdk-for-go do sekcji [[constraint]] Twojego pliku Gopkg.toml. Aby na przykład zapewnić zasoby z wersji 14.0.0, dodaj następujący wpis:

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

Uwzględnianie w projekcie zestawu Azure SDK dla języka Go

Aby zapewnić możliwość korzystania z usług platformy Azure z poziomu kodu Go, zaimportuj wszystkie usługi, z którymi wchodzisz w interakcje, a także wymagane moduły autorest. Pełną listę dostępnych modułów można uzyskać w dokumentacji GoDoc dotyczącej dostępnych usług i pakietów AutoRest. Najpopularniejsze pakiety z elementu go-autorest, których potrzebujesz, to:

Pakiet opis
github.com/Azure/go-autorest/autorest Obiekty zapewniające obsługę uwierzytelniania klientów w usłudze
github.com/Azure/go-autorest/autorest/azure Stałe zapewniające interakcje z usługami platformy Azure
github.com/Azure/go-autorest/autorest/adal Mechanizmy uwierzytelniania dostępu do usług platformy Azure
github.com/Azure/go-autorest/autorest/to Pomocnicy asercji typów ułatwiający pracę ze strukturami danych zestawu Azure SDK

Wersje pakietów języka Go i usług platformy Azure są określane niezależnie. Wersje usługi są częścią ścieżki importu modułu — za modułem services. Pełna ścieżka modułu obejmuje kolejno nazwę usługi, wersję w formacie YYYY-MM-DD i ponownie nazwę usługi. Przykład importu wersji 2017-03-30 usługi Compute:

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

Zaleca się użycie najnowszej wersji usługi w momencie rozpoczęcia programowania i stosowanie jej spójnie. Wymagania dotyczące usług mogą zmieniać się w zależności od wersji, co może uszkodzić kod, nawet jeśli nie zostaną zainstalowane żadne aktualizacje zestawu SDK dla języka Go w tym czasie.

Jeśli jest potrzebna zbiorcza migawka usług, możesz również wybrać jedną wersję profilu. Obecnie jedynym zablokowanym profilem jest wersja 2017-03-09, która może nie obejmować najnowszych funkcji usługi. Profile znajdują się w module profiles i mają wersję w formacie YYYY-MM-DD. Usługi są podzielone na grupy według wersji profilu. Aby na przykład zaimportować moduł zarządzania zasobami platformy Azure z profilu 2017-03-09:

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

Ostrzeżenie

Dostępne są także profile preview i latest. Ich użycie nie jest zalecane. Te profile są wersjami ruchomymi, co znaczy, że zachowanie usługi może w dowolnym momencie ulec zmianie.

Następne kroki

Aby rozpocząć korzystanie z zestawu Azure SDK dla języka Go, wypróbuj szybki start.

Jeśli chcesz od razu rozpocząć pracę z innymi usługami w zestawie SDK dla języka Go, przyjrzyj się udostępnionym przykładom kodu.