Freigeben über

Herunterladen von Marketplace-Elementen in Azure Stack Hub

  • Artikel

Als Cloudbetreiber können Sie Elemente aus dem Marketplace in Azure Stack Hub herunterladen und mithilfe der Azure Stack Hub-Umgebung für alle Benutzer verfügbar machen. Die zur Auswahl stehenden Optionen stammen aus einer speziell zusammengestellten Liste mit Azure Marketplace-Elementen, die vorab getestet wurden und für Azure Stack Hub geeignet sind. Dieser Liste werden häufig zusätzliche Einträge hinzugefügt, deshalb sollten Sie regelmäßig nach neuen Inhalten nachsehen.

Es gibt zwei Szenarien für das Herunterladen von Marketplace-Produkten:

  • Nicht verbundenes oder teilweise verbundenes Szenario: Erfordert, dass Sie das Marketplace-Veröffentlichungstool verwenden, um auf das Internet zuzugreifen und Marketplace-Elemente herunterzuladen. Anschließend übertragen Sie Ihre Downloads in die nicht verbundene Azure Stack Hub-Installation. Für dieses Szenario wird PowerShell verwendet.
  • Verbundenes Szenario: Hierfür muss Ihre Azure Stack Hub-Umgebung mit dem Internet verbunden sein. Elemente werden über das Azure Stack Hub-Administratorportal gesucht und heruntergeladen.

Eine komplette Liste der zum Download verfügbaren Marketplace-Elemente finden Sie unter Für Azure Stack Hub verfügbare Azure Marketplace-Elemente. Eine Liste mit den aktuellen Ergänzungen, Entfernungen und Updates in Azure Stack Hub Marketplace finden Sie unter Änderungen im Azure Stack Hub-Marketplace.

Hinweis

Der Katalog unterscheidet sich je nach der Cloud, mit der Ihr Azure Stack Hub-System verbunden ist. Die Cloudumgebung wird durch das Azure-Abonnement bestimmt, das Sie zum Registrieren von Azure Stack Hub verwenden.

Hinweis

Sie können auch die Arbeitsstation mit Operatorzugriff (Operator Access Workstation, OAW) verwenden, um auf den privilegierten Endpunkt (PEP), das Administratorportal für Supportszenarien und Azure Stack Hub-GitHub-Tools zuzugreifen. Weitere Informationen finden Sie unter Azure Stack Hub Operator Access Workstation.

Mit einer verbundenen Bereitstellung können Sie das Administratorportal verwenden, um Marketplace-Elemente herunterzuladen.

Voraussetzungen

Ihre Azure Stack Hub-Bereitstellung muss über eine Internetverbindung verfügen und bei Azure registriert sein.

Herunterladen von Marketplace-Elementen mithilfe des Portals

  1. Melden Sie sich beim Azure Stack Hub-Administratorportal an.

  2. Überprüfen Sie den verfügbaren Speicherplatz, bevor Sie Marketplace-Elemente herunterladen. Wenn Sie später Elemente zum Download auswählen, können Sie die Downloadgröße mit der verfügbaren Speicherkapazität vergleichen. Ziehen Sie bei eingeschränkter Kapazität Optionen für die Verwaltung des verfügbaren Speicherplatzes in Betracht.

    Wenn Sie den verfügbaren Speicherplatz überprüfen möchten, wählen Sie in der Regionsverwaltung die Region aus, die Sie untersuchen möchten, und wechseln Sie dann zu Ressourcenanbieter>Speicherplatz:

    Überprüfen des Speicherplatzes im Azure Stack Hub-Administratorportal

  3. Öffnen Sie den Azure Stack Hub-Marketplace, und stellen Sie eine Verbindung mit Azure her. Wählen Sie dazu den Marketplace-Verwaltungsdienst aus, wählen Sie Marketplace-Elemente aus, und wählen Sie dann Aus Azure hinzufügen aus:

    Hinzufügen von Marketplace-Elementen aus Azure

  4. Jede Position zeigt auch die derzeit verfügbare Version. Wenn mehrere Versionen eines Marketplace-Elements verfügbar sind, ist in der Spalte VersionMehrere angegeben. Sie können auf die einzelnen Elemente klicken, um eine Beschreibung und zusätzliche Informationen anzuzeigen, u. a. die Downloadgröße:

    Der Screenshot zeigt die verfügbaren Versionen eines Marketplace-Elements.

  5. Wenn die Version eines Elements als Mehrereangezeigt wird, können Sie dieses Element auswählen und dann eine bestimmte Version aus dem resultierenden Versionsauswahlmenü auswählen. Beachten Sie, dass Microsoft nun Attribute hinzufügen kann, die für Administratoren das Herunterladen von Marketplace-Produkten blockieren, die mit ihrer Azure Stack-Instanz inkompatibel sind (aufgrund verschiedener Eigenschaften, z. B. Azure Stack-Version oder Abrechnungsmodell). Diese Attribute können nur von Microsoft hinzugefügt werden:

    Aus Azure hinzufügen

  6. Wählen Sie das gewünschte Element aus, und klicken Sie auf Weiter. Die Downloadzeiten variieren und hängen von der Netzwerkkonnektivität ab. Wenn der Download abgeschlossen ist, können Sie das neue Marketplace-Element entweder als Azure Stack Hub-Bediener oder -Benutzer bereitstellen.

  7. Um das heruntergeladene Element bereitzustellen, wählen Sie + Ressource erstellenaus, und durchsuchen Sie dann die Kategorien nach dem neuen Marketplace-Element. Wählen Sie als Nächstes das Element aus, um den Bereitstellungsprozess zu starten. Der Prozess variiert für verschiedene Marketplace-Elemente.

