Scaricare gli elementi del Marketplace nell'hub Azure StackDownload Marketplace items to Azure Stack Hub

Gli operatori cloud possono scaricare elementi nell'hub Azure Stack dal Marketplace e renderli disponibili a tutti gli utenti che usano l'ambiente Azure Stack Hub.As a cloud operator, you can download items to Azure Stack Hub from the Marketplace and make them available to all users using the Azure Stack Hub environment. Gli elementi che è possibile scegliere sono da un elenco curato di elementi di Azure Marketplace che sono già testati e supportati per l'uso con Azure Stack Hub.The items you can choose are from a curated list of Azure Marketplace items that are pre-tested and supported to work with Azure Stack Hub. Gli elementi aggiuntivi vengono spesso aggiunti a questo elenco, quindi continuare a verificare la presenza di nuovi contenuti.Additional items are frequently added to this list, so continue to check back for new content.

Esistono due scenari per scaricare i prodotti Marketplace:There are two scenarios for downloading Marketplace products:

  • Scenario disconnesso o parzialmente connesso: richiede l'accesso a Internet usando lo strumento di diffusione del Marketplace per scaricare gli elementi del Marketplace.Disconnected or partially connected scenario: Requires you to access the internet using the Marketplace syndication tool to download Marketplace items. I download vengono quindi trasferiti all'installazione dell'hub Azure Stack disconnessa.Then, you transfer your downloads to your disconnected Azure Stack Hub installation. Questo scenario USA PowerShell.This scenario uses PowerShell.
  • Scenario connesso: richiede che l'ambiente dell'hub Azure stack sia connesso a Internet.Connected scenario: Requires your Azure Stack Hub environment to be connected to the internet. Per individuare e scaricare gli elementi, è possibile usare il portale di amministrazione dell'hub Azure Stack.You use the Azure Stack Hub administrator portal to locate and download items.

Per un elenco completo degli elementi del Marketplace che è possibile scaricare, vedere elementi di Azure Marketplace per l'Hub Azure stack .See Azure Marketplace items for Azure Stack Hub for a complete list of the marketplace items you can download. Per un elenco di aggiunte, eliminazioni e aggiornamenti recenti per Azure Stack Marketplace Hub, vedere l'articolo relativo alle modifiche del Marketplace di Azure stack Hub .See the Azure Stack Hub Marketplace changes article for a list of recent additions, deletions, and updates to Azure Stack Hub Marketplace.

Nota

Il catalogo sarà diverso in base al cloud a cui è connesso il sistema Hub Azure Stack.The catalog will be different based on the cloud your Azure Stack Hub system is connected to. L'ambiente cloud è determinato dalla sottoscrizione di Azure usata per la registrazione dell'hub Azure Stack.The cloud environment is determined by the Azure subscription you use for registering your Azure Stack Hub.

Nota

È anche possibile usare l'operatore di accesso workstation (OAW) per accedere all'endpoint con privilegi (PEP), al portale per gli amministratori per gli scenari di supporto e agli strumenti di GitHub dell'hub Azure Stack.You can also use the The Operator Access Workstation (OAW) to access the privileged endpoint (PEP), the Administrator portal for support scenarios, and Azure Stack Hub GitHub Tools. Per altre informazioni, vedere Azure stack workstation di accesso operator Hub.For more information see Azure Stack Hub Operator Access Workstation.

Una distribuzione connessa consente di usare il portale di amministrazione per scaricare gli elementi del Marketplace.A connected deployment allows you to use the administrator portal to download marketplace items.

PrerequisitiPrerequisites

La distribuzione dell'hub Azure Stack deve avere connettività Internet ed essere registrata in Azure.Your Azure Stack Hub deployment must have internet connectivity and be registered with Azure.

