Uso de perfiles de versión de API con Go en Azure Stack Hub

Perfiles de go y versión

Un perfil es una combinación de diferentes tipos de recursos con diferentes versiones de diferentes servicios. El uso de un perfil le ayuda a mezclar y coincidir entre distintos tipos de recursos. Los perfiles pueden proporcionar las siguientes ventajas:

• Estabilidad de la aplicación bloqueando las versiones específicas de la API.
• Compatibilidad con la aplicación con Azure Stack Hub y centros de datos regionales de Azure.

En el SDK de Go, los perfiles están disponibles en la ruta de acceso de perfiles. Los números de versión del perfil se etiquetan en el formato AAAA-MM-DD . Por ejemplo, la versión 2020-09-01 del perfil de API de Azure Stack Hub es para las versiones 2102 o posteriores de Azure Stack Hub. Para importar un servicio determinado desde un perfil, importe su módulo correspondiente desde el perfil. Por ejemplo, para importar el servicio Compute desde el perfil 2020-09-01 , use el código siguiente:

import "github.com/Azure/azure-sdk-for-go/profiles/2020-09-01/compute/mgmt/compute"

Instalación del SDK de Azure para Go

1. Instale Git. Consulte Introducción a la instalación de Git.
2. Instale Go. Los perfiles de API para Azure requieren go versión 1.9 o posterior. Consulte Lenguaje de programación Go.

Perfiles

Para usar otro perfil o versión del SDK, sustituya la fecha en una instrucción import como github.com/Azure/azure-sdk-for-go/profiles/<date>/storage/mgmt/storage. Por ejemplo, para la versión 2008, el perfil es 2019-03-01y la cadena se convierte en github.com/Azure/azure-sdk-for-go/profiles/2019-03-01/storage/mgmt/storage. Tenga en cuenta que, a veces, el equipo del SDK cambia el nombre de los paquetes, por lo que es posible que no funcione simplemente la fecha de una cadena con una fecha diferente. Consulte la tabla siguiente para obtener una asociación de perfiles y versiones de Azure Stack.

Para más información sobre los perfiles de API y Azure Stack Hub, consulte resumen de perfiles de API.

Consulte Perfiles del SDK de Go.

Suscripción

Si aún no tiene una suscripción, cree una suscripción y guarde el identificador de suscripción que se usará más adelante. Para obtener información sobre cómo crear una suscripción, consulte este documento.

Principal de servicio

Se debe crear y guardar en algún lugar una entidad de servicio y su información de entorno asociada. Se recomienda la entidad de servicio con owner rol, pero dependiendo del ejemplo, un contributor rol puede ser suficiente. Consulte el archivo Léame en el repositorio de ejemplo para conocer los valores necesarios. Puede leer estos valores en cualquier formato compatible con el lenguaje sdk, como desde un archivo JSON (que usan nuestros ejemplos). En función de la ejecución del ejemplo, no se pueden usar todos estos valores. Consulte el repositorio de ejemplo para obtener código de ejemplo actualizado o más información.

Id. de inquilino

Para buscar el directorio o el identificador de inquilino de Azure Stack Hub, siga las instrucciones de este artículo.

Registro de proveedores de recursos

Registre los proveedores de recursos necesarios siguiendo este documento. Estos proveedores de recursos serán necesarios en función de los ejemplos que quiera ejecutar. Por ejemplo, si desea ejecutar un ejemplo de máquina virtual, se requiere el registro del Microsoft.Compute proveedor de recursos.

Punto de conexión de Resource Manager de Azure Stack

Azure Resource Manager (ARM) es un marco de administración que permite a los administradores implementar, administrar y supervisar recursos de Azure. Azure Resource Manager puede controlar estas tareas como un grupo, en lugar de individualmente, en una sola operación. Puede obtener la información de metadatos del punto de conexión de Resource Manager. El punto de conexión devuelve un archivo JSON con la información necesaria para ejecutar el código.

• ResourceManagerEndpointUrl en el Kit de desarrollo de Azure Stack (ASDK) es: https://management.local.azurestack.external/.
• ResourceManagerEndpointUrl en sistemas integrados es: https://management.region.<fqdn>/, donde <fqdn> es el nombre de dominio completo.
• Para recuperar los metadatos necesarios: <ResourceManagerUrl>/metadata/endpoints?api-version=1.0. Para ver las versiones de API disponibles, consulte Especificaciones de api rest de Azure. Por ejemplo, en 2020-09-01 la versión del perfil, puede cambiar a api-version2019-10-01 para el proveedor microsoft.resourcesde recursos .

JSON de ejemplo:

{
   "galleryEndpoint": "https://portal.local.azurestack.external:30015/",
   "graphEndpoint": "https://graph.windows.net/",
   "portal Endpoint": "https://portal.local.azurestack.external/",
   "authentication": 
      {
         "loginEndpoint": "https://login.windows.net/",
         "audiences": ["https://management.yourtenant.onmicrosoft.com/3cc5febd-e4b7-4a85-a2ed-1d730e2f5928"]
      }
}

Muestras

Consulte el repositorio de ejemplo para obtener código de ejemplo de actualización a fecha. La raíz README.md describe los requisitos generales y cada subdirectorio contiene un ejemplo específico con su propio README.md modo de ejecutar ese ejemplo.

Pasos siguientes

Más información sobre los perfiles de API:

• Administración de perfiles de la versión de API en Azure Stack Hub
• Versiones de API del proveedor de recursos compatibles con perfiles