Descarga de elementos de Marketplace en Azure Stack Hub

  • Artículo

Los operadores en la nube pueden descargar elementos de Marketplace en Azure Stack Hub y hacer que estén disponibles para todos los usuarios mediante el entorno de Azure Stack Hub. Dichos elementos se pueden elegir de una lista de elementos de Azure Marketplace que se han probados con anterioridad y se sabe que son compatibles con Azure Stack Hub. Con frecuencia se agregan nuevos elementos a esta lista, así que es aconsejable consultar periódicamente si tiene contenido nuevo.

Existen dos escenarios para descargar productos de Marketplace:

  • Escenario sin conexión o con conexión parcial: requiere que se acceda a Internet mediante la herramienta de redifusión de Marketplace para descargar los elementos de este. Después, los elementos descargados se transfieren a la instalación desconectada de Azure Stack Hub. Este escenario usa PowerShell.
  • Escenario conectado: requiere que el entorno de Azure Stack Hub esté conectado a Internet. El portal de administración de Azure Stack Hub se usa para buscar y descargar elementos.

Consulte Elementos de Azure Marketplace disponibles para Azure Stack Hub para encontrar una lista completa de los elementos de Marketplace que se pueden descargar. Consulte el artículo Cambios en Marketplace de Azure Stack Hub para ver una lista de adiciones, eliminaciones y actualizaciones recientes en Marketplace de Azure Stack Hub.

Nota

El catálogo será diferente en función de la nube a la que esté conectado el sistema de Azure Stack Hub. El entorno de nube viene determinado por la suscripción de Azure que se usa para registrar la instancia de Azure Stack Hub.

Nota:

También puede usar la estación de trabajo de acceso del operador (OAW) para acceder al punto de conexión con privilegios (PEP), al portal de administración para escenarios de soporte técnico y a herramientas de GitHub para Azure Stack Hub. Para más información, consulte Estación de trabajo de acceso del operador de Azure Stack Hub.

Una implementación con conexión le permite usar el portal de administración para descargar elementos de Marketplace.

Prerrequisitos

La implementación de Azure Stack Hub debe tener conectividad a Internet y estar registrada en Azure.

Uso del portal para descargar elementos de Marketplace

  1. Inicie sesión en el portal de administración de Azure Stack Hub.

  2. Antes de empezar a descargar elementos de Marketplace vea el espacio de almacenamiento que tiene disponible. Después, cuando seleccione los elementos que desea descargar, puede comparar el tamaño de la descarga con la capacidad de almacenamiento disponible. Si hay un límite de capacidad, considere distintas opciones para administrar el espacio disponible.

    Para examinar el espacio disponible, en Region management (Administración de regiones), seleccione la región que desea explorar y vaya a Resource ProvidersStorage (Proveedores de recursos > Almacenamiento):

    Revisión del espacio de almacenamiento en el portal del administrador de Azure Stack Hub

  3. Abra Marketplace de Azure Stack Hub y conéctese a Azure. Para ello, seleccione el servicio Marketplace management (Administración de Marketplace), elija Elementos de Marketplace y, por último, seleccione Add from Azure (Agregar desde Azure):

    Descarga de elementos de Marketplace desde Azure

  4. Cada elemento de línea también muestra la versión disponible actualmente. Si hay más de una versión de un elemento de Marketplace disponible, la columna Version (Versión) muestra Multiple (Múltiples). Puede hacer clic en cada elemento para ver su descripción, así como información adicional, incluido su tamaño de descarga:

    Captura de pantalla que muestra las versiones disponibles de un elemento de Marketplace.

  5. Si la versión de un elemento se muestra como Multiple (Múltiples), puede seleccionar ese elemento y, a continuación, elegir una versión específica en la lista desplegable de selección de versión que aparece. Tenga en cuenta que Microsoft ahora puede agregar atributos para impedir que los administradores descarguen productos de Marketplace que no son compatibles con sus instancias de Azure Stack, mediante diversas propiedades como la versión de Azure Stack o el modelo de facturación. Solo Microsoft puede agregar estos atributos:

    Adición desde Azure

  6. Seleccione el elemento que desee y, después, seleccione Download (Descargar). Los tiempos de descarga varían y dependen de la conectividad de red. Una vez finalizada la descarga, el nuevo elemento de Marketplace se puede implementar como usuario u operador de Azure Stack Hub.

  7. Para implementar el elemento descargado, seleccione +Crear un recurso y busque el nuevo elemento de Marketplace entre las distintas categorías. Luego, seleccione el elemento para comenzar el proceso de implementación. El proceso no es el mismo para todos los artículos de Marketplace.