Usare il portale per scaricare gli elementi del MarketplaceUse the portal to download marketplace items

  1. Accedere al portale di amministrazione dell'hub Azure Stack.Sign into the Azure Stack Hub administrator portal.

  2. Esaminare lo spazio di archiviazione disponibile prima di scaricare gli elementi del Marketplace.Review the available storage space before downloading marketplace items. Successivamente, quando si selezionano gli elementi da scaricare, è possibile confrontare le dimensioni del download con la capacità di archiviazione disponibile.Later, when you select items for download, you can compare the download size to your available storage capacity. Se la capacità è limitata, prendere in considerazione le opzioni per la gestione dello spazio disponibile.If capacity is limited, consider options for managing available space.

    Per esaminare lo spazio disponibile: in Gestione aree selezionare l'area che si vuole esplorare e quindi passare a provider di risorse > archiviazione:To review available space: in Region management, select the region you want to explore and then go to Resource Providers > Storage:

    Esaminare lo spazio di archiviazione nel portale dell'amministratore di Azure Stack Hub

  3. Aprire Azure Stack Marketplace Hub e connettersi ad Azure.Open Azure Stack Hub Marketplace and connect to Azure. A tale scopo, selezionare il servizio di gestione del Marketplace , selezionare elementi del Marketplace e quindi selezionare Aggiungi da Azure:To do so, select the Marketplace management service, select Marketplace items, and then select Add from Azure:

    Aggiungere elementi del Marketplace da Azure

  4. Ogni voce Mostra anche la versione attualmente disponibile.Each line item also shows the currently available version. Se è disponibile più di una versione di un elemento del Marketplace, la colonna Version Mostra più di una versione.If more than one version of a Marketplace item is available, the Version column shows Multiple. È possibile fare clic su ogni elemento per visualizzarne la descrizione e altre informazioni, incluse le dimensioni del download:You can click on each item to view its description and additional information, including its download size:

    Screenshot che mostra le versioni disponibili di un elemento del Marketplace.

  5. Se la versione di un elemento viene visualizzata come multipla, è possibile selezionare tale elemento e quindi scegliere una versione specifica dall'elenco a discesa del selettore della versione risultante.If the version of an item is shown as Multiple, you can select that item and then choose a specific version from the resulting version selector dropdown. Si noti che Microsoft ora è in grado di aggiungere attributi che impediscono agli amministratori di scaricare prodotti Marketplace incompatibili con la loro Azure Stack, a causa di diverse proprietà, ad esempio la versione Azure Stack o il modello di fatturazione.Note that Microsoft now has the ability to add attributes that block administrators from downloading marketplace products that are incompatible with their Azure Stack, due to various properties, such as the Azure Stack version or billing model. Solo Microsoft può aggiungere questi attributi:Only Microsoft can add these attributes:

    Aggiungi da AzureAdd from Azure

  6. Selezionare l'elemento desiderato e quindi fare clic su download.Select the item you want, and then select Download. I tempi di download variano a seconda della connettività di rete.Download times vary and depends on the network connectivity. Al termine del download, è possibile distribuire il nuovo elemento del Marketplace come un operatore Hub Azure Stack o un utente.After the download completes, you can deploy the new marketplace item as either an Azure Stack Hub operator or a user.

  7. Per distribuire l'elemento scaricato, selezionare + Crea una risorsa e quindi cercare tra le categorie per il nuovo elemento del Marketplace.To deploy the downloaded item, select + Create a resource, and then search among the categories for the new marketplace item. Selezionare quindi l'elemento per iniziare il processo di distribuzione.Next, select the item to begin the deployment process. Il processo varia a seconda degli elementi del Marketplace.The process varies for different marketplace items.

