Marketplace-items downloaden naar Azure Stack Hub
Als cloudoperator kunt u items downloaden naar Azure Stack Hub vanuit Marketplace en deze beschikbaar maken voor alle gebruikers met behulp van de Azure Stack Hub-omgeving. De items die u kunt kiezen, zijn afkomstig uit een gecureerde lijst met Azure Marketplace items die vooraf zijn getest en ondersteund voor gebruik met Azure Stack Hub. Er worden regelmatig extra items aan deze lijst toegevoegd, dus ga door met het terugkijken naar nieuwe inhoud.
Er zijn twee scenario's voor het downloaden van Marketplace-producten:
- Niet-verbonden of gedeeltelijk verbonden scenario: Hiervoor hebt u toegang tot internet nodig met het hulpprogramma Marketplace-syndicatie om Marketplace-items te downloaden. Vervolgens brengt u uw downloads over naar de niet-verbonden Azure Stack Hub-installatie. In dit scenario wordt PowerShell gebruikt.
- Verbonden scenario: Vereist dat uw Azure Stack Hub-omgeving is verbonden met internet. U gebruikt de Azure Stack Hub-beheerdersportal om items te zoeken en te downloaden.
Zie Azure Marketplace items voor Azure Stack Hub voor een volledige lijst met marketplace-items die u kunt downloaden. Zie het artikel over wijzigingen in Azure Stack Hub Marketplace voor een lijst met recente toevoegingen, verwijderingen en updates voor Azure Stack Hub Marketplace.
Notitie
De catalogus is anders op basis van de cloud waar uw Azure Stack Hub-systeem mee is verbonden. De cloudomgeving wordt bepaald door het Azure-abonnement dat u gebruikt voor het registreren van uw Azure Stack Hub.
Notitie
U kunt ook het OAW (Operator Access Workstation) gebruiken voor toegang tot het bevoegde eindpunt (PEP), de beheerdersportal voor ondersteuningsscenario's en Azure Stack Hub GitHub Tools. Zie Azure Stack Hub Operator Access Workstation voor meer informatie.
Met een verbonden implementatie kunt u de beheerdersportal gebruiken om Marketplace-items te downloaden.
Vereisten
Uw Azure Stack Hub-implementatie moet een internetverbinding hebben en zijn geregistreerd bij Azure.
De portal gebruiken om Marketplace-items te downloaden
Meld u aan bij de Azure Stack Hub-beheerdersportal.
Controleer de beschikbare opslagruimte voordat u Marketplace-items downloadt. Wanneer u later items selecteert om te downloaden, kunt u de downloadgrootte vergelijken met uw beschikbare opslagcapaciteit. Als de capaciteit beperkt is, kunt u overwegen om beschikbare ruimte te beheren.
Als u de beschikbare ruimte wilt bekijken: selecteer in Regiobeheer de regio die u wilt verkennen en ga vervolgens naar Resourceproviders>Storage:
Open Azure Stack Hub Marketplace en maak verbinding met Azure. Hiervoor selecteert u de Marketplace-beheerservice , selecteert u Marketplace-items en selecteert u Vervolgens Toevoegen uit Azure:
Elk regelitem bevat ook de momenteel beschikbare versie. Als er meer dan één versie van een Marketplace-item beschikbaar is, wordt in de kolom Versiemeerdere weergegeven. U kunt op elk item klikken om de beschrijving en aanvullende informatie weer te geven, inclusief de downloadgrootte:
Als de versie van een item wordt weergegeven als Meerdere, kunt u dat item selecteren en vervolgens een specifieke versie kiezen in de resulterende vervolgkeuzelijst voor versieselector. Microsoft heeft nu de mogelijkheid om kenmerken toe te voegen die verhinderen dat beheerders Marketplace-producten downloaden die niet compatibel zijn met hun Azure Stack, vanwege verschillende eigenschappen, zoals de Azure Stack-versie of het factureringsmodel. Alleen Microsoft kan deze kenmerken toevoegen:
Selecteer het gewenste item en selecteer vervolgens Downloaden. Downloadtijden variëren en zijn afhankelijk van de netwerkverbinding. Nadat het downloaden is voltooid, kunt u het nieuwe Marketplace-item implementeren als een Azure Stack Hub-operator of een gebruiker.
Als u het gedownloade item wilt implementeren, selecteert u + Een resource maken en zoekt u vervolgens naar de categorieën voor het nieuwe Marketplace-item. Selecteer vervolgens het item om het implementatieproces te starten. Het proces varieert voor verschillende Marketplace-items.
Wanneer Azure Stack Hub beperkte of geen internetverbinding heeft, gebruikt u PowerShell en het marketplace-syndicatieprogramma om de Marketplace-items te downloaden naar een computer met internetverbinding. Vervolgens brengt u de items over naar uw Azure Stack Hub-omgeving. In een niet-verbonden omgeving kunt u marketplace-items niet downloaden met behulp van de Azure Stack Hub-portal.
Het hulpprogramma voor marketplace-syndicatie kan ook worden gebruikt in een verbonden scenario.
Er zijn twee onderdelen voor dit scenario:
- Deel 1: Downloaden van Marketplace-items. Op de computer met internettoegang configureert u PowerShell, downloadt u het syndicatieprogramma en downloadt u items uit Azure Marketplace.
- Deel 2: Upload en publiceren naar Azure Stack Hub Marketplace. U verplaatst de bestanden die u hebt gedownload naar uw Azure Stack Hub-omgeving en publiceert ze vervolgens naar Azure Stack Hub Marketplace.
Vereisten
Een verbonden omgeving (hoeft geen Azure Stack Hub te zijn). U hebt connectiviteit nodig om de lijst met producten van Azure op te halen met hun gegevens en om alles lokaal te downloaden. Zodra dit is gebeurd, is voor de rest van de procedure geen internetverbinding vereist. Er wordt een catalogus gemaakt met items die u eerder hebt gedownload voor gebruik in uw niet-verbonden omgeving.
Verwisselbare media om verbinding te maken met uw niet-verbonden omgeving en alle benodigde artefacten over te dragen.
Een niet-verbonden Azure Stack Hub-omgeving met de volgende vereisten:
Uw Azure Stack Hub-implementatie moet zijn geregistreerd bij Azure.
De computer met internetverbinding moet beschikken over Azure Stack Hub PowerShell-module versie 1.2.11 of hoger. Als deze nog niet aanwezig is, installeert u Azure Stack Hub-specifieke PowerShell-modules.
Als u het importeren van een gedownload Marketplace-item wilt inschakelen, moet de PowerShell-omgeving voor de Azure Stack Hub-operator worden geconfigureerd.
.NET Framework 4,7 of hoger.
Download de module Azs.Syndication.Admin van de PowerShell Gallery met behulp van de volgende opdracht:
Install-Module -Name Azs.Syndication.Admin
Install-Module -Name Azs.Syndication.Admin -RequiredVersion 0.1.154-preview -AllowPrerelease
Nadat u uw Azure Stack hebt geregistreerd, kunt u het volgende bericht negeren dat wordt weergegeven op de blade Marketplace-beheer, omdat dit niet relevant is voor de niet-verbonden use-case:
Het marketplace-syndicatieprogramma gebruiken om Marketplace-items te downloaden
Belangrijk
Zorg ervoor dat u het marketplace-syndicatieprogramma downloadt telkens wanneer u Marketplace-items downloadt in een niet-verbonden scenario. Er worden regelmatig wijzigingen aangebracht in dit hulpprogramma en de meest recente versie moet worden gebruikt voor elke download.
Open op een computer met een internetverbinding een PowerShell-console als beheerder.
Meld u aan bij de juiste Azure-cloud- en AzureAD-directorytenant met het Azure-account dat u hebt gebruikt om Azure Stack Hub te registreren. Voer in PowerShell
Connect-AzAccounthet volgende uit om het account toe te voegen:Connect-AzAccount -Environment AzureCloud -Tenant '<mydirectory>.onmicrosoft.com'U wordt gevraagd uw Azure-accountreferenties in te voeren en mogelijk moet u tweeledige verificatie gebruiken, afhankelijk van uw accountconfiguratie.
Notitie
Als uw sessie verloopt, uw wachtwoord is gewijzigd of als u van account wilt wisselen, voert u de volgende cmdlet uit voordat u zich aanmeldt met
Connect-AzAccount: .Remove-AzAccount -Scope ProcessAls u meerdere abonnementen hebt, voert u de volgende opdracht uit om het abonnement te selecteren dat u hebt gebruikt voor registratie:
Get-AzSubscription -SubscriptionID 'Your Azure Subscription GUID' | Select-AzSubscriptionAls u dit nog niet hebt gedaan in de vereiste stap, downloadt u de nieuwste versie van het marketplace-syndicatieprogramma als u de nieuwste versie van Azure Stack Hub gebruikt:
Install-Module -Name Azs.Syndication.Admin
Install-Module -Name Azs.Syndication.Admin -RequiredVersion 0.1.154-preview -AllowPrerelease
Als u de Marketplace-items wilt selecteren, zoals VM-installatiekopieën, extensies of oplossingssjablonen die u wilt downloaden, voert u de volgende opdracht uit:
$products = Select-AzsMarketplaceItemHiermee wordt een tabel weergegeven met alle Azure Stack-registraties die beschikbaar zijn in het geselecteerde abonnement. Kies de registratie die overeenkomt met de Azure Stack-omgeving waarvoor u de Marketplace-items downloadt en selecteer OK.
U ziet nu een tweede tabel met alle marketplace-items die kunnen worden gedownload. Selecteer het item dat u wilt downloaden en noteer de versie. U kunt de Ctrl-toets ingedrukt houden om meerdere afbeeldingen te selecteren.
U kunt ook de lijst met afbeeldingen filteren met behulp van de optie Criteria toevoegen .
Zodra u uw selecties hebt gemaakt, selecteert u OK.
De id's voor de Marketplace-items die u hebt geselecteerd voor downloaden, worden opgeslagen in de
$productsvariabele. Gebruik de onderstaande opdracht om de geselecteerde items te downloaden. Vervang het pad naar de doelmap door een locatie om de bestanden op te slaan die u downloadt uit Azure Marketplace:$products | Export-AzsMarketplaceItem -RepositoryDir "Destination folder path in quotes"De tijd die het downloaden kost, is afhankelijk van de grootte van het item. Nadat het downloaden is voltooid, is het item beschikbaar in de map die u in het script hebt opgegeven. De download bevat een VHD-bestand (voor virtuele machines) of een .zip-bestand (voor extensies van virtuele machines en resourceproviders). Het kan ook een galeriepakket bevatten in de .azpkg-indeling , een .zip-bestand.
Als het downloaden mislukt, kunt u het opnieuw proberen door de volgende PowerShell-cmdlet opnieuw uit te voeren:
$products | Export-AzsMarketplaceItem -RepositoryDir "Destination folder path in quotes"U moet ook de module Azs.Syndication.Admin lokaal exporteren, zodat u deze kunt kopiëren naar de computer van waaruit u Marketplace-items importeert naar Azure Stack Hub.
Notitie
De doelmap voor het exporteren van deze module moet afwijken van de locatie waarnaar u de Marketplace-items hebt geëxporteerd.
Save-Package -ProviderName NuGet -Source https://www.powershellgallery.com/api/v2 -Name Azs.Syndication.Admin -Path "Destination folder path in quotes" -Force
De download en publicatie importeren in Azure Stack Hub Marketplace met behulp van PowerShell
U moet de bestanden die u eerder lokaal hebt gedownload , verplaatsen naar een computer die verbinding heeft met uw Azure Stack Hub-omgeving. Het hulpprogramma marketplace-syndicatie moet ook beschikbaar zijn voor uw Azure Stack Hub-omgeving, omdat u het hulpprogramma moet gebruiken om de importbewerking uit te voeren.
In de volgende afbeelding ziet u een voorbeeld van een mapstructuur. D:\downloadfolder bevat alle gedownloade Marketplace-items. Elke submap is een Marketplace-item (bijvoorbeeld microsoft.custom-script-linux-arm-2.0.3), met de naam van de product-id. In elke submap bevindt zich de gedownloade inhoud van het Marketplace-item.
Volg de instructies in Verbinding maken naar Azure Stack Hub met PowerShell om de PowerShell-sessie van de Azure Stack Hub-operator te configureren.
Meld u aan bij uw Azure Stack Hub met een identiteit die eigenaartoegang heeft tot het standaardproviderabonnement.
Kopieer de naam van de map; Bijvoorbeeld microsoft.dsc-arm-2.77.0 en maak een map met die naam.
Verplaats de gedownloade map naar die map. Op dit moment hebt u C:\microsoft.dsc-arm-2.77.0\microsoft.dsc-arm-2.77.0\original-sub-folders-are-here en C:\microsoft.dsc-arm-2.77.0\microsoft.dsc-arm-2.77.0\productDetails.json.
Importeer de syndicatiemodule en start vervolgens het hulpprogramma marketplace-syndicatie door de volgende cmdlet uit te voeren:
Import-AzsMarketplaceItem -RepositoryDir "C:\microsoft.dsc-arm-2.77.0"Nadat de cmdlet is voltooid, moeten de Marketplace-items beschikbaar zijn in Azure Stack Hub Marketplace.