Si Azure Stack Hub tiene poca conectividad a Internet o ninguna, use PowerShell y la herramienta de redifusión de Marketplace para descargar los elementos de Marketplace en una máquina que sí disponga de conectividad. Luego, transfiera los elementos al entorno de Azure Stack Hub. En un entorno sin conexión, no se pueden descargar elementos de Marketplace desde el portal de Azure Stack Hub.

La herramienta de redifusión de Marketplace también se puede usar en un escenario con conexión.

Este escenario tiene dos partes:

  • Parte 1: descarga de elementos de Marketplace. En el equipo con acceso a Internet, configure PowerShell, descargue la herramienta de redifusión y, después, descargue los elementos desde Azure Marketplace.
  • Parte 2: carga y publicación en Marketplace de Azure Stack Hub. Mueva los archivos que ha descargado a su entorno de Azure Stack Hub y, después, publíquelos en Marketplace de Azure Stack Hub.

Prerrequisitos

  • Un entorno conectado (no tiene que ser Azure Stack Hub). Necesita conectividad para obtener la lista de productos de Azure con sus detalles y descargar todo localmente. Una vez hecho esto, el resto del procedimiento no requiere ninguna conectividad a Internet. Crea un catálogo de elementos que se han descargado previamente para su uso en el entorno desconectado.

  • Medios extraíbles para conectarse al entorno desconectado y transferir todos los artefactos necesarios.

  • Un entorno de Azure Stack Hub desconectado con los siguientes requisitos previos:

Descargue el módulo Azs.Syndication.Admin de la Galería de PowerShell mediante el comando siguiente:

Install-Module -Name Azs.Syndication.Admin

Install-Module -Name Azs.Syndication.Admin -RequiredVersion 0.1.154-preview -AllowPrerelease

Una vez registrado Azure Stack, puede ignorar el mensaje siguiente que aparece en la hoja de administración de Marketplace, ya que no es aplicable en un caso de uso sin conexión:

Administración de Marketplace

Uso de la herramienta de redifusión de Marketplace para descargar elementos de Marketplace

Asegúrese de descargar la herramienta de redifusión de Marketplace cada vez que descargue elementos de Marketplace en un escenario desconectado. Se realizan cambios frecuentes en esta herramienta y se debe usar la versión más reciente en cada descarga.

Importante

Se recomienda usar módulos Az en lugar de AzureRM. Vea los ejemplos siguientes:

  1. En un equipo con conexión a Internet, abra una consola de PowerShell como administrador.

  2. Inicie sesión en la nube de Azure adecuada y en el inquilino de Azure AD con la cuenta de Azure que ha usado para registrar Azure Stack Hub. Para agregar la cuenta, en PowerShell ejecute Connect-AzAccount:

    Connect-AzAccount -Environment AzureCloud -Tenant '<mydirectory>.onmicrosoft.com'

    Se le solicita que escriba las credenciales de su cuenta de Azure y puede que tenga que utilizar la autenticación en dos fases en función de la configuración de la cuenta.

    Nota:

    Si la sesión expira, la contraseña ha cambiado o desea cambiar de cuenta, ejecute el siguiente cmdlet antes de iniciar sesión mediante Connect-AzAccount: Remove-AzAccount -Scope Process.

  3. Si tiene varias suscripciones, ejecute el siguiente comando para seleccionar la que ha usado para el registro:

    Get-AzSubscription -SubscriptionID 'Your Azure Subscription GUID' | Select-AzSubscription

  4. Si aún no lo ha hecho en el paso de requisitos previos, descargue la versión más reciente de la herramienta de redifusión de Marketplace si utiliza la versión más reciente de Azure Stack Hub:

Install-Module -Name Azs.Syndication.Admin