Quando Azure Stack Hub ha una connettività Internet limitata o nessuna, usare PowerShell e lo strumento di diffusione del Marketplace per scaricare gli elementi del Marketplace in un computer con connettività Internet.When Azure Stack Hub has limited or no internet connectivity, you use PowerShell and the marketplace syndication tool to download the marketplace items to a machine with internet connectivity. Gli elementi vengono quindi trasferiti nell'ambiente dell'hub Azure Stack.You then transfer the items to your Azure Stack Hub environment. In un ambiente disconnesso non è possibile scaricare gli elementi del Marketplace usando il portale dell'hub Azure Stack.In a disconnected environment, you can't download marketplace items by using the Azure Stack Hub portal.

Lo strumento di diffusione del Marketplace può essere usato anche in uno scenario connesso.The marketplace syndication tool can also be used in a connected scenario.

Lo scenario è composto da due parti:There are two parts to this scenario:

  • Parte 1: scaricare dagli elementi del Marketplace.Part 1: Download from Marketplace items. Nel computer con accesso a Internet configurare PowerShell, scaricare lo strumento di diffusione e quindi scaricare gli elementi da Azure Marketplace.On the computer with internet access, you configure PowerShell, download the syndication tool, and then download items from Azure Marketplace.
  • Parte 2: caricare e pubblicare nel Marketplace Azure stack Hub.Part 2: Upload and publish to Azure Stack Hub Marketplace. Spostare i file scaricati nell'ambiente Azure Stack Hub e quindi pubblicarli in Azure Stack Marketplace Hub.You move the files you downloaded to your Azure Stack Hub environment and then publish them to Azure Stack Hub Marketplace.

PrerequisitiPrerequisites

  • Un ambiente connesso (non deve essere Azure Stack Hub).A connected environment (does not have to be Azure Stack Hub). È necessaria la connettività per ottenere l'elenco dei prodotti da Azure con i relativi dettagli e per scaricare tutti gli elementi in locale.You need connectivity to get the list of products from Azure with their details, and to download everything locally. Al termine di questa operazione, il resto della procedura non richiede la connettività Internet.Once this is done, the rest of the procedure does not require internet connectivity. Viene creato un catalogo di elementi scaricati in precedenza da usare nell'ambiente disconnesso.It creates a catalog of items you've previously downloaded for you to use in your disconnected environment.

  • Supporti rimovibili per connettersi all'ambiente disconnesso e trasferire tutti gli elementi necessari.Removable media to connect to your disconnected environment and transfer all the necessary artifacts.

  • Un ambiente di Azure Stack Hub disconnesso con i prerequisiti seguenti:A disconnected Azure Stack Hub environment with the following prerequisites:

Scaricare il modulo AZS. Syndication. admin dalla PowerShell Gallery usando il comando seguente:Download the Azs.Syndication.Admin module from the PowerShell Gallery using the following command:

Install-Module -Name Azs.Syndication.Admin -AllowPrerelease -PassThru

Dopo aver registrato il Azure Stack, è possibile ignorare il seguente messaggio visualizzato nel pannello di gestione del Marketplace, in quanto non è pertinente per il caso d'uso disconnesso:Once you have registered your Azure Stack, you can disregard the following message that appears on the Marketplace management blade, as this is not relevant for the disconnected use case:

Gestione del Marketplace

Usare lo strumento di diffusione del Marketplace per scaricare gli elementi del MarketplaceUse the marketplace syndication tool to download marketplace items

Importante

