Go için Azure SDK’yı yükleme

  • Makale

Go için Azure SDK’ya hoş geldiniz! Bu SDK, Go uygulamalarınızdan Azure hizmetlerini yönetmenize ve bu hizmetlerle etkileşim kurmanıza olanak sağlar.

Go için Azure SDK’yı edinin

Go için Azure SDK, Go 1.8 ve sonraki sürümlerle uyumludur. Azure Stack Profilleri kullanan ortamlar için en az Go 1.9 sürümü gerekir. Go'yu yüklemeniz gerekiyorsa Go yükleme yönergelerini izleyin.

Go için Azure SDK ve bağımlılıklarını go get üzerinden indirebilirsiniz.

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

Uyarı

URL’de Azure kısmını büyük harfle yazdığınızdan emin olun. Aksi takdirde bu, SDK ile çalışırken büyük/küçük harfle ilgili içeri aktarma sorunlarına neden olabilir. İçeri aktarma deyimlerinizde de Azure kısmını büyük harfle yazmanız gerekir.

Bazı Azure hizmetlerinin kendi Go SDK’sı bulunur ve bu hizmetler Go için Azure SDK’sı çekirdek paketinde yer almaz. Aşağıdaki tabloda kendi SDK’larına ve paket adlarına sahip hizmetler listelenir. Bu paketlerinin tamamının önizlemede olduğu kabul edilir.

Service Paket
Blob Depolama github.com/Azure/azure-storage-blob-go
Dosya Depolama github.com/Azure/azure-storage-file-go
Depolama Kuyruğu github.com/Azure/azure-storage-queue-go
Olay Hub'ı github.com/Azure/azure-event-hubs-go
Service Bus github.com/Azure/azure-service-bus-go

Go için Azure SDK’yı satıcı dizinine taşıma

Go için Azure SDK, dep üzerinden satıcı dizinine taşınabilir. Kararlılık nedeniyle satıcı dizinine taşınması önerilir. Projenizde dep kullanmak için github.com/Azure/azure-sdk-for-go nesnesini Gopkg.toml öğenizdeki [[constraint]] bölümlerinden birine ekleyin. Örneğin, 14.0.0 sürümünde satıcı dizinine taşımak için şu girişi ekleyin:

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

Projenize Go için Azure SDK’yı dahil etme

Go kodunuzdan Azure hizmetlerini kullanmak için, etkileşim kurduğunuz hizmetleri ve gerekli autorest modüllerini içeri aktarın. AutoRest paketleri ve kullanılabilir hizmetler için GoDoc’tan kullanılabilir modüllerin tam listesini alın. go-autorest içinde ihtiyaç duyduğunuz en yaygın paketler:

Paket Açıklama
github.com/Azure/go-autorest/autorest Hizmet istemcisi kimlik doğrulamasını işlemek için nesneler
github.com/Azure/go-autorest/autorest/azure Azure hizmetleri ile etkileşim için sabitler
github.com/Azure/go-autorest/autorest/adal Azure hizmetlerine erişmek için kimlik doğrulaması mekanizmaları
github.com/Azure/go-autorest/autorest/to Azure SDK veri yapıları ile çalışmaya ilişkin tür onaylama yardımcıları

Go paketlerinin ve Azure hizmetlerinin sürümleri ayrı tutulur. Hizmet sürümleri services modülünün altında bulunan modül içeri aktarma yolunun bir parçasıdır. Modülün tam yolu, hizmetin adını takip eden YYYY-MM-DD biçiminde sürüm ve tekrar hizmet adından oluşur. Örneğin, İşlem hizmetinin 2017-03-30 sürümünü içeri aktarmak için:

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

Geliştirmeye başlarken hizmetin son sürümünü kullanmanız ve tutarlılık sağlamanız önerilir. Sürümler arasında ortaya çıkan hizmet gereksinimi değişiklikleri Go SDK güncelleştirmesi olmasa da kodunuzda hataya neden olabilir.

Hizmetlerin toplu bir anlık görüntüsüne ihtiyacınız varsa tek bir profil sürümünü de seçebilirsiniz. Şu anda tek kilitli profil olan 2017-03-09 sürümü, hizmetin en son özelliklerini içermeyebilir. Profiller, profiles modülünün altında bulunur ve sürümü YYYY-MM-DD biçimindedir. Hizmetler, kendi profil sürümleri altında gruplanır. Örneğin, 2017-03-09 profilinden Azure Kaynakları yönetim modülünü içeri aktarmak için:

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

Uyarı

preview ve latest profilleri de kullanılabilir. Bunların kullanılması önerilmez. Bu profiller, sıralı sürümlerdir ve hizmet davranışı herhangi bir anda değişebilir.

Sonraki adımlar

Go için Azure SDK’yı kullanmaya başlamak için hızlı başlangıcı deneyin.

Go SDK’daki diğer hizmetleri hemen kullanmaya başlamak isterseniz kullanılabilir örnek kodlardan bazılarına göz atın.