Instalación del SDK de Azure para Go

Le damos la bienvenida al SDK de Azure para Go El SDK permite administrar los servicios de Azure desde las aplicaciones de Go, e interactuar con ellos.

Obtención del SDK de Azure para Go

Azure SDK para Go es compatible con las versiones de Go 1.8 y posteriores. Para entornos con perfiles de Azure Stack, la versión 1.9 de Go es el requisito mínimo. Si tiene que instalar Go, siga las instrucciones de instalación de Go.

Puede descargar Azure SDK para Go y sus dependencias en go get.

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

Advertencia

Asegúrese de escribir en mayúsculas Azure en la dirección URL. De lo contrario puede causar problemas de importación relacionados con las mayúsculas y minúsculas cuando se trabaja con el SDK. También debe escribir en mayúscula Azure en las instrucciones de importación.

Algunos servicios de Azure tienen sus propios SDK de Go y no se incluyen en el paquete principal del SDK de Azure para Go. En la tabla siguiente se enumeran los servicios que tienen sus propios SDK, y sus nombres de paquete. Todos estos paquetes están en versión preliminar.

Servicio Paquete
Blob Storage github.com/Azure/azure-storage-blob-go
File Storage github.com/Azure/azure-storage-file-go
Storage Queue github.com/Azure/azure-storage-queue-go
Centro de eventos github.com/Azure/azure-event-hubs-go
Service Bus github.com/Azure/azure-service-bus-go

Inclusión del SDK de Azure para Go en la carpeta vendor

Los archivos dependientes se pueden incluir en la carpeta vendor del SDK de Azure para Go con dep. Por motivos de estabilidad, se recomienda incluir los archivos dependientes en la carpeta vendor. Para usar dep en su propio proyecto, agregue github.com/Azure/azure-sdk-for-go a una sección [[constraint]] de su Gopkg.toml. Por ejemplo, para incluir en la carpeta vendor los archivos dependientes de la versión 14.0.0, agregue la entrada siguiente:

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

Inclusión del SDK de Azure para Go en el proyecto

Para usar los servicios de Azure desde el código de Go, importe todos los servicios con lo que interactúa y los módulos autorest necesarios. Puede obtener una lista completa de los módulos disponibles en GoDoc para los servicios disponibles y los paquetes de AutoRest. Los paquetes más comunes que necesita de go-autorest son:

Paquete Descripción
github.com/Azure/go-autorest/autorest Objetos para el control de la autenticación del cliente del servicio
github.com/Azure/go-autorest/autorest/azure Constantes para las interacciones con los servicios de Azure
github.com/Azure/go-autorest/autorest/adal Mecanismos de autenticación para el acceso a los servicios de Azure
github.com/Azure/go-autorest/autorest/to Asistentes de aserción de tipos para trabajar con las estructuras de datos del SDK de Azure

Las versiones de los paquetes de Go y los servicios de Azure son independientes. Las versiones de los servicios son parte de la ruta de importación del módulo, en el módulo services. La ruta de acceso completa del módulo es el nombre del servicio, seguido de la versión en formato YYYY-MM-DD y seguido del nombre de servicio de nuevo. Por ejemplo, para importar la versión 2017-03-30 del servicio Compute:

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

Se recomienda usar la versión más reciente de un servicio al comenzar a desarrollar y mantener la coherencia. Los requisitos del servicio pueden cambiar de una versión a otra y estos cambios podrían afectar al código, aunque no haya ninguna actualización de Azure SDK para Go durante ese tiempo.

Si necesita una instantánea colectiva de los servicios, también puede seleccionar una versión de perfil único. En este momento, el único perfil bloqueado es la versión 2017-03-09, que puede no tener las características más recientes de los servicios. Los perfiles se encuentran en el módulo profiles, con la versión en formato YYYY-MM-DD. Los servicios se agrupan bajo su versión de perfil. Por ejemplo, para importar el módulo de administración de recursos de Azure desde el perfil 2017-03-09:

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

Advertencia

También están disponibles los perfiles preview y latest. No se recomienda su uso. Estos perfiles son las sucesivas versiones y el comportamiento del servicio puede cambiar en cualquier momento.

Pasos siguientes

Para empezar a usar el SDK de Azure para Go, pruebe un inicio rápido.

Si desea empezar a trabajar con otros servicios del SDK para Go inmediatamente, eche un vistazo a algunos de los ejemplos de código disponibles.