Wenn Azure Stack Hub eingeschränkte oder keine Internetverbindung aufweist, können Sie PowerShell und das Marketplace-Veröffentlichungstool verwenden, um die Marketplace-Elemente auf einen Computer mit Internetverbindung herunterzuladen. Anschließend übertragen Sie die Elemente in Ihre Azure Stack Hub-Umgebung. In einer getrennten Umgebung können Sie Marketplace-Elemente nicht über das Azure Stack Hub-Portal herunterladen.

Das Tool für die Marketplace-Syndikation kann auch in einem verbundenen Szenario verwendet werden.

Dieses Szenario besteht aus zwei Teilen:

  • Teil 1: Herunterladen von Elementen aus dem Marketplace. Sie Konfigurieren auf dem Computer mit Internetzugriff PowerShell und laden das Tool für die Syndikation und anschließend Elemente aus Azure Marketplace herunter.
  • Teil 2: Hochladen und Veröffentlichen in Azure Stack Hub-Marketplace. Sie verschieben die heruntergeladenen Dateien in die Azure Stack Hub-Umgebung und veröffentlichen sie anschließend im Azure Stack Hub-Marketplace.

Voraussetzungen

  • Eine verbundene Umgebung (muss nicht Azure Stack Hub sein). Sie müssen verbunden sein, um die Liste der Produkte von Azure mit Details abrufen und alle Elemente lokal herunterladen zu können. Für die übrigen Schritte ist keine Internetkonnektivität erforderlich. Ein Katalog mit den von Ihnen zuvor heruntergeladenen Elementen wird erstellt, den Sie in Ihrer nicht verbundenen Umgebung verwenden können.
  • Wechselmedien, um eine Verbindung mit der getrennten Umgebung herzustellen und alle erforderlichen Artefakte zu übertragen.
  • Eine getrennte Azure Stack Hub-Umgebung mit den folgenden Voraussetzungen:

Laden Sie mit dem folgenden Befehl das Modul Azs.Syndication.Admin aus dem PowerShell-Katalog herunter:

Install-Module -Name Azs.Syndication.Admin

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

Nachdem Sie Ihren Azure Stack Hub registriert haben, können Sie die folgende Meldung ignorieren, die auf dem Marketplace-Verwaltungsblatt angezeigt wird, da dies für den getrennten Anwendungsfall nicht relevant ist:

Marktplatzverwaltung

Verwenden Sie das Marktplatz-Veröffentlichungstool, um Marktplatzartikel herunterzuladen.

Stellen Sie sicher, das Marketplace-Syndication-Tool jedes Mal herunterzuladen, wenn Sie Marketplace-Artikel in einem Offline-Szenario herunterladen. An diesem Tool werden häufig Änderungen vorgenommen, und es sollte immer die aktuelle Version für jeden Download verwendet werden.

Wichtig

Es wird empfohlen, Az Module anstelle von AzureRM-zu verwenden, da AzureRM- veraltet ist. Siehe folgende Beispiele:

  1. Öffnen Sie auf einem Computer mit internetverbindung eine PowerShell-Konsole als Administrator.

  2. Melden Sie sich mit dem Azure-Konto, das Sie zum Registrieren von Azure Stack Hub verwendet haben, beim entsprechenden Azure-Cloud- und Entra-ID-Verzeichnismandanten an. Führen Sie zum Hinzufügen des Kontos in PowerShellConnect-AzAccount aus:

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

    Sie werden aufgefordert, Ihre Anmeldeinformationen für das Azure-Konto einzugeben. Je nach Konfiguration Ihres Kontos müssen Sie ggf. die zweistufige Authentifizierung verwenden.

    Hinweis

    Wenn Ihre Sitzung abgelaufen ist, Ihr Kennwort geändert wurde oder Sie Konten wechseln möchten, führen Sie das folgende Cmdlet aus, bevor Sie sich mit Connect-AzAccount anmelden: Remove-AzAccount -Scope Process.

  3. Sollten Sie über mehrere Abonnements verfügen, führen Sie den folgenden Befehl aus, um das für die Registrierung verwendete Abonnement auszuwählen:

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

  4. Wenn Sie dies im erforderlichen Schritt noch nicht getan haben, laden Sie die neueste Version des Marketplace-Syndication-Tools herunter, wenn Sie die neueste Version von Azure Stack Hub verwenden:

Install-Module -Name Azs.Syndication.Admin

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

  1. Um Marketplace-Elemente wie VM-Images, Erweiterungen oder Lösungsvorlagen zum Herunterladen auszuwählen, führen Sie den folgenden Befehl aus:

    $products = Select-AzsMarketplaceItem

    Dadurch wird eine Tabelle angezeigt, in der alle Azure Stack-Registrierungen aufgelistet sind, die im ausgewählten Abonnement verfügbar sind. Wählen Sie die Registrierung aus, die der Azure Stack-Umgebung entspricht, für die Sie die Marketplace-Elemente herunterladen, und wählen Sie OK aus.

    Der Screenshot zeigt eine Liste aller Azure Stack-Registrierungen, die im ausgewählten Abonnement verfügbar sind.

    Nun sollte eine zweite Tabelle mit allen Marketplace-Elementen angezeigt werden, die für den Download verfügbar sind. Wählen Sie das Element aus, das Sie herunterladen möchten, und notieren Sie sich die Version. Sie können STRG gedrückt halten, um mehrere Images auszuwählen.

    Der Screenshot zeigt eine weitere Liste aller Azure Stack-Registrierungen, die im ausgewählten Abonnement verfügbar sind.

    Die Liste mit den Images kann mithilfe der Option Kriterien hinzufügen gefiltert werden.

    Auswählen der Azure Stack-Registrierungen

    Nachdem Sie Ihre Auswahl getroffen haben, wählen Sie OKaus.

  2. Die IDs für die Marketplace-Elemente, die Sie zum Download ausgewählt haben, werden in der variablen $products gespeichert. Verwenden Sie den folgenden Befehl, um die ausgewählten Elemente herunterzuladen. Ersetzen Sie „Destination folder path in quotes“ durch einen Speicherort, an dem die aus dem Azure-Marketplace heruntergeladenen Dateien gespeichert werden sollen:

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

  3. Die Dauer des Downloads hängt von der Größe des Elements ab. Nach Abschluss des Downloads ist das Element in dem Ordner verfügbar, den Sie im Skript angegeben haben. Der Download enthält eine VHD-Datei (für virtuelle Computer) oder eine ZIP-Datei (für VM-Erweiterungen und Ressourcenanbieter). Es kann auch ein Katalogpaket im .azpkg Format enthalten, bei dem es sich um eine .zip Datei handelt.

  4. Im Falle eines Downloadfehlers können Sie den Vorgang mithilfe des folgenden PowerShell-Cmdlets erneut ausführen:

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

  5. Sie sollten auch das Azs.Syndication.Admin Modul lokal exportieren, damit Sie es auf den Computer kopieren können, von dem Sie Marketplace-Elemente in Azure Stack Hub importieren.

    Hinweis

    Der Zielordner für den Export dieses Moduls sollte sich von dem Speicherort unterscheiden, an den Sie die Marketplace-Elemente exportiert haben.

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

Importieren Sie den Download und Veröffentlichen im Azure Stack Hub Marketplace mit PowerShell

  1. Sie müssen die Dateien verschieben, die Sie zuvor lokal auf einen Computer mit Konnektivität zu Ihrer Azure Stack Hub-Umgebung heruntergeladen haben. Das Tool für die Marketplace-Syndikation muss ebenfalls für Ihre Azure Stack Hub-Umgebung verfügbar sein, da es für den Importvorgang benötigt wird.

    Die folgende Abbildung zeigt ein Beispiel für die Ordnerstruktur. D:\downloadfolder enthält alle heruntergeladenen Marketplace-Elemente. Jeder Unterordner ist ein Marketplace-Element (z. B.microsoft.custom-script-linux-arm-2.0.3) und ist nach der Produkt-ID benannt. In den Unterordnern befindet sich jeweils der heruntergeladene Inhalt des Marketplace-Elements.

    Verzeichnisstruktur für Marketplace-Downloads

  2. Befolgen Sie die Anweisungen unter Herstellen einer Verbindung mit Azure Stack Hub über PowerShell, um die PowerShell-Sitzung für Azure Stack Hub-Operatoren zu konfigurieren.

  3. Melden Sie sich bei Ihrer Azure Stack Hub-Instanz mit einer Identität an, die über Besitzerzugriff auf das Standardabonnement des Anbieters verfügt.

  4. Kopieren Sie den Namen des Ordners (beispielsweise microsoft.dsc-arm-2.77.0), und erstellen Sie einen Ordner mit diesem Namen.

  5. Verschieben Sie den heruntergeladenen Ordner in diesen Ordner. Zu diesem Zeitpunkt verfügen Sie über C:\microsoft.dsc-arm-2.77.0\microsoft.dsc-arm-2.77.0\original-sub-folders-are-here und C:\microsoft.dsc-arm-2.77.0\microsoft.dsc-arm-2.77.0\productDetails.json.

  6. Führen Sie das folgende Cmdlet aus, um das Syndikationsmodul zu importieren und das Tool für die Marketplace-Syndikation zu starten:

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

  7. Nachdem das Cmdlet erfolgreich abgeschlossen wurde, sollten die Marketplace-Elemente im Azure Stack Hub Marketplace verfügbar sein.

Nächste Schritte

Herstellen einer Verbindung mit Azure Stack Hub über PowerShell