Menginstal SDK Azure untuk Go

  • Artikel

Selamat datang di SDK Azure untuk Go! SDK memungkinkan Anda mengelola dan berinteraksi dengan layanan Azure dari aplikasi Go Anda.

Mendapatkan SDK Azure untuk Go

SDK Azure untuk Go kompatibel dengan Go versi 1.8 dan yang lebih tinggi. Untuk lingkungan yang menggunakan Profil Azure Stack, Go versi 1.9 adalah persyaratan minimum. Jika Anda perlu menginstal Go, ikuti petunjuk penginstalan Go.

Anda dapat mengunduh SDK Azure untuk Go dan dependensinya melalui go get.

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

Peringatan

Pastikan Anda menggunakan huruf besar untuk Azure di URL. Bila tidak dapat menyebabkan masalah impor terkait-jenis huruf saat bekerja dengan SDK. Azure juga perlu menggunakan huruf besar di pernyataan impor Anda.

Beberapa layanan Azure memiliki SDK Go sendiri dan tidak termasuk dalam paket inti SDK Azure untuk Go. Tabel berikut mencantumkan layanan dengan SDK sendiri dan nama paket mereka. Paket-paket ini semuanya dianggap dalam pratinjau.

Service Paket
Penyimpanan Blob github.com/Azure/azure-storage-blob-go
Penyimpanan File github.com/Azure/azure-storage-file-go
Antrean Penyimpanan github.com/Azure/azure-storage-queue-go
Pusat Aktivitas github.com/Azure/azure-event-hubs-go
Bus Layanan github.com/Azure/azure-service-bus-go

Menjual SDK Azure untuk Go

Azure SDK untuk Go dapat dijual melalui dep. Untuk alasan stabilitas, penjualan disarankan. Untuk menggunakan dep dalam proyek Anda sendiri, tambahkan github.com/Azure/azure-sdk-for-go ke bagian [[constraint]] dari proyek Anda Gopkg.toml. Misalnya, untuk menjual pada versi 14.0.0, tambahkan entri berikut:

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

Menyertakan SDK Azure untuk Go di proyek Anda

Untuk menggunakan layanan Azure dari kode Go Anda, impor layanan apa pun yang berinteraksi dengan Anda dan modul autorest yang diperlukan. Anda mendapatkan daftar lengkap modul yang tersedia dari GoDoc untuk layanan yang tersedia dan paket AutoRest. Paket paling umum yang Anda butuhkan dari go-autorest adalah:

Paket Deskripsi
github.com/Azure/go-autorest/autorest Objek untuk menangani autentikasi klien layanan
github.com/Azure/go-autorest/autorest/azure Konstanta untuk interaksi dengan layanan Azure
github.com/Azure/go-autorest/autorest/adal Mekanisme autentikasi untuk mengakses layanan Azure
github.com/Azure/go-autorest/autorest/to Ketik pembantu pernyataan untuk bekerja dengan struktur data SDK Azure

Paket Go dan layanan Azure di-versikan secara independen. Versi layanan adalah bagian dari jalur impor modul, di bawah modul services. Jalur lengkap untuk modul ini adalah nama layanan, diikuti oleh versinya dalam format YYYY-MM-DD, diikuti oleh nama layanan lagi. Misalnya, untuk mengimpor versi 2017-03-30 layanan Komputasi:

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

Disarankan agar Anda menggunakan versi terbaru dari layanan saat memulai pengembangan dan menjaganya tetap konsisten. Persyaratan layanan dapat berubah di antara versi yang dapat merusak kode Anda, bahkan jika tidak ada pembaruan SDK Go selama waktu tersebut.

Jika Anda memerlukan snapshot layanan kolektif, Anda juga dapat memilih satu versi profil. Saat ini, satu-satunya profil yang terkunci adalah versi 2017-03-09, yang mungkin tidak memiliki fitur layanan terbaru. Profil berada di bawah modul profiles, dengan versi mereka dalam format YYYY-MM-DD. Layanan dikelompokkan di bawah versi profil mereka. Misalnya, untuk mengimpor modul manajemen Azure Resources dari profil 2017-03-09:

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

Peringatan

Ada juga profil preview dan latest yang tersedia. Menggunakannya tidak dianjurkan. Profil ini adalah versi bergulir dan perilaku layanan dapat berubah setiap saat.

Langkah berikutnya

Untuk mulai menggunakan SDK Azure untuk Go, coba mulai cepat.

Jika Anda ingin segera memulai dengan layanan lain di SDK Go segera, lihat beberapa kode sampel yang tersedia.