Install-Module -Name Azs.Syndication.Admin -RequiredVersion 0.1.154-preview -AllowPrerelease

  1. Para seleccionar elementos de Marketplace como imágenes de máquinas virtuales, extensiones o plantillas de soluciones para descargar, ejecute el siguiente comando:

    $products = Select-AzsMarketplaceItem

    Esto hará que aparezca una tabla que muestra todos los registros de Azure Stack disponibles en la suscripción seleccionada. Elija el registro que coincida con el entorno de Azure Stack para el que está descargando los elementos de Marketplace y seleccione Aceptar.

    Captura de pantalla que muestra una lista de todos los registros de Azure Stack disponibles en la suscripción seleccionada.

    Ahora debería ver una segunda tabla en la que se enumeran todos los elementos de Marketplace que están disponibles para su descarga. Seleccione el elemento que desea descargar y tome nota de la versión. Puede mantener presionada la tecla Ctrl para seleccionar varias imágenes. Captura de pantalla que muestra otra lista de todos los registros de Azure Stack disponibles en la suscripción seleccionada.

    También puede filtrar la lista de imágenes mediante la opción Agregar criterios. Selección de registros de Azure Stack

    Cuando termine las selecciones, seleccione Aceptar.

  2. Los identificadores de los elementos de Marketplace que ha seleccionado para su descarga se guardan en la variable $products. Use el comando siguiente para empezar a descargar los elementos seleccionados. Reemplace la ruta de acceso de la carpeta de destino por una ubicación para almacenar los archivos que descargue desde Azure Marketplace:

    $products | Export-AzsMarketplaceItem  -RepositoryDir "Destination folder path in quotes"

  3. El tiempo que tarda la descarga depende del tamaño del elemento. Una vez que se completa la descarga, el elemento está disponible en la carpeta que se especificó en el script. La descarga incluye un archivo VHD (para máquinas virtuales) o un archivo .zip (para extensiones de máquina virtual y proveedores de recursos). También puede incluir un paquete de galería en el formato .azpkg, que es un archivo .zip.

  4. Si se produce un error en la descarga, puede intentarlo de nuevo volviendo a ejecutar el siguiente cmdlet de PowerShell:

    $products | Export-AzsMarketplaceItem  -RepositoryDir "Destination folder path in quotes"

  5. También debe exportar el módulo Azs.Syndication.Admin de forma local para que pueda copiarlo en la máquina desde la que va a importar los elementos de Marketplace hacia Azure Stack Hub.

    Nota:

    La carpeta de destino para la exportación de este módulo debe ser diferente de la ubicación a la que ha exportado los elementos de Marketplace.

    Save-Package -ProviderName NuGet -Source https://www.powershellgallery.com/api/v2 -Name Azs.Syndication.Admin -Path "Destination folder path in quotes" -Force

Importación de la descarga y publicación en Marketplace de Azure Stack Hub con PowerShell

  1. Debe mover los archivos que descargó anteriormente de forma local a una máquina que tenga conexión al entorno de Azure Stack Hub. La herramienta de redifusión de Marketplace debe estar disponible también en su entorno de Azure Stack Hub, ya que necesita usarla para realizar la operación de importación.

    En la siguiente imagen muestra un ejemplo de estructura de carpeta. D:\downloadfolder contiene todos los elementos de Marketplace descargados. Cada subcarpeta es un elemento de Marketplace (por ejemplo, microsoft.custom-script-linux-arm-2.0.3) y tienen como nombre el identificador del producto. Dentro de cada subcarpeta se encuentra el contenido descargado del elemento de Marketplace.

    Estructura de directorios de descarga de Marketplace

  2. Siga las instrucciones que se indican en Conexión a Azure Stack Hub con PowerShell para configurar la sesión de PowerShell del operador de Azure Stack Hub.

  3. Inicie sesión en Azure Stack Hub con una identidad que tenga acceso de propietario a la suscripción de proveedor predeterminada.

  4. Copie el nombre de la carpeta; por ejemplo, microsoft.dsc-arm-2.77.0 y cree una carpeta con ese nombre.

  5. Mueva la carpeta descargada a esa carpeta. En este momento, tiene C:\microsoft.dsc-arm-2.77.0\microsoft.dsc-arm-2.77.0\original-sub-folders-are-here y C:\microsoft.dsc-arm-2.77.0\microsoft.dsc-arm-2.77.0\productDetails.json.

  6. Importe el módulo de redifusión e inicie la herramienta de redifusión de Marketplace mediante la ejecución del siguiente cmdlet:

    Import-AzsMarketplaceItem -RepositoryDir "C:\microsoft.dsc-arm-2.77.0"

  7. Después de que el cmdlet finalice correctamente, el elemento de Marketplace debe estar disponible en el Marketplace de Azure Stack Hub.

Pasos siguientes

Conexión a Azure Stack Hub con PowerShell