Assicurarsi di scaricare lo strumento di diffusione del Marketplace ogni volta che si scaricano gli elementi del Marketplace in uno scenario disconnesso.Be sure to download the marketplace syndication tool each time you download marketplace items in a disconnected scenario. Sono state apportate modifiche frequenti a questo strumento ed è necessario usare la versione più recente per ogni download.Frequent changes are made to this tool and the most current version should be used for each download.

  1. In un computer con una connessione Internet aprire una console di PowerShell come amministratore.On a computer with an Internet connection, open a PowerShell console as an administrator.

  2. Accedere al tenant di Azure cloud e alla directory AzureAD appropriato usando l'account Azure usato per registrare Azure Stack Hub.Sign in to the appropriate Azure cloud and AzureAD directory tenant using the Azure account that you've used to register Azure Stack Hub. Per aggiungere l'account, in PowerShell eseguire Connect-AzAccount :To add the account, in PowerShell run Connect-AzAccount:

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

    Viene richiesto di immettere le credenziali dell'account Azure e potrebbe essere necessario usare l'autenticazione a due fattori, a seconda della configurazione dell'account.You are prompted to enter your Azure account credentials and you might have to use two-factor authentication, depending on your account configuration.

    Nota

    Se la sessione scade, la password è cambiata o si vuole cambiare account, eseguire il cmdlet seguente prima di eseguire l'accesso con Connect-AzAccount : Remove-AzAccount -Scope Process .If your session expires, your password has changed, or you want to switch accounts, run the following cmdlet before you sign in using Connect-AzAccount: Remove-AzAccount -Scope Process.

  3. Se sono disponibili più sottoscrizioni, eseguire il comando seguente per selezionare quella usata per la registrazione:If you have multiple subscriptions, run the following command to select the one you used for registration:

    Get-AzSubscription -SubscriptionID 'Your Azure Subscription GUID' | Select-AzSubscription
    
  4. Se non è già stato fatto nel passaggio dei prerequisiti, scaricare la versione più recente dello strumento di diffusione del Marketplace:If you haven't done it in the pre-requisites step already, download the latest version of the Marketplace syndication tool:

    Install-Module -Name Azs.Syndication.Admin -AllowPrerelease -PassThru
    
  5. Per selezionare gli elementi del Marketplace come immagini di VM, estensioni o modelli di soluzione da scaricare, eseguire il comando seguente:To select the Marketplace items such as VM images, extensions, or solution templates to download, run the following command:

    $products = Select-AzsMarketplaceItem
    

    Verrà visualizzata una tabella in cui sono elencate tutte le registrazioni Azure Stack disponibili nella sottoscrizione selezionata.This displays a table that lists all the Azure Stack registrations available in the selected subscription. Scegliere la registrazione corrispondente all'ambiente di Azure Stack per cui si stanno scaricando gli elementi del Marketplace e fare clic su OK.Choose the registration that matches the Azure Stack environment you're downloading the marketplace items for, and select OK.

    Screenshot che mostra un elenco di tutte le registrazioni Azure Stack disponibili nella sottoscrizione selezionata.

    A questo punto dovrebbe essere visualizzata una seconda tabella che elenca tutti gli elementi del Marketplace disponibili per il download.You should now see a second table listing all the marketplace items available for download. Selezionare l'elemento che si desidera scaricare e prendere nota della versione.Select the item that you want to download and make a note of the Version. È possibile tenere premuto il tasto CTRL per selezionare più immagini.You can hold the Ctrl key to select multiple images. Screenshot che mostra un altro elenco di tutte le registrazioni Azure Stack disponibili nella sottoscrizione selezionata.Screenshot that shows another list of all the Azure Stack registrations available in the selected subscription.

    È inoltre possibile filtrare l'elenco di immagini utilizzando l'opzione Aggiungi criteri .You can also filter the list of images by using the Add criteria option. Selezionare le registrazioni Azure StackSelect Azure Stack Registrations

    Una volta effettuate le selezioni, fare clic su OK.Once you've made your selections, select OK.

  6. Gli ID per gli elementi del Marketplace selezionati per il download vengono salvati nella $products variabile.The IDs for the Marketplace items you've selected for download are saved in the $products variable. Usare il comando seguente per iniziare a scaricare gli elementi selezionati.Use the command below to begin downloading the selected items. Sostituire il percorso della cartella di destinazione con un percorso in cui archiviare i file scaricati da Azure Marketplace:Replace the destination folder path with a location to store the files you download from Azure Marketplace:

    $products | Export-AzsMarketplaceItem  -RepositoryDir "Destination folder path in quotes"
    
  7. Il tempo necessario per il download dipende dalle dimensioni dell'elemento.The time that the download takes depends on the size of the item. Al termine del download, l'elemento è disponibile nella cartella specificata nello script.After the download completes, the item is available in the folder that you specified in the script. Il download include un file VHD (per le macchine virtuali) o un file zip (per le estensioni delle macchine virtuali e i provider di risorse).The download includes a VHD file (for virtual machines), or a .zip file (for virtual machine extensions and resource providers). Potrebbe inoltre includere un pacchetto della raccolta nel formato azpkg , ovvero un file con estensione zip.It might also include a gallery package in the .azpkg format, which is a .zip file.

  8. Se il download non riesce, è possibile riprovare eseguendo di nuovo il cmdlet di PowerShell seguente:If the download fails, you can try again by re-running the following PowerShell cmdlet:

    $products | Export-AzsMarketplaceItem  -RepositoryDir "Destination folder path in quotes"
    
  9. È anche necessario esportare il modulo AZS. Syndication. admin in locale in modo che sia possibile copiarlo nel computer da cui si importano gli elementi del Marketplace nell'hub Azure stack.You should also export the Azs.Syndication.Admin module locally so that you can copy it over to the machine from which you are importing Marketplace items to Azure Stack Hub.

    Nota

    La cartella di destinazione per l'esportazione del modulo deve essere diversa da quella in cui sono stati esportati gli elementi del Marketplace.The destination folder for exporting this module should be different from the location to which you have exported the marketplace items.

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

