Condividi tramite


Scaricare gli elementi del Marketplace nell'hub di Azure Stack

Gli operatori cloud possono scaricare elementi nell'hub di Azure Stack dal Marketplace e renderli disponibili a tutti gli utenti usando l'ambiente hub di Azure Stack. Gli elementi che è possibile scegliere sono inclusi in un elenco curato di elementi di Azure Marketplace pre-testati e supportati per l'uso con l'hub di Azure Stack. Gli elementi aggiuntivi vengono spesso aggiunti a questo elenco, quindi continua a tornare per controllare nuovi contenuti.

Esistono due scenari per il download dei prodotti Marketplace:

  • scenario disconnesso o parzialmente connesso: richiede di accedere a Internet usando lo strumento di diffusione del Marketplace per scaricare gli elementi del Marketplace. I download vengono quindi trasferiti all'installazione disconnessa dell'hub di Azure Stack. Questo scenario usa PowerShell.
  • scenario connesso: richiede che l'ambiente dell'hub di Azure Stack sia connesso a Internet. Usare il portale di amministrazione dell'hub di Azure Stack per individuare e scaricare gli elementi.

Vedere elementi di Azure Marketplace per l'hub di Azure Stack per un elenco completo degli elementi del Marketplace che è possibile scaricare. Per un elenco delle aggiunte, delle eliminazioni e degli aggiornamenti recenti nel Marketplace dell'hub di Azure Stack, vedere l'articolo modifiche al Marketplace dell'hub di Azure Stack.

Nota

Il catalogo sarà diverso in base al cloud a cui è connesso il sistema hub di Azure Stack. L'ambiente cloud è determinato dalla sottoscrizione di Azure usata per la registrazione dell'hub di Azure Stack.

Nota

È anche possibile usare the Operator Access Workstation (OAW) per accedere all'endpoint con privilegi (PEP), al portale di amministrazione per gli scenari di supporto e agli strumenti GitHub dell'hub di Azure Stack. Per ulteriori informazioni, vedere postazione di accesso dell'operatore di Azure Stack Hub.

Una distribuzione connessa consente di usare il portale di amministrazione per scaricare gli elementi del Marketplace.

Prerequisiti

La distribuzione dell'hub di Azure Stack deve avere connettività Internet e essere registrata con Azure.

Usare il portale per scaricare gli elementi del Marketplace

  1. Accedere al portale di amministrazione dell'hub di Azure Stack.

  2. Esaminare lo spazio di archiviazione disponibile prima di scaricare gli elementi del Marketplace. In seguito, quando si selezionano gli elementi per il download, è possibile confrontare le dimensioni del download con la capacità di archiviazione disponibile. Se la capacità è limitata, prendere in considerazione le opzioni per la gestione dello spazio disponibile.

    Per esaminare lo spazio disponibile: in Gestione dell'areaselezionare l'area da esplorare e quindi passare a provider di risorse >archiviazione:

    Esaminare lo spazio di archiviazione nel portale di amministrazione dell'hub di Azure Stack

  3. Aprire Azure Stack Hub Marketplace e connettersi ad Azure. Per farlo, selezionare il servizio di gestione del Marketplace, selezionare gli elementi del Marketplacee quindi selezionare Aggiungi da Azure:

    Aggiungere elementi del Marketplace da Azure

  4. Ogni voce di elenco mostra anche la versione attualmente disponibile. Se sono disponibili più versioni di un elemento del Marketplace, nella colonna Versione viene visualizzato Multiplo. È possibile fare clic su ogni elemento per visualizzarne la descrizione e altre informazioni, incluse le relative dimensioni di download:

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

  5. Se la versione di un elemento viene visualizzata come Multiple, è possibile selezionare tale elemento e quindi scegliere una versione specifica dall'elenco a discesa del selettore di versione risultante. Si noti che Microsoft ora ha la possibilità di aggiungere attributi che impediscono agli amministratori di scaricare prodotti marketplace incompatibili con Azure Stack, a causa di varie proprietà, ad esempio la versione di Azure Stack o il modello di fatturazione. Solo Microsoft può aggiungere questi attributi:

    Aggiungi da Azure

  6. Selezionare l'elemento desiderato e quindi selezionare Scarica. I tempi di download variano e dipendono dalla connettività di rete. Al termine del download, è possibile distribuire il nuovo elemento del marketplace come operatore dell'hub di Azure Stack o come utente.

  7. Per distribuire l'elemento scaricato, selezionare + Crea una risorsae quindi cercare le categorie per il nuovo elemento del marketplace. Selezionare quindi l'elemento per avviare il processo di distribuzione. Il processo varia per diversi elementi del marketplace.

