Installer le kit de développement logiciel Microsoft Azure SDK pour Go

  • Article

Bienvenue dans le kit de développement logiciel Microsoft Azure SDK pour Go ! Le kit de développement logiciel (SDK) vous permet de gérer et d’interagir avec les services Azure à partir de vos applications Go.

Obtenir le kit de développement logiciel Microsoft Azure SDK pour Go

Azure SDK pour Go est compatible avec les versions 1.8 et ultérieures de Go. Pour les environnements utilisant des profils Azure Stack, la version 1.9 de Go est la configuration minimale requise. Si vous devez installer Go, suivez les instructions d’installation de Go.

Vous pouvez télécharger Azure SDK pour Go et ses dépendances via go get.

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

Avertissement

Assurez-vous de mettre Azure en majuscules dans l’URL. Procéder autrement peut entraîner des problèmes d’importation liés à la casse lorsque vous travaillez avec le kit de développement logiciel (SDK). Vous devez également mettre Azure en majuscules dans vos instructions d’importation.

Certains services Azure ont leurs propres Kitw de développement logiciel (SDK) et ne sont pas inclus dans le Kit de développement logiciel Azure de base pour le package Go. Le tableau suivant répertorie les services disposant de leurs propres Kits de développement logiciel (SDK) et noms de package. Ces packages sont tous considérés comme étant en préversion.

Service Package
Stockage Blob github.com/Azure/azure-storage-blob-go
Stockage Fichier github.com/Azure/azure-storage-file-go
File d’attente de stockage 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

Fournir le kit de développement logiciel (SDK) Azure pour Go

Le kit de développement logiciel Microsoft Azure SDK pour Go peut être fourni via dep. Pour des raisons de stabilité, le vendoring est recommandé. Pour utiliser dep dans votre projet, ajoutez github.com/Azure/azure-sdk-for-go à une section [[constraint]] de votre élément Gopkg.toml. Par exemple, pour fournir la version 14.0.0, ajoutez l’entrée suivante :

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

Inclure le kit de développement logiciel (SDK) Azure pour Go dans votre projet

Pour utiliser les Services Azure à partir de votre code Go, importer tous les services avec lesquels vous interagissez et les modules autorest requis. Vous obtenez une liste complète des modules disponibles à partir de GoDoc pour les services disponibles et les packages AutoRest. Les packages courants que vous devez obtenir de go-autorest sont :

Package Description
github.com/Azure/go-autorest/autorest Objets pour la gestion de l’authentification client du service
github.com/Azure/go-autorest/autorest/azure Constantes pour les interactions avec les Services Azure
github.com/Azure/go-autorest/autorest/adal Mécanismes d’authentification pour l’accès aux Services Azure
github.com/Azure/go-autorest/autorest/to Programmes d’assistance d’assertion de type pour l’utilisation des structures de données du kit de développement logiciel (SDK) Azure

Les versions des packages Go et des services Azure sont gérées de façon indépendante. Les versions du service font partie du chemin d’accès d’importation du module, en dessous du module services. Le chemin d’accès complet du module est constitué du nom du service, suivi par la version au format YYYY-MM-DD, suivi à nouveau du nom du service. Par exemple, pour importer la version 2017-03-30 du service Compute :

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

Il est recommandé d’utiliser la dernière version d’un service au début du développement et d’assurer en permanence sa cohérence. Les exigences relatives au service peuvent varier entre des versions qui peuvent interrompre votre code, même si aucune mise à jour du Kit de développement logiciel (SDK) Go n’est disponible pendant cette période.

Si vous avez besoin d’un instantané collectif des services, vous pouvez également sélectionner une version de profil unique. Actuellement, le seul profil verrouillé est la version 2017-03-09, qui ne dispose peut-être pas des fonctionnalités les plus récentes des services. Les profils sont situés sous le module profiles, avec leur version au format YYYY-MM-DD. Les services sont regroupées sous leur version de profil. Par exemple, pour importer le module de Gestion des ressources Azure à partir du profil 2017-03-09 :

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

Avertissement

Les profils preview et latest sont également disponibles. Leur utilisation n’est pas recommandée. Ces profils sont des versions continues et le comportement du service peut changer à tout moment.

Étapes suivantes

Pour commencer à utiliser le kit de développement logiciel Microsoft Azure SDK pour Go, essayez un démarrage rapide.

Si vous souhaitez débuter immédiatement avec d’autres services dans le kit de développement logiciel (SDK) Go, examinez les exemples de code disponibles.