Importare il download e la pubblicazione nel Marketplace Azure Stack hub usando PowerShellImport the download and publish to Azure Stack Hub Marketplace using PowerShell

  1. È necessario spostare i file scaricati in precedenza localmente in un computer con connettività all'ambiente dell'hub Azure stack.You must move the files that you have previously downloaded locally to a machine that has connectivity to your Azure Stack Hub environment. Lo strumento di diffusione del Marketplace deve essere disponibile anche per l'ambiente Azure Stack Hub perché è necessario usare lo strumento per eseguire l'operazione di importazione.The marketplace syndication tool must also be available to your Azure Stack Hub environment because you need to use the tool to perform the import operation.

    Nell'immagine seguente viene illustrato un esempio di struttura di cartelle.The following image shows a folder structure example. D:\downloadfolder contiene tutti gli elementi del Marketplace scaricati.D:\downloadfolder contains all the downloaded marketplace items. Ogni sottocartella è un elemento del Marketplace, ad esempio Microsoft. custom-script-Linux-ARM-2.0.3, denominato dall'ID prodotto.Each subfolder is a marketplace item (for example, microsoft.custom-script-linux-arm-2.0.3), named by the product ID. All'interno di ogni sottocartella si trova il contenuto scaricato dell'elemento del Marketplace.Inside each subfolder is the marketplace item's downloaded content.

    Struttura di directory di download del Marketplace

  2. Seguire le istruzioni riportate in questo articolo per configurare la sessione di PowerShell per l'operatore Azure stack Hub.Follow the instructions in this article to configure the Azure Stack Hub Operator PowerShell session.

  3. Accedere all'hub Azure Stack con un'identità con l'accesso proprietario alla "sottoscrizione del provider predefinita".Sign in to your Azure Stack Hub with an identity that has owner access to the "Default Provider Subscription".

  4. Importare il modulo Syndication e quindi avviare lo strumento di diffusione del Marketplace eseguendo lo script seguente:Import the syndication module and then launch the marketplace syndication tool by running the following script:

    Import-AzsMarketplaceItem -RepositoryDir "Source folder path in quotes"
    
  5. Una volta completato lo script, gli elementi del Marketplace dovrebbero essere disponibili nel Marketplace Azure Stack Hub.After the script successfully completes, the marketplace items should be available in Azure Stack Hub Marketplace.