Quando l'hub di Azure Stack ha connettività Internet limitata o assente, è possibile usare PowerShell e lo strumento di diffusione marketplace per scaricare gli elementi del Marketplace in un computer con connettività Internet. Si trasferisce quindi gli elementi nell'ambiente dell'hub di Azure Stack. In un ambiente disconnesso non è possibile scaricare gli elementi del marketplace usando il portale dell'hub di Azure Stack.

Lo strumento di diffusione del marketplace può essere usato anche in uno scenario connesso.

Esistono due parti di questo scenario:

  • parte 1: Scarica elementi dal Marketplace. Nel computer con accesso a Internet configurare PowerShell, scaricare lo strumento di diffusione e quindi scaricare gli elementi da Azure Marketplace.
  • parte 2: caricare e pubblicare nel Marketplace dell'hub di Azure Stack. Spostare i file scaricati nell'ambiente dell'hub di Azure Stack e quindi pubblicarli in Azure Stack Hub Marketplace.

Prerequisiti

  • Un ambiente connesso (non deve essere l'hub di Azure Stack). È necessaria la connettività per ottenere l'elenco dei prodotti da Azure con i relativi dettagli e per scaricare tutti gli elementi in locale. Al termine, il resto della procedura non richiede la connettività Internet. Crea un catalogo di elementi scaricati in precedenza da usare nell'ambiente disconnesso.
  • Supporti rimovibili per connettersi all'ambiente disconnesso e trasferire tutti gli artefatti necessari.
  • Un ambiente dell'hub di Azure Stack disconnesso con i prerequisiti seguenti:

Scaricare il modulo di Azs.Syndication.Admin da PowerShell Gallery usando il comando seguente:

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

Dopo aver registrato l'hub di Azure Stack, è possibile ignorare il messaggio seguente visualizzato nel pannello di gestione del Marketplace, perché questo non è rilevante per il caso d'uso disconnesso:

Marketplace gestione

Usare lo strumento di diffusione del Marketplace per scaricare gli articoli del Marketplace

Assicurati di scaricare lo strumento di diffusione del marketplace ogni volta che scarichi gli elementi del marketplace in uno scenario disconnesso. Vengono apportate modifiche frequenti a questo strumento e la versione più recente deve essere usata per ogni download.

Importante

È consigliabile usare moduli Az anziché AzureRM, perché AzureRM è deprecato. Vedere gli esempi seguenti.

  1. In un computer con una connessione Internet aprire una console di PowerShell come amministratore.

  2. Accedi al tenant appropriato del cloud di Azure e alla directory Entra ID usando l'account Azure che hai usato per registrare Azure Stack Hub. Per aggiungere l'account, in PowerShell eseguire 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.

    Nota

    Se la sessione scade, la password è stata modificata o si vuole cambiare account, eseguire il cmdlet seguente prima di accedere usando Connect-AzAccount: Remove-AzAccount -Scope Process.

  3. Se sono presenti più sottoscrizioni, eseguire il comando seguente per selezionare quello usato per la registrazione:

    Get-AzSubscription -SubscriptionID 'Your Azure Subscription GUID' | Select-AzSubscription
    
  4. Se non è già stato fatto nel passaggio prerequisiti, scaricare la versione più recente dello strumento di diffusione del Marketplace se si usa la versione più recente dell'hub di Azure Stack:

Install-Module -Name Azs.Syndication.Admin
Install-Module -Name Azs.Syndication.Admin -RequiredVersion 0.1.154-preview -AllowPrerelease
  1. Per selezionare elementi del Marketplace, ad esempio immagini di macchine virtuali, estensioni o modelli di soluzione da scaricare, eseguire il comando seguente:

    $products = Select-AzsMarketplaceItem
    

    Viene visualizzata una tabella che elenca tutte le registrazioni di Azure Stack disponibili nella sottoscrizione selezionata. Scegliere la registrazione corrispondente all'ambiente Azure Stack per cui si scaricano gli elementi del Marketplace e selezionare OK.

    Screenshot che mostra un elenco di tutte le registrazioni di 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. Seleziona l'elemento da scaricare e prendi nota della versione . È possibile tenere premuto il tasto CTRL per selezionare più immagini.

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

    È anche possibile filtrare l'elenco delle immagini usando l'opzione aggiungi criteri .

    Selezionare registrazioni di Azure Stack

    Dopo aver eseguito le selezioni, selezionare OK.

  2. Gli ID per gli elementi del marketplace selezionati per il download vengono salvati nella variabile $products. Usare il comando seguente per scaricare gli elementi selezionati. Sostituire il percorso della cartella di destinazione con un percorso in cui archiviare i file scaricati da Azure Marketplace:

    $products | Export-AzsMarketplaceItem  -RepositoryDir "Destination folder path in quotes"
    
  3. Il tempo necessario per il download dipende dalle dimensioni dell'elemento. Al termine del download, l'elemento è disponibile nella cartella specificata nello script. Il download include un file VHD (per le macchine virtuali) o un file .zip (per le estensioni per macchine virtuali e provider di risorse). Può anche includere un pacchetto della raccolta nel formato .azpkg, ovvero un file .zip.

  4. Se il download non riesce, è possibile riprovare eseguendo nuovamente il cmdlet di PowerShell seguente:

    $products | Export-AzsMarketplaceItem  -RepositoryDir "Destination folder path in quotes"
    
  5. È anche consigliabile esportare il modulo Azs.Syndication.Admin in locale in modo da poterlo copiare nel computer da cui si importano elementi del Marketplace nell'hub di Azure Stack.

    Nota

    La cartella di destinazione per l'esportazione di questo modulo deve essere diversa dal percorso in cui sono stati esportati gli elementi del marketplace.

    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 in Azure Stack Hub Marketplace con PowerShell

  1. È necessario spostare i file scaricati in precedenza in locale in un computer con connettività all'ambiente dell'hub di Azure Stack. Lo strumento di diffusione del marketplace deve essere disponibile anche per l'ambiente dell'hub di Azure Stack perché è necessario usare lo strumento per eseguire l'operazione di importazione.

    L'immagine seguente mostra un esempio di struttura di cartelle. D:\downloadfolder contiene tutti gli elementi del marketplace scaricati. Ogni sottocartella è un elemento del Marketplace (ad esempio, microsoft.custom-script-linux-arm-2.0.3), denominato dall'ID prodotto. All'interno di ogni sottocartella si trova il contenuto scaricato dell'elemento di marketplace.

    Struttura delle directory dei download del Marketplace

  2. Seguire le istruzioni riportate in Connettersi all'hub di Azure Stack con PowerShell per configurare la sessione powerShell dell'operatore hub di Azure Stack.

  3. Accedere all'hub di Azure Stack con un'identità con accesso proprietario alla sottoscrizione del provider predefinito .

  4. Copiare il nome della cartella; ad esempio, microsoft.dsc-arm-2.77.0e creare una cartella con tale nome.

  5. Spostare la cartella scaricata in tale cartella. A questo punto, hai C:\microsoft.dsc-arm-2.77.0\microsoft.dsc-arm-2.77.0\original-sub-folders-are-here e C:\microsoft.dsc-arm-2.77.0\microsoft.dsc-arm-2.77.0\productDetails.jsin.

  6. Importare il modulo di diffusione e quindi avviare lo strumento di diffusione del Marketplace eseguendo il cmdlet seguente:

    Import-AzsMarketplaceItem -RepositoryDir "C:\microsoft.dsc-arm-2.77.0"
    
  7. Al termine del cmdlet, gli elementi del Marketplace devono essere disponibili nel Marketplace dell'hub di Azure Stack.

Passaggi successivi

connettersi all'hub di Azure Stack con PowerShell